Bagikan melalui

Menggunakan Azure SDK untuk Java

  • Artikel

SDK Azure sumber terbuka untuk Java menyederhanakan penyediaan, pengelolaan, dan penggunaan sumber daya Azure dari kode aplikasi Java.

Detail penting

  • Pustaka Azure adalah cara Anda berkomunikasi dengan layanan Azure dari kode Java yang Anda jalankan baik secara lokal maupun di cloud.
  • Library mendukung Java 8 dan versi yang lebih baru, serta diuji terhadap standar Java 8 dan rilis Java 'dukungan jangka panjang' yang terbaru.
  • Perpustakaan perangkat lunak ini mencakup dukungan modul Java sepenuhnya, yang berarti bahwa mereka sepenuhnya mematuhi persyaratan modul Java dan mengekspor semua paket terkait untuk digunakan.
  • Azure SDK untuk Java hanya terdiri dari banyak pustaka Java individual yang terkait dengan layanan Azure tertentu. Tidak ada alat lain dalam "SDK".
  • Ada pustaka "manajemen" dan "pelanggan" yang berbeda (kadang-kadang disebut sebagai pustaka "lapisan manajemen" dan "lapisan data"). Setiap set melayani tujuan yang berbeda dan digunakan oleh berbagai jenis kode. Untuk informasi selengkapnya, lihat bagian berikut ini nanti di artikel ini:
  • Anda dapat menemukan dokumentasi untuk pustaka di Referensi Azure for Java diatur oleh Azure Service, atau browser Java API diatur menurut nama paket.

Detail lainnya

  • Pustaka Azure SDK for Java dibangun di atas Azure REST API yang mendasarinya, memungkinkan Anda menggunakan API tersebut melalui paradigma Java yang sudah dikenal. Namun, Anda selalu dapat menggunakan REST API langsung dari kode Java, jika mau.
  • Anda dapat menemukan kode sumber untuk pustaka Azure di repositori GitHub . Sebagai proyek sumber terbuka, kontribusi dipersilakan!
  • Saat ini kami memperbarui Azure SDK untuk pustaka Java untuk berbagi pola cloud umum seperti protokol autentikasi, pengelogan, pelacakan, protokol transportasi, respons buffer, dan percobaan ulang.
    • Fungsionalitas bersama ini terkandung dalam pustaka azure-core.
  • Untuk informasi selengkapnya tentang panduan yang kami terapkan ke pustaka, lihat Panduan Desain Java Azure SDK.

Platform yang didukung untuk Azure SDK untuk Java

Azure SDK untuk Java dikirim dengan dukungan untuk Java 8 dan yang lebih baru, tetapi kami sarankan pengembang selalu menggunakan rilis dukungan jangka panjang Java (LTS) terbaru dalam pengembangan dan saat merilis ke produksi. Menggunakan rilis LTS terbaru memastikan ketersediaan peningkatan terbaru dalam Java, termasuk perbaikan bug, peningkatan performa, dan perbaikan keamanan. Selain itu, Azure SDK untuk Java menyertakan dukungan tambahan untuk rilis Java nanti. Dukungan tambahan ini meningkatkan performa dan mencakup peningkatan khusus JDK di luar garis besar Java 8 yang didukung.

Azure SDK untuk Java diuji dan didukung di Windows, Linux, dan macOS. Ini tidak diuji pada platform lain yang didukung JDK, dan tidak mendukung penyebaran Android. Untuk pengembang yang ingin mengembangkan perangkat lunak untuk penyebaran di perangkat Android dan yang memanfaatkan layanan Azure, ada pustaka khusus Android yang tersedia di Azure SDK untuk proyek Android.

Terhubung dan menggunakan sumber daya Azure dengan pustaka klien

Pustaka klien (atau "data plane") membantu Anda menulis kode aplikasi Java untuk berinteraksi dengan layanan yang sudah disediakan. Pustaka klien hanya ada untuk layanan yang mendukung API klien. Anda dapat mengidentifikasinya karena ID grup Maven mereka com.azure.

