Hızlı Başlangıç: Java için Azure Blob Depolama istemci kitaplığı

Bu makalede, paketi yüklemek için adımları izleyin ve temel görevler için örnek kodu deneyin.

Bu makalede, Azure kaynaklarını dağıtmak ve yalnızca birkaç komutla tamamlanmış bir konsol uygulaması çalıştırmak için Azure Geliştirici CLI'sini kullanacaksınız.

• Etkin aboneliği olan Azure hesabı - ücretsiz bir hesap oluşturun
• Azure Depolama hesabı - depolama hesabı oluşturun.
• Java Development Kit (JDK) sürüm 8 veya üzeri
• Apache Maven

• Azure aboneliği - ücretsiz bir abonelik oluşturun
• Java Development Kit (JDK) sürüm 8 veya üzeri
• Apache Maven
• Azure Geliştirici CLI'sı

Bu bölümde, Java için Azure Blob Depolama istemci kitaplığıyla çalışmak üzere bir proje hazırlama işleminde size yol gösterilir.

Proje oluşturma

blob-quickstart adlı bir Java uygulaması oluşturun.

1. Bir konsol penceresinde (PowerShell veya Bash gibi), maven kullanarak blob-quickstart adlı yeni bir konsol uygulaması oluşturun. "Merhaba dünya!" oluşturmak için aşağıdaki mvn komutunu yazın Java projesi.

   • 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. Projeyi oluşturma çıktısı aşağıdakine benzer olmalıdır:

   [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. Yeni oluşturulan blob-quickstart klasörüne geçin.

   cd blob-quickstart
   

4. Blob-quickstart dizininde data adlı başka bir dizin oluşturun. Bu klasör, blob veri dosyalarının oluşturulacağı ve depolanacağı klasördür.

   mkdir data
   

Paketleri yükleme

pom.xml Dosyayı metin düzenleyicinizde açın.

Kitaplığın en son sürümüne bağımlılığı almak için azure-sdk-bom ekleyin. Aşağıdaki kod parçacığında yer tutucuyu {bom_version_to_target} sürüm numarasıyla değiştirin. azure-sdk-bom kullanmak, her bir bağımlılığın sürümünü belirtmenize gerek kalmamanızı sağlar. Ürün reçetesi hakkında daha fazla bilgi edinmek için bkz . Azure SDK ÜRÜN REÇETESI BENİOKU.

<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>

Ardından aşağıdaki bağımlılık öğelerini bağımlılık grubuna ekleyin. Azure hizmetlerine parolasız bağlantılar için azure-identity bağımlılığı gereklidir.

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

Uygulama çerçevesini ayarlama

Proje dizininden uygulamanın temel yapısını oluşturmak için aşağıdaki adımları izleyin:

1. /src/main/java/com/blobs/quickstart dizinine gidin
2. App.java Dosyayı düzenleyicinizde açma
3. Satırı silme System.out.println("Hello world!");
4. Gerekli import yönergeleri ekleme

Kod şu çerçeveye benzemelidir:

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
    }
}

Azure Geliştirici CLI'sı yüklendikten sonra bir depolama hesabı oluşturabilir ve örnek kodu yalnızca birkaç komutla çalıştırabilirsiniz. Projeyi yerel geliştirme ortamınızda veya DevContainer'da çalıştırabilirsiniz.

Azure Geliştirici CLI şablonunu başlatma ve kaynakları dağıtma

Boş bir dizinden şablonu başlatmak azd , Azure kaynaklarını sağlamak ve kodu kullanmaya başlamak için şu adımları izleyin:

• GitHub'dan hızlı başlangıç deposu varlıklarını kopyalayın ve şablonu yerel olarak başlatın:

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

  Aşağıdaki bilgiler istenir:

  • Ortam adı: Bu değer, Azure Geliştirici CLI tarafından oluşturulan tüm Azure kaynakları için ön ek olarak kullanılır. Adın tüm Azure aboneliklerinde benzersiz olması ve 3 ile 24 karakter uzunluğunda olması gerekir. Ad yalnızca sayılar ve küçük harfler içerebilir.

• Azure'da oturum açın:

  azd auth login
  

