Verwenden des Azure SDK für Java

Das Open-Source Azure SDK für Java vereinfacht die Bereitstellung, Verwaltung und Verwendung von Azure-Ressourcen aus Java-Anwendungscode.

Wichtige Details

  • Verwenden Sie die Azure-Bibliotheken, um mit Azure Diensten aus Java Code zu kommunizieren, den Sie lokal oder in der Cloud ausführen.
  • Die Bibliotheken unterstützen Java 8 und spätere Versionen und werden sowohl mit der Java-8-Baseline als auch mit der neuesten Java-LTS-Version getestet.
  • Die Bibliotheken enthalten vollständige Java-Modulunterstützung, was bedeutet, dass sie vollständig den Anforderungen eines Java-Moduls entsprechen und alle relevanten Pakete zur Verwendung exportieren.
  • Das Azure SDK für Java besteht ausschließlich aus vielen einzelnen Java-Bibliotheken, die sich auf bestimmte Azure-Dienste beziehen. Das SDK enthält keine anderen Tools.
  • Das SDK verfügt über unterschiedliche Verwaltungs- und Clientbibliotheken (manchmal auch als "Verwaltungsebene" und "Datenebene"-Bibliotheken bezeichnet). Jede Gruppe dient unterschiedlichen Zwecken und wird von einer anderen Art von Code genutzt. Weitere Informationen finden Sie weiter unten in diesem Artikel in den folgenden Abschnitten:
  • Sie finden die Dokumentation für die Bibliotheken in der Azure for Java Reference, die nach Azure-Diensten organisiert ist, oder im Java API-Browser, der nach Paketnamen organisiert ist.

Weitere Details

  • Die Azure SDK für Java-Bibliotheken basieren auf der zugrunde liegenden Azure REST-API, sodass Sie diese APIs über vertraute Java Paradigmen verwenden können. Sie können die REST-API jedoch immer direkt aus Java-Code verwenden, wenn Sie dies bevorzugen.
  • Sie finden den Quellcode für die Azure-Bibliotheken im GitHub-Repository. Als Open-Source-Projekt sind Beiträge willkommen!
  • Die Azure SDK für Java wird aktualisiert, um gemeinsame Cloudmuster wie Authentifizierungsprotokolle, Protokollierung, Ablaufverfolgung, Transportprotokolle, gepufferte Antworten und Wiederholungen zu teilen.
    • Diese gemeinsam genutzte Funktionalität ist in der Azure-Core--Bibliothek enthalten.
  • Weitere Informationen zu den Richtlinien, die auf die Bibliotheken angewendet werden, finden Sie in den Java Azure SDK Entwurfsrichtlinien.

Unterstützte Plattformen für Azure SDK für Java

Das Azure SDK für Java unterstützt Java 8 und höher. Verwenden Sie für die Entwicklung und für Bereitstellungen in der Produktion jedoch immer die neueste Java-Version mit langfristigem Support (LTS). Durch die Verwendung der neuesten LTS-Version wird sichergestellt, dass die neuesten Verbesserungen in Java verfügbar sind, einschließlich Fehlerbehebungen, Leistungsverbesserungen und Sicherheitsupdates. Darüber hinaus enthält das Azure SDK für Java zusätzliche Unterstützung für spätere Versionen von Java. Diese zusätzliche Unterstützung verbessert die Leistung und umfasst JDK-spezifische Verbesserungen über die unterstützte Java 8-Basislinie hinaus.

Das Azure SDK für Java wird unter Windows, Linux und macOS getestet und unterstützt. Es wird nicht auf anderen Plattformen getestet, die das JDK unterstützt, und unterstützt keine Android-Bereitstellungen. Für Entwickler, die Software für die Bereitstellung auf Android-Geräten entwickeln möchten und die Azure-Dienste nutzen, stehen androidspezifische Bibliotheken im Azure SDK für Android Projekt zur Verfügung.

Verbinden mit und Verwenden von Azure-Ressourcen mit Clientbibliotheken

Mithilfe der Clientbibliotheken (oder "Datenebene") können Sie Java-Anwendungscode schreiben, um mit bereits bereitgestellten Diensten zu interagieren. Clientbibliotheken sind nur für dienste vorhanden, die eine Client-API unterstützen. Sie können sie identifizieren, da ihre Maven-Gruppen-ID com.azureist.

