De Azure SDK voor Java gebruiken

De opensource Azure SDK voor Java vereenvoudigt het inrichten, beheren en gebruiken van Azure-resources vanuit Java-toepassingscode.

Belangrijke details

  • Gebruik de Azure-bibliotheken om te communiceren met Azure services vanuit Java code die u lokaal of in de cloud uitvoert.
  • De bibliotheken ondersteunen Java 8 en hoger en worden getest op basis van zowel de Java 8-basislijn als de nieuwste Java langetermijnondersteuningsrelease.
  • De bibliotheken bevatten volledige ondersteuning voor Java-modules, wat betekent dat ze volledig voldoen aan de vereisten van een Java-module en alle relevante pakketten voor gebruik exporteren.
  • De Azure SDK voor Java bestaat alleen uit veel afzonderlijke Java-bibliotheken die betrekking hebben op specifieke Azure-services. De SDK bevat geen andere hulpprogramma's.
  • De SDK heeft verschillende bibliotheken voor 'beheer' en 'client' (ook wel 'beheervlak' en 'gegevensvlak' genoemd). Elke set dient verschillende doeleinden en wordt gebruikt door verschillende soorten code. Zie de volgende secties verderop in dit artikel voor meer informatie:
  • U vindt documentatie voor de bibliotheken in de Azure voor Java Reference georganiseerd door Azure service of de Java API-browser die is georganiseerd op pakketnaam.

Overige details

  • De Azure SDK voor Java bibliotheken zijn gebaseerd op de onderliggende Azure REST API, zodat u deze API's kunt gebruiken via bekende Java paradigma's. U kunt de REST API echter altijd rechtstreeks vanuit Java-code gebruiken, indien gewenst.
  • U vindt de broncode voor de Azure-bibliotheken in de GitHub-opslagplaats. Als opensource-project zijn bijdragen welkom!
  • De Azure SDK voor Java wordt bijgewerkt om algemene cloudpatronen te delen, zoals verificatieprotocollen, logboekregistratie, tracering, transportprotocollen, gebufferde antwoorden en nieuwe pogingen.
  • Zie de Java Azure SDK Ontwerprichtlijnen voor meer informatie over de richtlijnen die zijn toegepast op de bibliotheken.

Ondersteunde platforms voor Azure SDK voor Java

De Azure SDK voor Java wordt geleverd met ondersteuning voor Java 8 en hoger, maar gebruik altijd de nieuwste Java lts-release (long-term support) in ontwikkeling en bij het vrijgeven aan productie. Het gebruik van de nieuwste LTS-release zorgt voor de beschikbaarheid van de nieuwste verbeteringen in Java, waaronder oplossingen voor fouten, prestatieverbeteringen en beveiligingsoplossingen. De Azure SDK voor Java bevat ook aanvullende ondersteuning voor latere versies van Java. Deze aanvullende ondersteuning verbetert de prestaties en bevat JDK-specifieke verbeteringen buiten de ondersteunde Java 8-basislijn.

De Azure SDK voor Java wordt getest en ondersteund in Windows, Linux en macOS. Het wordt niet getest op andere platforms die door de JDK worden ondersteund en biedt geen ondersteuning voor Android-implementaties. Ontwikkelaars die software willen ontwikkelen voor implementatie op Android-apparaten en die gebruikmaken van Azure-services, zijn er Android-specifieke bibliotheken beschikbaar in het Azure SDK voor Android-project .

Verbinding maken met en gebruikmaken van Azure-resources met clientbibliotheken

Met de clientbibliotheken (of 'gegevensvlak') kunt u Java-toepassingscode schrijven om te communiceren met al ingerichte services. Clientbibliotheken bestaan alleen voor services die ondersteuning bieden voor een client-API. U kunt ze identificeren omdat hun Maven-groeps-id is com.azure.

Alle Azure Java-clientbibliotheken volgen hetzelfde API-ontwerppatroon van het aanbieden van een Java Builder-klasse die verantwoordelijk is voor het maken van een exemplaar van een client. Dit patroon scheidt de definitie en instantiëring van de client van de bewerking, zodat de client onveranderbaar en gemakkelijker te gebruiken is. Daarnaast volgen alle clientbibliotheken enkele belangrijke patronen:

  • Clientbibliotheken die zowel synchrone als asynchrone API's ondersteunen, moeten deze API's in afzonderlijke klassen aanbieden. Wat deze vereiste betekent, is dat er in deze gevallen bijvoorbeeld een KeyVaultClient voor synchronisatie-API's en een KeyVaultAsyncClient voor asynchrone API's is.

  • Er is één opbouwklasse die verantwoordelijk is voor het bouwen van zowel de synchronisatie- als asynchrone API's. De bouwer heeft dezelfde naam als de synchronisatieclient-klasse, inclusief Builder. Bijvoorbeeld: KeyVaultClientBuilder. Deze opbouwfunctie heeft buildClient() en buildAsyncClient() methoden om, indien van toepassing, cliëntexemplaren te maken.

Vanwege deze conventies zijn alle klassen die eindigen Client onveranderbaar en bieden ze bewerkingen om te communiceren met een Azure-service. Alle klassen die eindigen op ClientBuilder voorzien in bewerkingen om te configureren en een exemplaar te maken van een bepaald clienttype.

Voorbeeld van clientbibliotheken

In het volgende codevoorbeeld ziet u hoe u een synchrone Sleutelkluis KeyClientmaakt:

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

In het volgende codevoorbeeld ziet u hoe u een asynchrone sleutelkluis KeyAsyncClientmaakt:

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

Zie het README.md-bestand in de projectmap van de bibliotheek in de GitHub-opslagplaats van de SDK voor meer informatie over het werken met elke clientbibliotheek. U kunt ook meer codefragmenten vinden in de referentiedocumentatie en de Azure Samples.

Azure-resources inrichten en beheren met beheerbibliotheken

Met de beheerbibliotheken (of 'beheervlak') kunt u Azure resources maken, inrichten en anderszins beheren vanuit Java toepassingscode. U vindt deze bibliotheken in de com.azure.resourcemanager Maven-groeps-id. Alle Azure-services hebben bijbehorende beheerbibliotheken.

Met behulp van de beheerbibliotheken kunt u configuratie- en implementatiescripts schrijven om dezelfde taken uit te voeren die u kunt uitvoeren via de Azure of de Azure CLI.

Alle Azure Java-beheerbibliotheken bieden een *Manager klasse als service-API, ComputeManager bijvoorbeeld voor Azure Compute-service of AzureResourceManager voor de aggregatie van populaire services.

Voorbeeld van beheerbibliotheken

In het volgende codevoorbeeld ziet u hoe u een ComputeManager:

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

In het volgende codevoorbeeld ziet u hoe u een nieuwe virtuele machine inricht:

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

In het volgende codevoorbeeld ziet u hoe u een bestaande virtuele machine kunt ophalen:

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

In het volgende codevoorbeeld ziet u hoe u de virtuele machine bijwerkt en een nieuwe gegevensschijf toevoegt:

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

Zie het README.md-bestand in de projectmap van de bibliotheek in de SDK GitHub-opslagplaats voor meer informatie over het werken met elke beheerbibliotheek. U kunt ook meer codefragmenten vinden in de referentiedocumentatie en de Azure Samples.

Hulp krijgen en verbinding maken met het SDK-team

Volgende stappen

Nu u begrijpt wat de Azure SDK voor Java is, verkent u veel van de kruislingse concepten die u helpen productief te zijn bij het gebruik van de bibliotheken. De volgende artikelen bieden goede uitgangspunten:

  • Last updated on