Semua pustaka klien Azure Java mengikuti pola desain API yang sama dengan menawarkan kelas penyusun Java yang bertanggung jawab untuk membuat instans klien. Pola ini memisahkan definisi dan instansiasi klien dari operasinya, memungkinkan klien untuk tidak dapat diubah dan karenanya lebih mudah digunakan. Selain itu, semua pustaka klien mengikuti beberapa pola penting:

  • Pustaka klien yang mendukung API sinkron dan asinkron harus menawarkan API ini di kelas terpisah. Artinya, dalam kasus ini akan ada, misalnya, KeyVaultClient untuk API sinkronisasi dan KeyVaultAsyncClient untuk API asinkron.

  • Ada satu kelas penyusun yang bertanggung jawab untuk membangun API sinkronisasi dan asinkron. Pembangun dinamai mirip dengan kelas klien sinkronisasi, dengan Builder termasuk dalam namanya. Misalnya, KeyVaultClientBuilder. Pembangun ini memiliki metode buildClient() dan buildAsyncClient() untuk membuat instans klien dengan tepat.

Karena konvensi ini, semua kelas yang berakhiran Client tidak dapat diubah dan menyediakan operasi untuk berinteraksi dengan layanan Azure. Semua kelas yang berakhiran ClientBuilder menyediakan operasi untuk mengonfigurasi dan membuat instans jenis klien tertentu.

Contoh Perpustakaan Klien

Contoh kode berikut menunjukkan cara membuat Key Vault sinkron KeyClient:

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

Contoh kode berikut menunjukkan cara membuat Key Vault asinkron KeyAsyncClient:

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

Untuk informasi selengkapnya tentang bekerja dengan setiap pustaka klien, lihat file README.md yang terletak di direktori proyek pustaka di repositori GitHub SDK . Anda juga dapat menemukan lebih banyak cuplikan kode dalam dokumentasi referensi dan Sampel Azure.

Memprovisikan dan mengelola sumber daya Azure dengan pustaka manajemen

Pustaka manajemen (atau "bidang manajemen") membantu Anda membuat, menyediakan, dan mengelola sumber daya Azure dari kode aplikasi Java. Anda dapat menemukan pustaka ini di ID grup com.azure.resourcemanager Maven. Semua layanan Azure memiliki pustaka manajemen yang sesuai.

Dengan pustaka manajemen, Anda dapat menulis konfigurasi dan skrip penyebaran untuk melakukan tugas yang sama yang dapat Anda lakukan melalui portal Microsoft Azure atau Azure CLI.

Semua pustaka manajemen Azure Java menyediakan kelas *Manager sebagai API layanan, misalnya, ComputeManager untuk layanan komputasi Azure, atau AzureResourceManager untuk agregasi layanan populer.

Contoh pustaka manajemen

Contoh kode berikut menunjukkan cara membuat ComputeManager:

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

Contoh kode berikut menunjukkan cara memprovisikan komputer virtual baru:

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

Contoh kode berikut menunjukkan cara mendapatkan komputer virtual yang ada:

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

Contoh kode berikut menunjukkan cara memperbarui komputer virtual dan menambahkan disk data baru:

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

Untuk informasi selengkapnya tentang bekerja dengan setiap pustaka manajemen, lihat file README.md yang terletak di direktori proyek pustaka di repositori GitHub SDK . Anda juga dapat menemukan lebih banyak cuplikan kode dalam dokumentasi referensi dan Sampel Azure.

Mendapatkan bantuan dan terhubung dengan tim SDK

Langkah berikutnya

Sekarang setelah Anda memahami apa itu Azure SDK for Java, Anda dapat mendalami banyak konsep lintas fungsi yang ada untuk membuat Anda lebih produktif saat menggunakan pustaka. Artikel berikut memberikan titik awal yang baik: