Použití sady Azure SDK pro Javu

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é podrobnosti

  • Pomocí knihoven Azure můžete komunikovat se službami Azure z Java kódu, který spouštíte místně nebo v cloudu.
  • Knihovny podporují Javu 8 a novější verze a jsou testovány jak se základní verzí Javy 8, tak s nejnovější verzí Javy s dlouhodobou podporou.
  • 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 další nástroje.
  • Sada SDK obsahuje odlišné knihovny pro správu a klientské knihovny (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 najdete v Azure pro Java Reference uspořádané podle služby Azure nebo prohlížeče rozhraní API Java uspořádaného podle názvu balíčku.

Další podrobnosti

  • Azure SDK pro knihovny Java vycházejí z podkladového rozhraní Azure REST API, takže tato rozhraní API můžete používat prostřednictvím známých paradigmat Java. 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 GitHubu. Jako opensourcový projekt jsou příspěvky vítány!
  • Azure SDK pro Java se aktualizuje, 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 použitých pro knihovny najdete v tématu Java Azure SDK Pokyny k návrhu.

Podporované platformy pro Azure SDK pro Javu

Azure SDK pro Java se dodává s podporou pro Java 8 a novější, ale vždy používejte nejnovější Java dlouhodobé verze podpory (LTS) ve vývoji a při vydávání do produkčního prostředí. 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 dostupné 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 model odděluje definici a vytvoření instance klienta od jeho operace, takže klient je neměnný a snadněji se používá. 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. Tento požadavek znamená, že v těchto případech je například KeyVaultClient pro synchronní rozhraní API a KeyVaultAsyncClient pro 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 je pojmenován podobně jako synchronizační třída klienta, s Builder zahrnuto. Například KeyVaultClientBuilder. Tento tvůrce má metody buildClient() a buildAsyncClient() k vytvoření instancí klienta, podle potřeby.

Vzhledem k těmto konvencím jsou všechny třídy končící na Client neměnné a poskytují operace pro interakci se službou Azure. Všechny třídy, které končí ClientBuilder poskytují operace 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í KeyClientkey Vaultu:

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í Trezor klíčů 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 v adresáři projektu knihovny v úložišti SDK na GitHubu. Další fragmenty kódu najdete také v referenční dokumentaci a ukázky Azure.

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

Knihovny pro správu (nebo „vrstva správy“) vám pomáhají vytvářet, nasazovat a jinak spravovat prostředky Azure z aplikačního kódu v jazyce Java. 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í pro provádění stejných úloh, které můžete provádět prostřednictvím portálu Azure nebo Azure CLI.

Všechny knihovny pro správu Azure Java poskytují *Manager třídu jako rozhraní API služby, například ComputeManager pro výpočetní službu Azure nebo AzureResourceManager pro 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 jednotlivými knihovnami pro správu najdete v souboru README.md v adresáři projektu knihovny v úložišti SDK na GitHubu. Další fragmenty kódu najdete také v referenční dokumentaci a ukázky Azure.

Získejte pomoc a spojte se s týmem SDK

Další kroky

Teď, když rozumíte tomu, co Azure SDK pro Java je, prozkoumejte řadu konceptů, které vám pomůžou být produktivní při používání knihoven. Následující články poskytují dobré výchozí body:

  • Last updated on