Alle Azure Java-Clientbibliotheken folgen dem gleichen API-Entwurfsmuster, das eine Java-Generator-Klasse anbietet, die für die Erstellung einer Instanz eines Clients verantwortlich ist. Dieses Muster trennt die Definition und Instanziierung des Clients von seinem Vorgang, sodass der Client unveränderlich und einfacher zu verwenden ist. Darüber hinaus folgen alle Clientbibliotheken einigen wichtigen Mustern:

  • Clientbibliotheken, die synchrone und asynchrone APIs unterstützen, müssen diese APIs in separaten Klassen anbieten. Diese Anforderung bedeutet, dass in diesen Fällen beispielsweise eine KeyVaultClient Synchronisierungs-APIs und eine KeyVaultAsyncClient für asynchrone APIs vorhanden sind.

  • Es gibt eine einzelne Generatorklasse, die für das Erstellen der Synchronisierungs- und asynchronen APIs verantwortlich ist. Der Generator wird ähnlich wie die synchrone Clientklasse benannt, wobei Builder enthalten ist. Beispiel: KeyVaultClientBuilder. Dieser Builder verfügt über die Methoden buildClient() und buildAsyncClient(), um je nach Erfordernis Clientinstanzen zu erstellen.

Aufgrund dieser Konventionen sind alle Klassen, die auf Client enden, unveränderlich und bieten Vorgänge für die Interaktion mit einem Azure-Dienst. Alle Klassen, die in ClientBuilder enden, stellen Vorgänge bereit, um eine Instanz eines bestimmten Clienttyps zu konfigurieren und zu erstellen.

Clientbibliotheksbeispiel

Das folgende Codebeispiel zeigt, wie Sie einen synchronen Key Vault KeyClienterstellen:

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

Das folgende Codebeispiel zeigt, wie ein asynchroner Schlüsseltresor KeyAsyncClient erstellt wird:

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

Weitere Informationen zum Arbeiten mit den einzelnen Clientbibliotheken finden Sie in der Datei README.md, die sich im Projektverzeichnis der Bibliothek im GitHub-Repository des SDK befindet. Weitere Codeausschnitte finden Sie auch in der Referenzdokumentation und den Azure-Beispielen.

Bereitstellen und Verwalten von Azure-Ressourcen mit Verwaltungsbibliotheken

Mithilfe der Verwaltungsbibliotheken (oder "Verwaltungsebene") können Sie Azure Ressourcen aus Java Anwendungscode erstellen, bereitstellen und anderweitig verwalten. Sie finden diese Bibliotheken in der com.azure.resourcemanager Maven-Gruppen-ID. Alle Azure-Dienste verfügen über entsprechende Verwaltungsbibliotheken.

Mithilfe der Verwaltungsbibliotheken können Sie Konfigurations- und Bereitstellungsskripts schreiben, um dieselben Aufgaben auszuführen, die Sie über das portal Azure oder die Azure CLI ausführen können.

Alle Azure Java-Verwaltungsbibliotheken stellen eine *Manager Klasse als Dienst-API bereit, z. B. ComputeManager für Azure-Computedienst oder AzureResourceManager für die Aggregation beliebter Dienste.

Beispiel für Verwaltungsbibliotheken

Das folgende Codebeispiel zeigt, wie Sie einen ComputeManager erstellen:

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

Das folgende Codebeispiel zeigt, wie ein neuer virtueller Computer bereitgestellt wird:

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

Das folgende Codebeispiel zeigt, wie Sie einen vorhandenen virtuellen Computer abrufen:

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

Das folgende Codebeispiel zeigt, wie Sie den virtuellen Computer aktualisieren und einen neuen Datenträger hinzufügen:

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

Weitere Informationen zum Arbeiten mit den einzelnen Verwaltungsbibliotheken finden Sie in der Datei README.md, die sich im Projektverzeichnis der Bibliothek im GitHub-Repository des SDK befindet. Weitere Codeausschnitte finden Sie auch in der Referenzdokumentation und den Azure-Beispielen.

Hilfe erhalten und Kontakt mit dem SDK-Team aufnehmen

Nächste Schritte

Nachdem Sie nun verstehen, was die Azure SDK für Java ist, erkunden Sie viele der übergreifenden Konzepte, die Ihnen helfen, produktiv zu sein, wenn Sie die Bibliotheken verwenden. Die folgenden Artikel enthalten gute Ausgangspunkte:

  • Last updated on