Guida introduttiva: Libreria client di Archiviazione BLOB di Azure per Java

In questo articolo, vengono illustrati i passaggi per installare il pacchetto e provare il codice di esempio per le attività di base.

In questo articolo si usa Azure Developer CLI per distribuire le risorse di Azure ed eseguire un'app console completata con pochi comandi.

• Account Azure con una sottoscrizione attiva: creare un account gratuito
• Account di archiviazione di Azure: creare un account di archiviazione.
• Java Development Kit (JDK) versione 8 o successiva
• Apache Maven

• Sottoscrizione di Azure: creare un account gratuito
• Java Development Kit (JDK) versione 8 o successiva
• Apache Maven
• Azure Developer CLI

Questa sezione illustra come preparare un progetto da usare con la libreria client di Archiviazione BLOB di Azure per Java.

Creare il progetto

Creare un'applicazione Java denominata blob-quickstart.

1. Nella finestra di una console (ad esempio PowerShell o Bash) usare Maven per creare una nuova app console con il nome blob-quickstart. Digitare il comando mvn seguente per creare un progetto 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. L'output della generazione del progetto avrà un aspetto simile al seguente:

   [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. Passare alla cartella blob-quickstart appena creata.

   cd blob-quickstart
   

4. Nella directory blob-quickstart creare un'altra directory denominata data. In questa cartella verranno creati e archiviati i file di dati BLOB.

   mkdir data
   

Installare i pacchetti

Aprire il file pom.xml nell'editor di testo.

Aggiungere azure-sdk-bom per inserire una dipendenza dall'ultima versione della libreria. Nel frammento di codice seguente sostituire il segnaposto {bom_version_to_target} con il numero di versione. L'uso di azure-sdk-bom permette di non specificare la versione di ogni singola dipendenza. Per altre informazioni sul file BOM, vedere il file LEGGIMI di BOM di Azure SDK.

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

Poi, aggiungere gli elementi di dipendenza seguenti al gruppo di dipendenze. La dipendenza azure-identity è necessaria per le connessioni senza password ai servizi di Azure.

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

Configurare il framework dell'app

Nella directory del progetto, seguire la procedura per creare la struttura di base dell'app:

1. Passare alla directory /src/main/java/com/blobs/quickstart
2. Aprire il file App.java nell'editor
3. Eliminare la riga System.out.println("Hello world!");
4. Aggiungere le direttive necessarie import

Il codice dovrebbe essere simile a questo framework:

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

Con Azure Developer CLI installata, è possibile creare un account di archiviazione ed eseguire il codice di esempio con pochi comandi. È possibile eseguire il progetto nell'ambiente di sviluppo locale o in un DevContainer.

Inizializzare il modello Azure Developer CLI e distribuire le risorse

Da una directory vuota seguire questa procedura per inizializzare il modello azd, effettuare il provisioning delle risorse di Azure e iniziare a usare il codice:

• Clonare gli asset del repository di avvio rapido da GitHub e inizializzare il modello in locale:

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

  Verranno richieste le informazioni seguenti:

  • Nome ambiente: questo valore viene usato come prefisso per tutte le risorse di Azure create da Azure Developer CLI. Il nome deve essere univoco in tutte le sottoscrizioni di Azure e deve avere una lunghezza compresa tra 3 e 24 caratteri. Il nome può contenere solo lettere minuscole e numeri.

• Accedere ad Azure:

  azd auth login
  

• Effettuare il provisioning e distribuire le risorse in Azure:

  azd up
  

  Verranno richieste le informazioni seguenti:

  • Sottoscrizione: sottoscrizione di Azure in cui vengono distribuite le risorse.
  • Posizione: area in cui sono distribuite le risorse.

  Il completamento della distribuzione può richiedere alcuni minuti. L'output del comando azd up include il nome dell'account di archiviazione appena creato, che sarà necessario in un secondo momento per eseguire il codice.

Eseguire il codice di esempio

A questo punto, le risorse vengono distribuite in Azure e il codice è quasi pronto per l'esecuzione. Seguire questa procedura per aggiornare il nome dell'account di archiviazione nel codice ed eseguire l'app console di esempio:

• Eseguire l’aggiornamento del nome dell'account di archiviazione:
  1. Nella directory locale passare alla directory blob-quickstart/src/main/java/com/blobs/quickstart.
  2. Aprire il file denominato App.java nell'editor. Trovare il segnaposto <storage-account-name> e sostituirlo con il nome effettivo dell'account di archiviazione creato dal comando azd up.
  3. Salvare le modifiche.
• Eseguire il progetto:
  1. Passare alla directory blob-quickstart contenente il pom.xml file. Compilare il progetto usando il comando mvn seguente:

     mvn compile
     

  2. Creare un pacchetto del codice compilato nel formato distribuibile:

     mvn package
     

  3. Eseguire il comando mvn seguente per eseguire l'app:

     mvn exec:java
     

• Osservare l'output: questa app crea un file di test nella cartella dati locale e lo carica in un contenitore nell'account di archiviazione. L'esempio elenca quindi i BLOB presenti nel contenitore e scarica il file con un nuovo nome per consentire il confronto tra i nuovi file e quelli precedenti.

Per altre informazioni sul funzionamento del codice di esempio, vedere Esempi di codice.

Al termine del test del codice, vedere la sezione Pulire le risorse per eliminare le risorse create dal comando azd up.

Aggiungere questo codice alla fine del metodo Main:

Aggiungere questo codice alla fine del metodo Main:

Aggiungere questo codice alla fine del metodo Main:

Aggiungere questo codice alla fine del metodo Main:

Aggiungere questo codice alla fine del metodo Main:

Eseguire il codice

Questa app crea un file di test nella cartella locale e lo carica nell'archiviazione BLOB. L'esempio elenca quindi i BLOB presenti nel contenitore e scarica il file con un nuovo nome per consentire il confronto tra i nuovi file e quelli precedenti.

Seguire i passaggi per compilare, creare un pacchetto ed eseguire il codice

1. Passare alla directory contenente il file pom.xml e compilare il progetto tramite il comando mvn seguente:

   mvn compile
   

2. Creare un pacchetto del codice compilato nel formato distribuibile:

   mvn package
   

3. Eseguire il comando mvn seguente per eseguire l'app:

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

   Per semplificare il passaggio di esecuzione, è possibile aggiungere exec-maven-plugin a pom.xml e configurare come illustrato di seguito:

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

   Con questa configurazione, è possibile eseguire l'app con il comando seguente:

   mvn exec:java
   

L'output dell'app è simile all'esempio seguente (i valori UUID omessi per la leggibilità):

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

Prima di iniziare il processo di pulizia, controllare che nella cartella dati siano presenti due file. È possibile confrontarli e osservare che sono identici.

Dopo aver verificato i file e aver completato il test, premere INVIO per eliminare i file di test insieme al contenitore creato nell'account di archiviazione. È anche possibile usare l'interfaccia della riga di comando di Azure per eliminare le risorse.

Al termine dell'avvio rapido, è possibile pulire le risorse create eseguendo il comando seguente:

azd down

Verrà richiesto di confermare l'eliminazione delle risorse. Immettere y per confermare.