• Kaynakları sağlayın ve Azure'a dağıtın:

  azd up
  

  Aşağıdaki bilgiler istenir:

  • Abonelik: Kaynaklarınızın dağıtılacağı Azure aboneliği.
  • Konum: Kaynaklarınızın dağıtıldığı Azure bölgesi.

  Dağıtımın tamamlanması birkaç dakika sürebilir. Komutun çıktısı azd up , yeni oluşturulan depolama hesabının adını içerir ve bu adı daha sonra kodu çalıştırmak için kullanmanız gerekir.

Örnek kodu çalıştırma

Bu noktada kaynaklar Azure'a dağıtılır ve kod neredeyse çalışmaya hazırdır. Koddaki depolama hesabının adını güncelleştirmek ve örnek konsol uygulamasını çalıştırmak için şu adımları izleyin:

• Depolama hesabı adını güncelleştirin:
  1. Yerel dizinde blob-quickstart/src/main/java/com/blobs/quickstart dizinine gidin.
  2. düzenleyicinizde App.java adlı dosyayı açın. Yer tutucuyu <storage-account-name> bulun ve komutu tarafından azd up oluşturulan depolama hesabının gerçek adıyla değiştirin.
  3. Değişiklikleri kaydedin.
• Projeyi çalıştırın:
  1. Dosyayı içeren blob-quickstart dizinine pom.xml gidin. Aşağıdaki mvn komutu kullanarak projeyi derleyin:

     mvn compile
     

  2. Derlenen kodu dağıtılabilir biçiminde paketleyin:

     mvn package
     

  3. Uygulamayı yürütmek için aşağıdaki mvn komutu çalıştırın:

     mvn exec:java
     

• Çıkışı gözlemleyin: Bu uygulama yerel veri klasörünüzde bir test dosyası oluşturur ve depolama hesabındaki bir kapsayıcıya yükler. Örnek daha sonra kapsayıcıdaki blobları listeler ve eski ve yeni dosyaları karşılaştırabilmeniz için dosyayı yeni bir adla indirir.

Örnek kodun nasıl çalıştığı hakkında daha fazla bilgi edinmek için bkz . Kod örnekleri.

Kodu test etme işlemini tamamladığınızda, komutu tarafından azd up oluşturulan kaynakları silmek için Kaynakları temizleme bölümüne bakın.

Bu kodu yönteminin Main sonuna ekleyin:

Bu kodu yönteminin Main sonuna ekleyin:

Bu kodu yönteminin Main sonuna ekleyin:

Bu kodu yönteminin Main sonuna ekleyin:

Bu kodu yönteminin Main sonuna ekleyin:

Kodu çalıştırma

Bu uygulama yerel klasörünüzde bir test dosyası oluşturur ve blob depolamaya yükler. Örnek daha sonra kapsayıcıdaki blobları listeler ve eski ve yeni dosyaları karşılaştırabilmeniz için dosyayı yeni bir adla indirir.

Kodu derlemek, paketlemek ve çalıştırmak için adımları izleyin

1. Dosyasını içeren pom.xml dizine gidin ve aşağıdaki mvn komutu kullanarak projeyi derleyin:

   mvn compile
   

2. Derlenen kodu dağıtılabilir biçiminde paketleyin:

   mvn package
   

3. Uygulamayı yürütmek için aşağıdaki mvn komutu çalıştırın:

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

   Çalıştırma adımını basitleştirmek için, aşağıda gösterildiği gibi öğesine pom.xml ekleyebilir exec-maven-plugin ve yapılandırabilirsiniz:

   <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>
   

   Bu yapılandırmayla, uygulamayı aşağıdaki komutla yürütebilirsiniz:

   mvn exec:java
   

Uygulamanın çıkışı aşağıdaki örneğe benzer (okunabilirlik için atlanmış UUID değerleri):

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

Temizleme işlemine başlamadan önce iki dosya için veri klasörünüzü denetleyin. Bunları karşılaştırabilir ve aynı olduklarını gözlemleyebilirsiniz.

Dosyaları doğruladıktan ve testi tamamladıktan sonra, depolama hesabında oluşturduğunuz kapsayıcıyla birlikte test dosyalarını silmek için Enter tuşuna basın. Kaynakları silmek için Azure CLI'yi de kullanabilirsiniz.

Hızlı başlangıcı tamamladığınızda, aşağıdaki komutu çalıştırarak oluşturduğunuz kaynakları temizleyebilirsiniz:

azd down

Kaynakların silinmesini onaylamanız istenir. Onaylamak için girin y .