Använda Azure SDKs för Java

Azure SDKs med öppen källkod för Java förenklar etablering, hantering och användning av Azure-resurser från Java-programkod.

Viktig information

  • Använd Azure-biblioteken för att kommunicera med Azure tjänster från Java kod som du kör lokalt eller i molnet.
  • Biblioteken stöder Java 8 och senare, och de testas mot både Java 8-baslinjen och den senaste Java långsiktiga supportversionen.
  • Biblioteken innehåller fullständigt Stöd för Java-moduler, vilket innebär att de är helt kompatibla med kraven i en Java-modul och exporterar alla relevanta paket för användning.
  • Azure SDKs för Java består enbart av många enskilda Java-bibliotek som relaterar till specifika Azure-tjänster. SDK:t innehåller inte andra verktyg.
  • SDK:t har distinkta bibliotek för "hantering" och "klient" (kallas ibland för "hanteringsplan" och "dataplan"-bibliotek). Varje uppsättning har olika syften och används av olika typer av kod. Mer information finns i följande avsnitt senare i den här artikeln:
  • Du hittar dokumentationen för biblioteken i Azure för Java Referens ordnad av Azure-tjänsten eller Java API-webbläsaren ordnad efter paketnamn.

Övrig information

  • Azure SDKs för Java-bibliotek bygger på det underliggande Azure REST-API:et, så att du kan använda dessa API:er via välbekanta Java paradigm. Du kan dock alltid använda REST-API:et direkt från Java-koden, om du vill.
  • Du hittar källkoden för Azure-biblioteken på GitHub-lagringsplatsen. Som ett projekt med öppen källkod är bidrag välkomna!
  • Azure SDKs för Java uppdateras för att dela vanliga molnmönster som autentiseringsprotokoll, loggning, spårning, transportprotokoll, buffrade svar och återförsök.
    • Den här delade funktionen finns i biblioteket azure-core.
  • Mer information om de riktlinjer som tillämpas på biblioteken finns i Java Azure SDKs designriktlinjer.

Plattformar som stöds för Azure SDKs för Java

Azure SDKs för Java levereras med stöd för Java 8 och senare, men använder alltid den senaste Java långsiktiga supportversionen (LTS) under utveckling och vid lansering till produktion. Med den senaste LTS-versionen säkerställer du tillgängligheten för de senaste förbättringarna i Java, inklusive felkorrigeringar, prestandaförbättringar och säkerhetskorrigeringar. Dessutom innehåller Azure SDKs för Java ytterligare stöd för senare versioner av Java. Det här ytterligare stödet förbättrar prestandan och inkluderar JDK-specifika förbättringar utöver den Java 8-baslinje som stöds.

Azure SDKs för Java testas och stöds i Windows, Linux och macOS. Det testas inte på andra plattformar som JDK stöder och stöder inte Android-distributioner. För utvecklare som vill utveckla programvara för distribution på Android-enheter och som använder Azure-tjänster finns det Android-specifika bibliotek i projektet Azure SDKs för Android.

Ansluta till och använda Azure-resurser med klientbibliotek

Klientbiblioteken (eller "dataplanet") hjälper dig att skriva Java-programkod för att interagera med redan etablerade tjänster. Klientbibliotek finns bara för de tjänster som stöder ett klient-API. Du kan identifiera dem eftersom deras Maven-grupp-ID är com.azure.

Alla Azure Java-klientbibliotek följer samma API-designmönster för att erbjuda en Java Builder-klass som ansvarar för att skapa en instans av en klient. Det här mönstret separerar definitionen och instansieringen av klienten från dess åtgärd, så att klienten är oföränderlig och enklare att använda. Dessutom följer alla klientbibliotek några viktiga mönster:

  • Klientbibliotek som stöder både synkrona och asynkrona API:er måste erbjuda dessa API:er i separata klasser. Vad det här kravet innebär är att det i dessa fall till exempel finns en KeyVaultClient för synkroniserings-API:er och en KeyVaultAsyncClient för asynkrona API:er.

  • Det finns en enskild builder-klass som tar ansvar för att skapa både synkroniserings- och asynkrona API:er. Byggaren namnges på samma sätt som synkroniseringsklientklassen, och Builder ingår. Till exempel KeyVaultClientBuilder. Den här byggaren har buildClient() och buildAsyncClient() metoder för att skapa klientinstanser efter behov.

På grund av dessa konventioner är alla klasser som slutar i Client oföränderliga och tillhandahåller åtgärder för att interagera med en Azure-tjänst. Alla klasser som slutar i ClientBuilder tillhandahålla åtgärder för att konfigurera och skapa en instans av en viss klienttyp.

Exempel på klientbibliotek

I följande kodexempel visas hur du skapar en synkron Key Vault-KeyClient:

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

I följande kodexempel visas hur du skapar en asynkron Key Vault-KeyAsyncClient:

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

Mer information om hur du arbetar med varje klientbibliotek finns i README.md filen som finns i bibliotekets projektkatalog på SDK GitHub-lagringsplatsen. Du hittar även fler kodfragment i referensdokumentation och Azure Samples.

Etablera och hantera Azure-resurser med hanteringsbibliotek

Hanteringsbiblioteken (eller "hanteringsplanet") hjälper dig att skapa, etablera och på annat sätt hantera Azure resurser från Java programkod. Du hittar dessa bibliotek i grupp-ID:t för com.azure.resourcemanager Maven. Alla Azure-tjänster har motsvarande hanteringsbibliotek.

Med hjälp av hanteringsbiblioteken kan du skriva konfigurations- och distributionsskript för att utföra samma uppgifter som du kan via Azure-portalen eller Azure CLI.

Alla Azure Java-hanteringsbibliotek tillhandahåller en *Manager-klass som tjänst-API, till exempel ComputeManager för Azure-beräkningstjänsten eller AzureResourceManager för aggregering av populära tjänster.

Exempel på managementbibliotek

Följande kodexempel visar hur du skapar en ComputeManager:

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

Följande kodexempel visar hur du etablerar en ny virtuell dator:

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();

Följande kodexempel visar hur du hämtar en befintlig virtuell dator:

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

Följande kodexempel visar hur du uppdaterar den virtuella datorn och lägger till en ny datadisk:

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

Mer information om hur du arbetar med varje hanteringsbibliotek finns i README.md filen som finns i bibliotekets projektkatalog på SDK GitHub-lagringsplatsen. Du hittar även fler kodfragment i referensdokumentation och Azure Samples.

Få hjälp och få kontakt med SDK-teamet

Nästa steg

Nu när du förstår vad Azure SDKs för Java är kan du utforska många av de övergripande begrepp som hjälper dig att vara produktiv när du använder biblioteken. Följande artiklar innehåller bra utgångspunkter:

  • Last updated on