Menggunakan Azure SDK untuk Java

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

Detail penting

  • Gunakan pustaka Azure untuk berkomunikasi dengan layanan Azure dari kode Java yang Anda jalankan secara lokal atau di cloud.
  • Pustaka ini mendukung Java 8 serta versi yang lebih baru, dan telah diuji pada versi dasar Java 8 serta rilis Java dukungan jangka panjang (LTS) 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. SDK tidak menyertakan alat lain.
  • SDK memiliki pustaka "manajemen" dan "klien" yang berbeda (kadang-kadang disebut sebagai pustaka "bidang manajemen" dan "data plane"). 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 Azure untuk Referensi Java yang diatur oleh layanan Azure, atau browser API Java diatur menurut nama paket.

Detail lainnya

  • Azure SDK untuk pustaka Java dibangun di atas AZURE REST API yang mendasarinya, sehingga Anda dapat 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!
  • Azure SDK untuk Java sedang diperbarui 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 diterapkan pada pustaka, lihat Panduan Desain Java Azure SDK.

Platform yang didukung untuk Azure SDK untuk Java

Azure SDK untuk Java mendukung Java 8 dan versi yang lebih baru, tetapi selalu gunakan rilis Java dukungan jangka panjang (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, sehingga klien tidak dapat diubah dan 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. Apa artinya persyaratan ini adalah bahwa dalam kasus ini, misalnya, ada 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.

Menyediakan dan mengelola sumber daya Azure dengan perpustakaan 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 menggunakan pustaka manajemen, Anda dapat menulis konfigurasi dan skrip penyebaran untuk melakukan tugas yang sama yang dapat Anda lakukan melalui portal 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 untuk Java, jelajahi berbagai konsep umum yang membantu Anda bekerja lebih produktif saat menggunakan pustaka. Artikel berikut memberikan titik awal yang baik:

  • Last updated on