Použití sady Azure SDK pro Javu

  • Článek

Opensourcová sada Azure SDK pro Javu zjednodušuje zřizování, správu a používání prostředků Azure z kódu aplikace v Javě.

Důležité informace

  • Knihovny Azure komunikují se službami Azure z kódu Java, který spouštíte místně nebo v cloudu.
  • Knihovny podporují Javu 8 a novější a testují se na standardních hodnotách Javy 8 i v nejnovější verzi "dlouhodobé podpory".
  • Knihovny zahrnují plnou podporu modulů Java, což znamená, že plně vyhovují požadavkům modulu Java a exportují všechny relevantní balíčky pro použití.
  • Sada Azure SDK pro Javu se skládá výhradně z mnoha jednotlivých knihoven Java, které se vztahují ke konkrétním službám Azure. Sada SDK neobsahuje žádné další nástroje.
  • Existují odlišné knihovny pro správu a klienty (někdy označované jako "rovina správy" a "rovina dat"). Každá sada slouží různým účelům a používá se různými druhy kódu. Další informace najdete v následujících částech dále v tomto článku:
  • Dokumentaci ke knihovnám v Azure for Java Reference uspořádané službou Azure nebo prohlížeč rozhraní Java API uspořádaný podle názvu balíčku.

Další podrobnosti

  • Sada Azure SDK pro knihovny Java je založená na podkladovém rozhraní Azure REST API a umožňuje používat tato rozhraní API prostřednictvím známých paradigmat Javy. Pokud ale chcete, můžete rozhraní REST API vždy používat přímo z kódu Jazyka Java.
  • Zdrojový kód knihoven Azure najdete v úložišti GitHub. Jako opensourcový projekt jsou příspěvky vítány!
  • V současné době aktualizujeme sadu Azure SDK pro knihovny Java tak, aby sdílela běžné cloudové vzory, jako jsou ověřovací protokoly, protokolování, trasování, přenosové protokoly, odpovědi ve vyrovnávací paměti a opakování.
    • Tato sdílená funkce je obsažena v knihovně Azure-Core .
  • Další informace o pokynech, které platí pro knihovny, najdete v pokynech k návrhu sady Java SDK.

Podporované platformy pro Azure SDK pro Javu

Sada Azure SDK pro Javu se dodává s podporou Javy 8 a novější, ale doporučujeme vývojářům při vývoji a při vydávání do produkčního prostředí vždy používat nejnovější verzi dlouhodobé podpory Javy (LTS). Použití nejnovější verze LTS zajišťuje dostupnost nejnovějších vylepšení v Javě, včetně oprav chyb, vylepšení výkonu a oprav zabezpečení. Sada Azure SDK pro Javu také zahrnuje další podporu pro pozdější verze Javy. Tato další podpora zlepšuje výkon a zahrnuje vylepšení specifická pro sadu JDK nad rámec podporovaných standardních hodnot Java 8.

Sada Azure SDK pro Javu se testuje a podporuje ve Windows, Linuxu a macOS. Není testován na jiných platformách, které sada JDK podporuje, a nepodporuje nasazení Androidu. Pro vývojáře, kteří chtějí vyvíjet software pro nasazení na zařízeních s Androidem a které využívají služby Azure, jsou v projektu Azure SDK pro Android k dispozici knihovny specifické pro Android .

Připojení a používání prostředků Azure s klientskými knihovnami

Klientské knihovny (neboli "rovina dat") vám pomůžou psát kód aplikace Java pro interakci s již zřízenými službami. Klientské knihovny existují pouze pro služby, které podporují klientské rozhraní API. Můžete je identifikovat, protože jejich ID skupiny Maven je com.azure.

Všechny klientské knihovny Azure Java se řídí stejným vzorem návrhu rozhraní API, který nabízí třídu tvůrce Javy, která je zodpovědná za vytvoření instance klienta. Tento vzor odděluje definici a vytvoření instance klienta od jeho operace, což klientovi umožňuje neměnnou a jednodušší použití. Všechny klientské knihovny navíc mají několik důležitých vzorů:

  • Klientské knihovny, které podporují synchronní i asynchronní rozhraní API, musí tato rozhraní API nabízet v samostatných třídách. To znamená, že v těchto případech by například existovalo KeyVaultClient rozhraní API pro synchronizaci a KeyVaultAsyncClient asynchronní rozhraní API.

  • Existuje jedna třída tvůrce, která přebírá odpovědnost za vytváření synchronizačních i asynchronních rozhraní API. Tvůrce se jmenuje podobně jako synchronizační třída klienta, která je Builder součástí. Například KeyVaultClientBuilder. Tento tvůrce má buildClient() a buildAsyncClient() metody pro vytváření klientských instancí podle potřeby.

