Démarrage rapide : Bibliothèque de client Stockage Blob Azure pour Java

Dans cet article, vous suivez les étapes pour installer le package et essayer l’exemple de code pour les tâches de base.

Dans cet article, vous utilisez Azure Developer CLI pour déployer des ressources Azure et exécuter une application console terminée en quelques commandes seulement.

• Compte Azure avec un abonnement actif : créez gratuitement un compte.
• Compte de stockage Azure : créez un compte de stockage.
• Kit de développement Java (JDK), version 8 ou ultérieure
• Apache Maven

• Abonnement Azure : créez-en un gratuitement
• Kit de développement Java (JDK), version 8 ou ultérieure
• Apache Maven
• Azure Developer CLI

Cette section vous guide tout au long de la préparation d’un projet à utiliser avec la bibliothèque de client Stockage Blob Azure pour Java.

Créer le projet

Créez une application Java nommée blob-quickstart.

1. Dans une fenêtre de console (par exemple, PowerShell ou Bash), utilisez Maven pour créer une application console nommée blob-quickstart. Tapez la commande mvn suivante pour créer un projet 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. Le résultat de la génération du projet doit ressembler à ceci :

   [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. Basculez vers le dossier blob-quickstart nouvellement créé.

   cd blob-quickstart
   

4. Dans le répertoire blob-quickstart, créez un autre répertoire nommé data. Ce dossier est l’endroit où les fichiers de données Blob seront créés et stockés.

   mkdir data
   

Installer les packages

Ouvrez le fichier pom.xml dans votre éditeur de texte.

Ajoutez azure-sdk-bom pour établir une dépendance sur la dernière version de la bibliothèque. Dans l’extrait de code suivant, remplacez l’espace réservé {bom_version_to_target} par le numéro de version. L’utilisation d’azure-sdk-bom vous empêche de devoir spécifier la version de chaque dépendance individuelle. Pour en savoir plus sur la nomenclature, consultez le fichier Lisez-moi de la nomenclature du SDK Azure.

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

Ajoutez ensuite les éléments dependency suivants au groupe de dépendances. La dépendance azure-identity est nécessaire pour les connexions sans mot de passe aux services Azure.

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

Configurer le framework d’application

À partir du répertoire du projet, procédez comme suit pour créer la structure de base de l’application :

1. Accédez au répertoire /src/main/Java/com/blobs/QuickStart
2. Ouvrez le fichier App.java dans votre éditeur.
3. Supprimez la ligne System.out.println("Hello world!");
4. Ajoutez les directives import requises

Le code doit ressembler à ce 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
    }
}

Avec Azure Developer CLI installé, vous pouvez créer un compte de stockage et exécuter l’exemple de code en quelques commandes seulement. Vous pouvez exécuter le projet dans votre environnement de développement local ou dans un DevContainer.

Initialiser le modèle Azure Developer CLI et déployer des ressources

À partir d’un répertoire vide, procédez comme suit pour initialiser le modèle azd, approvisionner des ressources Azure et commencer à utiliser le code :

• Clonez les ressources du référentiel de démarrage rapide à partir de GitHub et initialisez le modèle localement :

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

  Les informations suivantes vous sont demandées :

  • Nom de l’environnement : cette valeur est utilisée comme préfixe pour toutes les ressources Azure créées par Azure Developer CLI. Le nom doit être unique dans l’ensemble des abonnements Azure et il doit contenir entre 3 et 24 caractères. Le nom peut contenir uniquement des chiffres et des lettres minuscules.

• Connexion à Azure :

  azd auth login
  

• Approvisionnez et déployez les ressources sur Azure :

  azd up
  

  Les informations suivantes vous sont demandées :

  • Abonnement : abonnement Azure sur lequel vos ressources sont déployées.
  • Emplacement : région Azure où vos ressources sont déployées.

  Le déploiement peut prendre quelques minutes. La sortie de la commande azd up inclut le nom du compte de stockage nouvellement créé, dont vous aurez besoin ultérieurement pour exécuter le code.

Exécuter l’exemple de code

À ce stade, les ressources sont déployées sur Azure et le code est presque prêt à être exécuté. Suivez ces étapes pour mettre à jour le nom du compte de stockage dans le code et exécuter l’exemple d’application console :

• Mettre à jour le nom du compte de stockage:
  1. Dans le répertoire local, accédez au répertoire blob-quickstart/src/main/java/com/blobs/quickstart .
  2. Ouvrez le fichier nommé App.java dans votre éditeur. Recherchez l’espace réservé <storage-account-name> et remplacez-le par le nom réel du compte de stockage créé par la commande azd up.
  3. Enregistrez les modifications.
• Exécutez le projet :
  1. Naviguez jusqu’au répertoire blob-quickstart contenant le fichier pom.xml. Compilez le projet à l’aide de la commande mvn suivante :

     mvn compile
     

  2. Empaquetez le code compilé dans son format distribuable :

     mvn package
     

  3. Exécutez la commande mvn suivante pour exécuter l’application :

     mvn exec:java
     

• Observez la sortie : cette application crée un fichier de test dans votre dossier local data et le charge dans un conteneur du compte de stockage. L’exemple liste ensuite les objets blob du conteneur et télécharge le fichier avec un nouveau nom pour que vous puissiez comparer les deux fichiers.

Pour en savoir plus sur le fonctionnement de l’exemple de code, consultez la section Exemples de code.

Une fois que vous avez terminé de tester le code, consultez la section Nettoyer les ressources pour supprimer les ressources créées par la commande azd up.

Ajoutez ce code à la fin de la méthode Main :

Ajoutez ce code à la fin de la méthode Main :

Ajoutez ce code à la fin de la méthode Main :

Ajoutez ce code à la fin de la méthode Main :

Ajoutez ce code à la fin de la méthode Main :

Exécuter le code

Cette application crée un fichier de test dans votre dossier local et le charge sur un stockage blob. L’exemple liste ensuite les objets blob du conteneur et télécharge le fichier avec un nouveau nom pour que vous puissiez comparer les deux fichiers.

Suivez les étapes pour compiler, empaqueter et exécuter le code

1. Accédez au répertoire contenant le fichier pom.xml, puis compilez le projet à l’aide de la commande mvn suivante :

   mvn compile
   

2. Empaquetez le code compilé dans son format distribuable :

   mvn package
   

3. Exécutez la commande mvn suivante pour exécuter l’application :

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

   Pour simplifier l’étape d’exécution, vous pouvez ajouter exec-maven-plugin et pom.xml, et configurer comme indiqué ci-dessous :

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

   Avec cette configuration, vous pouvez exécuter l’application avec la commande suivante :

   mvn exec:java
   

La sortie de l’application est similaire à l’exemple suivant (valeurs UUID omises pour une meilleure lisibilité) :

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

Avant de commencer le processus de nettoyage, vérifiez la présence des deux fichiers dans votre dossier data. Vous pouvez les comparer et constater qu’ils sont identiques.

Une fois que vous avez vérifié les fichiers et terminé le test, appuyez sur la touche Entrée pour supprimer les fichiers de test avec le conteneur que vous avez créé dans le compte de stockage. Vous pouvez également utiliser Azure CLI pour supprimer des ressources.

Lorsque vous avez terminé avec le démarrage rapide, vous pouvez nettoyer les ressources créées en exécutant la commande suivante :

azd down

Il vous sera demandé de confirmer la suppression des ressources. Entrez y pour confirmer.