Guida introduttiva: Libreria client per l'archiviazione BLOB di Azure in Java SE

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 1.8_101 o successiva
• Apache Maven

• Sottoscrizione di Azure: creare un account gratuito
• Java Development Kit (JDK) versione 1.8_101 o successiva
• Apache Maven
• CLI per sviluppatori di Azure

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. Rivedi i risultati derivanti dalla generazione del progetto.

   [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. All'interno della cartella blob-quickstart , crea un'altra directory chiamata data. Questa cartella è dove vengono creati e memorizzati i file 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. Usando azure-sdk-bom, non è necessario specificare la versione di ogni singola dipendenza. Per saperne di più sulla BOM, consulta il README della 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. Serve la dipendenza Azure-identity per le connessioni senza password ai servizi 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 questa 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
    }
}

Utilizzando la CLI di Azure Developer, puoi creare un account di archiviazione ed eseguire il codice di esempio con pochi comandi. Puoi eseguire il progetto nel tuo 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:

• Clona le risorse del repository quickstart da GitHub e inizializza il modello localmente:

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

  Vengono richieste le informazioni seguenti:

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

• Accedere a Azure:

  azd auth login
  

• Effettuare il provisioning e distribuire le risorse in Azure:

  azd up
  

  Vengono richieste le informazioni seguenti:

  • Abbonamento: l'abbonamento Azure per distribuire le tue risorse.
  • Posizione: La regione Azure per distribuire le tue risorse.

  Il completamento della distribuzione può richiedere alcuni minuti. L'output del azd up comando include il nome dell'account di archiviazione appena creato, 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 che contiene il file pom.xml. 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
     

• Osserva l'output: l'app crea un file di test nella cartella locale data 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.

Segui questi passaggi per compilare, impacchettare 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 passo di esecuzione, aggiungete exec-maven-plugin a pom.xml e configuratelo come mostrato nel seguente codice:

   <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, esegui l'app con il seguente comando:

   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, pulire le risorse create eseguendo il comando seguente:

azd down

Ricevi un prompt per confermare la cancellazione delle risorse. Immettere y per confermare.