Vzhledem k těmto konvencím jsou všechny třídy končící Client neměnnými a poskytují operace pro interakci se službou Azure. Všechny třídy, které končí operacemi ClientBuilder pro konfiguraci a vytvoření instance konkrétního typu klienta.

Příklad klientských knihoven

Následující příklad kódu ukazuje, jak vytvořit synchronní službu Key Vault KeyClient:

KeyClient client = new KeyClientBuilder()
        .endpoint(<your Key Vault URL>)
        .credential(new DefaultAzureCredentialBuilder().build())
        .buildClient();

Následující příklad kódu ukazuje, jak vytvořit asynchronní službu Key Vault KeyAsyncClient:

KeyAsyncClient client = new KeyClientBuilder()
        .endpoint(<your Key Vault URL>)
        .credential(new DefaultAzureCredentialBuilder().build())
        .buildAsyncClient();

Další informace o práci s každou klientskou knihovnou najdete v souboru README.md umístěném v adresáři projektu knihovny v úložišti SDK Na GitHubu. Další fragmenty kódu najdete také v referenční dokumentaci a ukázkách Azure.

Zřizování a správa prostředků Azure pomocí knihoven pro správu

Knihovny pro správu (neboli rovina správy) vám pomůžou vytvářet, zřizovat a jinak spravovat prostředky Azure z kódu aplikace v Javě. Tyto knihovny najdete v com.azure.resourcemanager ID skupiny Maven. Všechny služby Azure mají odpovídající knihovny pro správu.

Pomocí knihoven pro správu můžete psát skripty konfigurace a nasazení, které provádějí stejné úlohy, které můžete provádět prostřednictvím webu Azure Portal nebo Azure CLI.

Všechny knihovny pro správu Azure Java poskytují *Manager třídu jako rozhraní API služby, ComputeManager například výpočetní službu Azure nebo AzureResourceManager agregaci oblíbených služeb.

Příklad knihoven pro správu

Následující příklad kódu ukazuje, jak vytvořit ComputeManager:

ComputeManager computeManager = ComputeManager
    .authenticate(
        new DefaultAzureCredentialBuilder().build(),
        new AzureProfile(AzureEnvironment.AZURE));

Následující příklad kódu ukazuje, jak zřídit nový virtuální počítač:

VirtualMachine virtualMachine = computeManager.virtualMachines()
    .define(<your virtual machine>)
    .withRegion(Region.US_WEST)
    .withExistingResourceGroup(<your resource group>)
    .withNewPrimaryNetwork("10.0.0.0/28")
    .withPrimaryPrivateIPAddressDynamic()
    .withoutPrimaryPublicIPAddress()
    .withPopularLinuxImage(KnownLinuxVirtualMachineImage.UBUNTU_SERVER_18_04_LTS)
    .withRootUsername(<virtual-machine username>)
    .withSsh(<virtual-machine SSH key>)
    .create();

Následující příklad kódu ukazuje, jak získat existující virtuální počítač:

VirtualMachine virtualMachine = computeManager.virtualMachines()
    .getByResourceGroup(<your resource group>, <your virtual machine>);

Následující příklad kódu ukazuje, jak aktualizovat virtuální počítač a přidat nový datový disk:

virtualMachine.update()
    .withNewDataDisk(10)
    .apply();

Další informace o práci s každou knihovnou pro správu najdete v souboru README.md umístěném v adresáři projektu knihovny v úložišti SDK GitHub. Další fragmenty kódu najdete také v referenční dokumentaci a ukázkách Azure.

Získání nápovědy a připojení k týmu sady SDK

  • Navštivte dokumentaci k sadě Azure SDK pro Javu.
  • Na Stack Overflow se můžete ptát komunity.
  • Otevřete problémy se sadou SDK v úložišti GitHub.
  • Zmínka @AzureSDK na Twitteru.

Další kroky

Teď, když rozumíte tomu, co je Sada Azure SDK pro Javu, můžete se podrobně seznámit s řadou konceptů křížových řešení, které vám umožní zvýšit produktivitu při používání knihoven. Následující články poskytují dobré výchozí body: