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

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

• Una suscripción a Azure: cree una cuenta gratuita
• Kit de desarrollo de Java (JDK) versión 1.8_101 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. Revisa los resultados derivados de la generación del proyecto.

   [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. Dentro del directorio blob-quickstart , crea otro directorio llamado data. Esta carpeta es donde se crean y almacenan los archivos de datos del blob.

   mkdir data
   

Instalación de los paquetes

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

Agregue azure-sdk-bom para depender 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. Al usar azure-sdk-bom, no necesitas especificar la versión de cada dependencia individual. Para obtener más información sobre el BOM, consulte el README del 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. Necesitas la dependencia de identidad de Azure para 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 estos pasos para crear la estructura básica de la aplicación:

1. Vaya 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
    }
}

Usando la CLI de Azure Developer, puedes crear una cuenta de almacenamiento y ejecutar el código de ejemplo con solo unos pocos comandos. Puedes ejecutar el proyecto en tu entorno de desarrollo local o en un 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 de entorno: Azure la CLI para desarrolladores usa este valor como prefijo para todos los recursos de Azure que crea. 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 para desplegar tus recursos.
  • Ubicación: La región de Azure para desplegar tus recursos.

  La implementación puede tardar unos minutos en finalizar. La salida del azd up comando incluye el nombre de la cuenta de almacenamiento recién creada, que necesita 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.

Sigue estos 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, añade exec-maven-plugin a pom.xml y configúralo como se muestra en el siguiente código:

   <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, ejecuta 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 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, limpie los recursos que creó mediante la ejecución del comando siguiente:

azd down

Recibes un aviso para confirmar la eliminación de los recursos. Escriba y para confirmar.