Sdílet prostřednictvím

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

  • Knihovny Azure jsou prostředky, které používáte ke komunikaci se službami Azure z kódu Java, který spouštíte buď místně, nebo v cloudu.
  • Knihovny podporují Java 8 a novější a jsou testovány proti základní verzi Javy 8 i nejnovější verzi 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 žá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 najdete v referenčních Azure pro Javu uspořádaných službou Azure nebo v prohlížeči 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 GitHubu. 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 Java SDK Design Guidelines.

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 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 vzor odděluje definici a vytvoření instance klienta od jeho operace, což umožňuje, aby klient byl neměnný a snadnější k 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 existoval KeyVaultClient pro synchronizační 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 (neboli rovina správy) vám pomáhají 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í pro provádění stejných úloh, 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, 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 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: