Quickstart: Azure Blob Storage-clientbibliotheek voor Java

In dit artikel voert u de stappen uit om het pakket te installeren en voorbeeldcode voor basistaken uit te proberen.

In dit artikel gebruikt u de Azure Developer CLI om Azure-resources te implementeren en een voltooide console-app uit te voeren met slechts een paar opdrachten.

• Azure-account met een actief abonnement - gratis een account maken
• Azure Storage-account: maak een opslagaccount.
• Java Development Kit (JDK)-versie 8 of hoger
• Apache Maven

• Azure-abonnement: u kunt een gratis abonnement nemen
• Java Development Kit (JDK)-versie 8 of hoger
• Apache Maven
• Azure Developer CLI

In deze sectie wordt uitgelegd hoe u een project voorbereidt voor gebruik met de Azure Blob Storage-clientbibliotheek voor Java.

Het project maken

Maak een Java-toepassing met de naam blob-quickstart.

1. Gebruik Maven in een consolevenster (zoals PowerShell of Bash) om een nieuwe console-app te maken met de naam blob-quickstart. Typ de volgende mvn-opdracht om een 'Hallo wereld!' te maken Java-project.

   • 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. De uitvoer van het project zou er ongeveer als volgt moeten uitzien:

   [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. Schakel over naar de zojuist gemaakte blob-quickstart-map .

   cd blob-quickstart
   

4. Maak naast de blob-quickstart-map een andere map met de naam gegevens. In deze map worden de blobgegevensbestanden gemaakt en opgeslagen.

   mkdir data
   

De pakketten installeren

Open het pom.xml bestand in de teksteditor.

Voeg azure-sdk-bom toe om een afhankelijkheid te maken van de nieuwste versie van de bibliotheek. Vervang in het volgende codefragment de {bom_version_to_target} tijdelijke aanduiding door het versienummer. Als u azure-sdk-bom gebruikt, hoeft u niet de versie van elke afzonderlijke afhankelijkheid op te geven. Zie de Azure SDK BOM README voor meer informatie over de BOM.

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

Voeg vervolgens de volgende afhankelijkheidselementen toe aan de groep afhankelijkheden. De azure-identity-afhankelijkheid is nodig voor verbindingen zonder wachtwoord met Azure-services.

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

Stel het app-framework in

Volg de stappen in de projectmap om de basisstructuur van de app te maken:

1. Ga naar de map /src/main/java/com/blobs/quickstart
2. Open het bestand App.java in de editor
3. De regel verwijderen System.out.println("Hello world!");
4. De benodigde import instructies toevoegen

De code moet er als volgt uitzien:

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

Als Azure Developer CLI is geïnstalleerd, kunt u een opslagaccount maken en de voorbeeldcode uitvoeren met slechts een paar opdrachten. U kunt het project uitvoeren in uw lokale ontwikkelomgeving of in een DevContainer.

De Azure Developer CLI-sjabloon initialiseren en resources implementeren

Voer vanuit een lege map de volgende stappen uit om de azd sjabloon te initialiseren, Azure-resources in te richten en aan de slag te gaan met de code:

• Kloon de assets van de quickstart-opslagplaats vanuit GitHub en initialiseer de sjabloon lokaal:

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

  U wordt gevraagd om de volgende informatie:

  • Omgevingsnaam: deze waarde wordt gebruikt als voorvoegsel voor alle Azure-resources die zijn gemaakt door Azure Developer CLI. De naam moet uniek zijn voor alle Azure-abonnementen en moet tussen de 3 en 24 tekens lang zijn. De naam mag alleen cijfers en kleine letters bevatten.

• Meld u aan bij Azure:

  azd auth login
  

• De resources inrichten en implementeren in Azure:

  azd up
  

  U wordt gevraagd om de volgende informatie:

  • Abonnement: het Azure-abonnement waarop uw resources zijn geïmplementeerd.
  • Locatie: De Azure-regio waar uw resources worden geïmplementeerd.

  De implementatie kan enkele minuten duren. De uitvoer van de azd up opdracht bevat de naam van het zojuist gemaakte opslagaccount, dat u later nodig hebt om de code uit te voeren.

De voorbeeldcode uitvoeren

Op dit moment worden de resources geïmplementeerd in Azure en is de code bijna klaar om te worden uitgevoerd. Volg deze stappen om de naam van het opslagaccount in de code bij te werken en voer de voorbeeldconsole-app uit:

• Werk de naam van het opslagaccount bij:
  1. Navigeer in de lokale map naar de map blob-quickstart/src/main/java/com/blobs/quickstart .
  2. Open het bestand met de naam App.java in de editor. Zoek de <storage-account-name> tijdelijke aanduiding en vervang deze door de werkelijke naam van het opslagaccount dat door de azd up opdracht is gemaakt.
  3. De wijzigingen opslaan.
• Voer het project uit:
  1. Navigeer naar de map blob-quickstart met het pom.xml bestand. Compileer het project met behulp van de volgende mvn opdracht:

     mvn compile
     

  2. Verpakt de gecompileerde code in de distribueerbare indeling:

     mvn package
     

  3. Voer de volgende mvn opdracht uit om de app uit te voeren:

     mvn exec:java
     

• Bekijk de uitvoer: met deze app wordt een testbestand gemaakt in uw lokale gegevensmap en geüpload naar een container in het opslagaccount. Vervolgens wordt een lijst gemaakt van de blobs in de container en wordt het bestand gedownload met een nieuwe naam, zodat u het oude en nieuwe bestand kunt vergelijken.

Zie Codevoorbeelden voor meer informatie over hoe de voorbeeldcode werkt.

Wanneer u klaar bent met het testen van de code, raadpleegt u de sectie Resources opschonen om de resources te verwijderen die met de azd up opdracht zijn gemaakt.

Voeg deze code toe aan het einde van de Main-methode:

Voeg deze code toe aan het einde van de Main-methode:

Voeg deze code toe aan het einde van de Main-methode:

Voeg deze code toe aan het einde van de Main-methode:

Voeg deze code toe aan het einde van de Main-methode:

De code uitvoeren

Met deze app wordt een testbestand gemaakt in uw lokale map en geüpload naar de Blob-opslag. Vervolgens wordt een lijst gemaakt van de blobs in de container en wordt het bestand gedownload met een nieuwe naam, zodat u het oude en nieuwe bestand kunt vergelijken.

Volg de stappen voor het compileren, verpakken en uitvoeren van de code

1. Navigeer naar de map met het pom.xml bestand en compileer het project met behulp van de volgende mvn opdracht:

   mvn compile
   

2. Verpakt de gecompileerde code in de distribueerbare indeling:

   mvn package
   

3. Voer de volgende mvn opdracht uit om de app uit te voeren:

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

   Om de uitvoeringsstap te vereenvoudigen, kunt u deze toevoegen exec-maven-plugin aan pom.xml en configureren, zoals hieronder wordt weergegeven:

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

   Met deze configuratie kunt u de app uitvoeren met de volgende opdracht:

   mvn exec:java
   

De uitvoer van de app is vergelijkbaar met het volgende voorbeeld (UUID-waarden weggelaten voor leesbaarheid):

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

Voordat u begint met het opschonen, controleert u de gegevensmap voor de twee bestanden. U kunt ze vergelijken en zien dat ze identiek zijn.

Nadat u de bestanden hebt gecontroleerd en klaar bent met testen, drukt u op Enter om de testbestanden te verwijderen, samen met de container die u in het opslagaccount hebt gemaakt. U kunt ook Azure CLI gebruiken om resources te verwijderen.

Wanneer u klaar bent met de quickstart, kunt u de resources die u hebt gemaakt opschonen door de volgende opdracht uit te voeren:

azd down

U wordt gevraagd om het verwijderen van de resources te bevestigen. Voer y dit in om te bevestigen.