Inicio rápido: Biblioteca cliente de Azure Blob Storage para Java

En este artículo, siga los pasos para instalar el paquete y probar el código de ejemplo para tareas básicas.

En este artículo, se usa Azure Developer CLI para implementar recursos de Azure y ejecutar una aplicación de consola completa con solo unos cuantos comandos.

• Cuenta de Azure con una suscripción activa: cree una cuenta gratuita.
• Cuenta de Azure Storage: cree una cuenta de almacenamiento.
• Kit de desarrollo de Java (JDK), versión 8 o posterior
• Apache Maven

• Una suscripción a Azure: cree una cuenta gratuita
• Kit de desarrollo de Java (JDK), versión 8 o posterior
• Apache Maven
• CLI de desarrollo de Azure

En esta sección se explica cómo preparar un proyecto para que funcione con la biblioteca cliente de Azure Blob Storage para Java.

Creación del proyecto

Cree una aplicación de Java llamada blob-quickstart.

1. En una ventana de consola (por ejemplo, PowerShell o Bash), use Maven para crear una nueva aplicación de consola con el nombre blob-quickstart. Escriba el siguiente comando mvn para crear un proyecto de 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. La salida a partir de la generación del proyecto debe ser similar a la siguiente:

   [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. Cambie a la carpeta blob-quickstart recién creada.

   cd blob-quickstart
   

4. En el directorio blob-quickstart, cree otro directorio denominado datos. En esta carpeta es donde se crearán y almacenarán los archivos de datos de blobs.

   mkdir data
   

Instalación de los paquetes

Abra el archivo pom.xml en el editor de texto.

Agregue azure-sdk-bom para tomar una dependencia de la versión más reciente de la biblioteca. En el fragmento de código siguiente, reemplace el marcador de posición {bom_version_to_target} por el número de versión. El uso de azure-sdk-bom le impide especificar la versión de cada dependencia individual. Para más información sobre el BOM, consulte el archivo LÉAME de BOM del SDK de 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>

A continuación, agregue los siguientes elementos de dependencia al grupo de dependencias. La dependencia de azure-identity es necesaria para las conexiones sin contraseña a los servicios de Azure.

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

Instalación del marco de la aplicación

En el directorio del proyecto, siga los pasos para crear la estructura básica de la aplicación:

1. Navegue al directorio /src/main/java/com/blobs/quickstart.
2. Abra el archivo App.java en un editor.
3. Elimine la línea System.out.println("Hello world!");
4. Agregue las directivas import necesarias

El código debe ser similar a este marco:

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 instalado, puede crear una cuenta de almacenamiento y ejecutar el código de ejemplo con solo unos cuantos comandos. Puede ejecutar el proyecto en el entorno de desarrollo local o en DevContainer.

Inicialización de la plantilla de Azure Developer CLI e implementación de recursos

En un directorio vacío, siga estos pasos para inicializar la plantilla azd, aprovisionar recursos de Azure y empezar a trabajar con el código:

• Clone los recursos del repositorio de inicio rápido de GitHub e inicialice la plantilla localmente:

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

  Se le pedirá la siguiente información:

  • Nombre del entorno: este valor se usa como prefijo para todos los recursos de Azure creados por Azure Developer CLI. El nombre debe ser único en todas las suscripciones de Azure y tener entre 3 y 24 caracteres. El nombre solo puede contener números y letras minúsculas.

• Inicie sesión en Azure:

  azd auth login
  

• Aprovisione e implemente los recursos en Azure:

  azd up
  

  Se le pedirá la siguiente información:

  • Suscripción: la suscripción de Azure en la que se implementan los recursos.
  • Ubicación: la región de Azure donde se implementan los recursos.

  La implementación puede tardar unos minutos en finalizar. La salida del comando azd upincluye el nombre de la cuenta de almacenamiento recién creada, que necesitará más adelante para ejecutar el código.

Ejecución del código de ejemplo

En este punto, los recursos se implementan en Azure y el código está casi listo para ejecutarse. Siga estos pasos para actualizar el nombre de la cuenta de almacenamiento en el código y ejecute la aplicación de consola de ejemplo:

• Actualizar el nombre de la cuenta de almacenamiento:
  1. En el directorio local, vaya al directorio blob-quickstart/src/main/java/com/blobs/quickstart.
  2. Abra el archivo App.java en su editor. Busque el marcador de posición <storage-account-name> y reemplácelo por el nombre real de la cuenta de almacenamiento creada por el comando azd up.
  3. Guarde los cambios.
• Ejecute el proyecto:
  1. Navegue hasta el directorio blob-quickstart que contiene el archivo pom.xml. Compile el proyecto utilizando el siguiente comando mvn:

     mvn compile
     

  2. Empaquete el código compilado en su formato distribuible:

     mvn package
     

  3. Ejecute el siguiente comando mvn para ejecutar la aplicación:

     mvn exec:java
     

• Observar la salida: esta aplicación crea un archivo de prueba en la carpeta de datos local y lo carga en un contenedor de la cuenta de almacenamiento. Después, en el ejemplo se enumeran los blobs del contenedor y se descarga el archivo con un nombre nuevo para que pueda comparar los archivos antiguo y nuevo.

Para más información sobre cómo funciona el código de ejemplo, consulte Ejemplos de código.

Cuando haya terminado de probar el código, consulte la sección Limpieza de recursos para eliminar los recursos creados por el comando azd up.

Agregue este código al final del método Main:

Agregue este código al final del método Main:

Agregue este código al final del método Main:

Agregue este código al final del método Main:

Agregue este código al final del método Main:

Ejecución del código

Esta aplicación crea un archivo de prueba en la carpeta local y lo carga en Blob Storage. Después, en el ejemplo se enumeran los blobs del contenedor y se descarga el archivo con un nombre nuevo para que pueda comparar los archivos antiguo y nuevo.

Siga los pasos para compilar, empaquetar y ejecutar el código

1. Navegue hasta el directorio que contiene el archivo pom.xml y compile el proyecto mediante el siguiente comando mvn:

   mvn compile
   

2. Empaquete el código compilado en su formato distribuible:

   mvn package
   

3. Ejecute el siguiente comando mvn para ejecutar la aplicación:

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

   Para simplificar el paso de ejecución, puede agregar exec-maven-plugin y pom.xml configurarlos como se muestra a continuación:

   <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 esta configuración, puede ejecutar la aplicación con el siguiente comando:

   mvn exec:java
   

La salida de la aplicación es similar al ejemplo siguiente (se omiten los valores UUID para mejorar la legibilidad):

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

Antes de comenzar el proceso de limpieza, compruebe la carpeta data para ver si están los dos archivos. Puede compararlos y comprobar que son idénticos.

Después de comprobar los archivos y finalizar las pruebas, presione la tecla ENTRAR para eliminar los archivos de prueba junto con el contenedor que creó en la cuenta de almacenamiento. También puede usar la CLI de Azure para eliminar recursos.

Cuando haya terminado con el inicio rápido, puede limpiar los recursos que creó con el siguiente comando:

azd down

Se le pedirá que confirme la eliminación de los recursos. Escriba y para confirmar.