Mulai cepat: Pustaka klien Azure Blob Storage untuk Java

Dalam artikel ini, Anda mengikuti langkah-langkah untuk menginstal paket dan mencoba contoh kode untuk tugas dasar.

Dalam artikel ini, Anda menggunakan Azure Developer CLI untuk menyebarkan sumber daya Azure dan menjalankan aplikasi konsol lengkap hanya dengan beberapa perintah.

• Akun Azure dengan langganan aktif - buat akun secara gratis
• Akun Azure Storage - buat akun penyimpanan.
• Java Development Kit (JDK) versi 8 atau yang lebih baru
• Apache Maven

• Langganan Azure - buat akun secara gratis
• Java Development Kit (JDK) versi 8 atau yang lebih baru
• Apache Maven
• Azure Developer CLI

Bagian ini memancang Anda menyiapkan proyek untuk bekerja dengan pustaka klien Azure Blob Storage untuk Java.

Membuat proyek

Buat aplikasi Java bernama blob-quickstart.

1. Di jendela konsol (seperti PowerShell atau Bash), gunakan Maven untuk membuat aplikasi konsol baru dengan nama blob-quickstart. Ketik perintah mvn berikut untuk membuat proyek Java "Hello world!".

   • PowerShell
   • Bash

   mvn archetype:generate `
       --define interactiveMode=n `
       --define groupId=com.blobs.quickstart `
       --define artifactId=blob-quickstart `
       --define archetypeArtifactId=maven-archetype-quickstart `
       --define archetypeVersion=1.4
   

2. Output dari pembuatan proyek akan terlihat seperti ini:

   [INFO] Scanning for projects...
   [INFO]
   [INFO] ------------------< org.apache.maven:standalone-pom >-------------------
   [INFO] Building Maven Stub Project (No POM) 1
   [INFO] --------------------------------[ pom ]---------------------------------
   [INFO]
   [INFO] >>> maven-archetype-plugin:3.1.2:generate (default-cli) > generate-sources @ standalone-pom >>>
   [INFO]
   [INFO] <<< maven-archetype-plugin:3.1.2:generate (default-cli) < generate-sources @ standalone-pom <<<
   [INFO]
   [INFO]
   [INFO] --- maven-archetype-plugin:3.1.2:generate (default-cli) @ standalone-pom ---
   [INFO] Generating project in Batch mode
   [INFO] ----------------------------------------------------------------------------
   [INFO] Using following parameters for creating project from Archetype: maven-archetype-quickstart:1.4
   [INFO] ----------------------------------------------------------------------------
   [INFO] Parameter: groupId, Value: com.blobs.quickstart
   [INFO] Parameter: artifactId, Value: blob-quickstart
   [INFO] Parameter: version, Value: 1.0-SNAPSHOT
   [INFO] Parameter: package, Value: com.blobs.quickstart
   [INFO] Parameter: packageInPathFormat, Value: com/blobs/quickstart
   [INFO] Parameter: version, Value: 1.0-SNAPSHOT
   [INFO] Parameter: package, Value: com.blobs.quickstart
   [INFO] Parameter: groupId, Value: com.blobs.quickstart
   [INFO] Parameter: artifactId, Value: blob-quickstart
   [INFO] Project created from Archetype in dir: C:\QuickStarts\blob-quickstart
   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  7.056 s
   [INFO] Finished at: 2019-10-23T11:09:21-07:00
   [INFO] ------------------------------------------------------------------------
       ```
   
   

3. Beralih ke folder blob-quickstart yang baru dibuat.

   cd blob-quickstart
   

4. Di samping direktori blob-quickstart , buat direktori lain yang disebut data. Folder ini adalah tempat file data blob akan dibuat dan disimpan.

   mkdir data
   

Menginstal paket

Buka file pom.xml di editor teks Anda.

Tambahkan azure-sdk-bom untuk mengambil dependensi pada versi terbaru pustaka. Dalam cuplikan berikut, ganti {bom_version_to_target} tempat penampung dengan nomor versi. Menggunakan azure-sdk-bom membuat Anda tidak perlu menentukan versi setiap dependensi individu. Untuk mempelajari selengkapnya tentang BOM, lihat AZURE SDK BOM README.

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure</groupId>
            <artifactId>azure-sdk-bom</artifactId>
            <version>{bom_version_to_target}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Kemudian tambahkan elemen dependensi berikut ke grup dependensi. Dependensi azure-identity diperlukan untuk koneksi tanpa kata sandi ke layanan Azure.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-storage-blob</artifactId>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
</dependency>

Menyiapkan kerangka kerja aplikasi

Dari direktori proyek, ikuti langkah-langkah untuk membuat struktur dasar aplikasi:

1. Buka direktori /src/main/java/com/blobs/quickstart
2. Buka file App.java di editor Anda
3. Menghapus baris System.out.println("Hello world!");
4. Menambahkan arahan yang diperlukan import

Kode harus menyerupai kerangka kerja ini:

package com.blobs.quickstart;

/**
 * Azure Blob Storage quickstart
 */
import com.azure.identity.*;
import com.azure.storage.blob.*;
import com.azure.storage.blob.models.*;
import java.io.*;

public class App
{
    public static void main(String[] args) throws IOException
    {
        // Quickstart code goes here
    }
}

Dengan Azure Developer CLI terinstal, Anda dapat membuat akun penyimpanan dan menjalankan kode sampel hanya dengan beberapa perintah. Anda dapat menjalankan proyek di lingkungan pengembangan lokal Anda, atau di DevContainer.

Menginisialisasi templat Azure Developer CLI dan menyebarkan sumber daya

Dari direktori kosong, ikuti langkah-langkah ini untuk menginisialisasi azd templat, memprovisikan sumber daya Azure, dan mulai menggunakan kode:

• Kloning aset repositori mulai cepat dari GitHub dan inisialisasi templat secara lokal:

  azd init --template blob-storage-quickstart-java
  

  Anda akan dimintai informasi berikut:

  • Nama lingkungan: Nilai ini digunakan sebagai awalan untuk semua sumber daya Azure yang dibuat oleh Azure Developer CLI. Nama harus unik di semua langganan Azure dan panjangnya harus antara 3 dan 24 karakter. Nama hanya dapat berisi angka dan huruf kecil.

• Masuk ke Azure:

  azd auth login
  

• Provisikan dan sebarkan sumber daya ke Azure:

  azd up
  

  Anda akan dimintai informasi berikut:

  • Langganan: Langganan Azure tempat sumber daya Anda disebarkan.
  • Lokasi: Wilayah Azure tempat sumber daya Anda disebarkan.

  Penyebaran mungkin perlu waktu beberapa menit untuk diselesaikan. Output dari azd up perintah mencakup nama akun penyimpanan yang baru dibuat, yang akan Anda perlukan nanti untuk menjalankan kode.

Jalankan kode sampel

Pada titik ini, sumber daya disebarkan ke Azure dan kode hampir siap untuk dijalankan. Ikuti langkah-langkah ini untuk memperbarui nama akun penyimpanan dalam kode, dan jalankan aplikasi konsol sampel:

• Perbarui nama akun penyimpanan:
  1. Di direktori lokal, navigasikan ke direktori blob-quickstart/src/main/java/com/blobs/quickstart .
  2. Buka file bernama App.java di editor Anda. <storage-account-name> Temukan tempat penampung dan ganti dengan nama aktual akun penyimpanan yang dibuat oleh azd up perintah .
  3. Simpan perubahan.
• Jalankan proyek:
  1. Navigasikan ke direktori blob-quickstart yang berisi pom.xml file. Kompilasi proyek dengan menggunakan perintah berikut mvn :

     mvn compile
     

  2. Kemas kode yang dikompilasi dalam format yang dapat didistribusikan:

     mvn package
     

  3. Jalankan perintah berikut mvn untuk menjalankan aplikasi:

     mvn exec:java
     

• Amati output: Aplikasi ini membuat file pengujian di folder data lokal Anda dan mengunggahnya ke kontainer di akun penyimpanan. Contoh kemudian mencantumkan blob dalam kontainer dan mengunduh file dengan nama baru sehingga Anda dapat membandingkan file lama dan baru.

Untuk mempelajari selengkapnya tentang cara kerja kode sampel, lihat Contoh kode.

Setelah selesai menguji kode, lihat bagian Bersihkan sumber daya untuk menghapus sumber daya yang azd up dibuat oleh perintah .

Tambahkan kode ini ke akhir metode Main:

Tambahkan kode ini ke akhir metode Main:

Tambahkan kode ini ke akhir metode Main:

Tambahkan kode ini ke akhir metode Main:

Tambahkan kode ini ke akhir metode Main:

Menjalankan kode

Aplikasi ini membuat file uji di folder lokal Anda dan mengunggahnya ke Blob Storage. Contoh kemudian mencantumkan blob dalam kontainer dan mengunduh file dengan nama baru sehingga Anda dapat membandingkan file lama dan baru.

Ikuti langkah-langkah untuk mengkompilasi, mengemas, dan menjalankan kode

1. Navigasi ke direktori yang berisi pom.xml file dan kompilasi proyek dengan menggunakan perintah berikut mvn :

   mvn compile
   

2. Kemas kode yang dikompilasi dalam format yang dapat didistribusikan:

   mvn package
   

3. Jalankan perintah berikut mvn untuk menjalankan aplikasi:

   mvn exec:java -D exec.mainClass=com.blobs.quickstart.App -D exec.cleanupDaemonThreads=false
   

   Untuk menyederhanakan langkah eksekusi, Anda dapat menambahkan exec-maven-plugin pom.xml dan mengonfigurasi seperti yang ditunjukkan di bawah ini:

   <plugin>
     <groupId>org.codehaus.mojo</groupId>
     <artifactId>exec-maven-plugin</artifactId>
     <version>1.4.0</version>
     <configuration>
       <mainClass>com.blobs.quickstart.App</mainClass>
       <cleanupDaemonThreads>false</cleanupDaemonThreads>
     </configuration>
   </plugin>
   

   Dengan konfigurasi ini, Anda dapat menjalankan aplikasi dengan perintah berikut:

   mvn exec:java
   

Output aplikasi mirip dengan contoh berikut (nilai UUID yang dihilangkan untuk keterbacaan):

Azure Blob Storage - Java quickstart sample

Uploading to Blob storage as blob:
        https://mystorageacct.blob.core.windows.net/quickstartblobsUUID/quickstartUUID.txt

Listing blobs...
        quickstartUUID.txt

Downloading blob to
        ./data/quickstartUUIDDOWNLOAD.txt

Press the Enter key to begin clean up

Deleting blob container...
Deleting the local source and downloaded files...
Done

Sebelum memulai proses pembersihan, periksa folder data Anda untuk kedua file tersebut. Anda dapat membandingkannya dan mengamati bahwa mereka identik.

Setelah Anda memverifikasi file dan selesai menguji, tekan tombol Enter untuk menghapus file pengujian bersama dengan kontainer yang Anda buat di akun penyimpanan. Anda juga dapat menggunakan Azure CLI untuk menghapus sumber daya.

Setelah selesai dengan mulai cepat, Anda dapat membersihkan sumber daya yang Anda buat dengan menjalankan perintah berikut:

azd down

Anda akan diminta untuk mengonfirmasi penghapusan sumber daya. Masukkan y untuk mengonfirmasi.