Snabbstart: Azure Blob Storage-klientbibliotek för Java

I den här artikeln följer du stegen för att installera paketet och prova exempelkod för grundläggande uppgifter.

I den här artikeln använder du Azure Developer CLI för att distribuera Azure-resurser och köra en slutförd konsolapp med bara några få kommandon.

• Azure-konto med en aktiv prenumeration – skapa ett konto kostnadsfritt
• Azure Storage-konto – skapa ett lagringskonto.
• Java Development Kit (JDK) version 8 eller senare
• Apache Maven

• Azure-prenumeration – skapa en kostnadsfritt
• Java Development Kit (JDK) version 8 eller senare
• Apache Maven
• Azure Developer CLI

Det här avsnittet beskriver hur du förbereder ett projekt för att arbeta med Azure Blob Storage-klientbiblioteket för Java.

Skapa projektet

Skapa ett Java-program med namnet blob-quickstart.

1. I ett konsolfönster (till exempel PowerShell eller Bash) använder du Maven för att skapa en ny konsolapp med namnet blob-quickstart. Skriv följande mvn-kommando för att skapa en "Hello world!" Java-projekt.

   • 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. Utdata från genereringen av projektet bör se ut ungefär så hä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. Växla till den nyligen skapade blob-snabbstartsmappen .

   cd blob-quickstart
   

4. På sidan blob-quickstart-katalogen skapar du en annan katalog med namnet data. I den här mappen skapas och lagras blobdatafilerna.

   mkdir data
   

Installera paketen

pom.xml Öppna filen i textredigeraren.

Lägg till azure-sdk-bom för att ta ett beroende av den senaste versionen av biblioteket. I följande kodfragment ersätter du {bom_version_to_target} platshållaren med versionsnumret. Med hjälp av azure-sdk-bom behöver du inte ange versionen av varje enskilt beroende. Mer information om bommen finns i 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>

Lägg sedan till följande beroendeelement i gruppen med beroenden. Azure-identitetsberoendet behövs för lösenordslösa anslutningar till Azure-tjänster.

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

Konfigurera appramverket

Från projektkatalogen följer du stegen för att skapa appens grundläggande struktur:

1. Navigera till katalogen /src/main/java/com/blobs/quickstart
2. App.java Öppna filen i redigeringsprogrammet
3. Ta bort raden System.out.println("Hello world!");
4. Lägg till de direktiv som krävs import

Koden bör likna det här ramverket:

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

Med Azure Developer CLI installerat kan du skapa ett lagringskonto och köra exempelkoden med bara några få kommandon. Du kan köra projektet i din lokala utvecklingsmiljö eller i en DevContainer.

Initiera CLI-mallen för Azure Developer och distribuera resurser

Från en tom katalog följer du de här stegen för att initiera mallen azd , etablera Azure-resurser och komma igång med koden:

• Klona snabbstartslagringsplatsens tillgångar från GitHub och initiera mallen lokalt:

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

  Du uppmanas att ange följande information:

  • Miljönamn: Det här värdet används som prefix för alla Azure-resurser som skapats av Azure Developer CLI. Namnet måste vara unikt för alla Azure-prenumerationer och måste vara mellan 3 och 24 tecken långt. Namnet får endast innehålla siffror och gemener.

• Logga in på Azure:

  azd auth login
  

• Etablera och distribuera resurserna till Azure:

  azd up
  

  Du uppmanas att ange följande information:

  • Prenumeration: Den Azure-prenumeration som dina resurser distribueras till.
  • Plats: Den Azure-region där dina resurser distribueras.

  Distributionen kan ta några minuter att slutföra. Utdata från azd up kommandot innehåller namnet på det nyligen skapade lagringskontot, som du behöver senare för att köra koden.

Kör exempelkoden

Nu distribueras resurserna till Azure och koden är nästan redo att köras. Följ dessa steg för att uppdatera namnet på lagringskontot i koden och kör exempelkonsolappen:

• Uppdatera lagringskontots namn:
  1. I den lokala katalogen går du till katalogen blob-quickstart/src/main/java/com/blobs/quickstart .
  2. Öppna filen med namnet App.java i redigeringsprogrammet. Leta upp <storage-account-name> platshållaren och ersätt den med det faktiska namnet på lagringskontot som skapades av azd up kommandot.
  3. Spara ändringarna.
• Kör projektet:
  1. Gå till katalogen blob-quickstart som innehåller pom.xml filen. Kompilera projektet med hjälp av följande mvn kommando:

     mvn compile
     

  2. Paketera den kompilerade koden i dess distributionsbara format:

     mvn package
     

  3. Kör följande mvn kommando för att köra appen:

     mvn exec:java
     

• Observera utdata: Den här appen skapar en testfil i din lokala datamapp och laddar upp den till en container i lagringskontot. I exemplet visas sedan blobarna i containern och filen laddas ned med ett nytt namn så att du kan jämföra de gamla och nya filerna.

Mer information om hur exempelkoden fungerar finns i Kodexempel.

När du är klar med att testa koden kan du läsa avsnittet Rensa resurser för att ta bort de resurser som skapades av azd up kommandot.

Lägg till den här koden i slutet av Main metoden:

Lägg till den här koden i slutet av Main metoden:

Lägg till den här koden i slutet av Main metoden:

Lägg till den här koden i slutet av Main metoden:

Lägg till den här koden i slutet av Main metoden:

Kör koden

Den här appen skapar en testfil i din lokala mapp och laddar upp den till Blob Storage. I exemplet visas sedan blobarna i containern och filen laddas ned med ett nytt namn så att du kan jämföra de gamla och nya filerna.

Följ stegen för att kompilera, paketera och köra koden

1. Navigera till katalogen som innehåller pom.xml filen och kompilera projektet med hjälp av följande mvn kommando:

   mvn compile
   

2. Paketera den kompilerade koden i dess distributionsbara format:

   mvn package
   

3. Kör följande mvn kommando för att köra appen:

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

   För att förenkla körningssteget kan du lägga till exec-maven-pluginpom.xml och konfigurera enligt nedan:

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

   Med den här konfigurationen kan du köra appen med följande kommando:

   mvn exec:java
   

Utdata från appen liknar följande exempel (UUID-värden utelämnas för läsbarhet):

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

Innan du påbörjar rensningsprocessen kontrollerar du datamappen för de två filerna. Du kan jämföra dem och observera att de är identiska.

När du har verifierat filerna och testat klart trycker du på Retur för att ta bort testfilerna tillsammans med containern som du skapade i lagringskontot. Du kan också använda Azure CLI för att ta bort resurser.

När du är klar med snabbstarten kan du rensa de resurser som du skapade genom att köra följande kommando:

azd down

Du uppmanas att bekräfta borttagningen av resurserna. Ange y för att bekräfta.