Guia de início rápido: biblioteca de cliente do Armazenamento de Blobs do Azure para Java

Neste artigo, siga as etapas para instalar o pacote e experimentar o código de exemplo para tarefas básicas.

Neste artigo, você usa a CLI do Desenvolvedor do Azure para implantar recursos do Azure e executar um aplicativo de console concluído com apenas alguns comandos.

• Conta do Azure com uma subscrição ativa - crie uma conta gratuitamente
• Conta de armazenamento do Azure - crie uma conta de armazenamento.
• Java Development Kit (JDK) versão 8 ou superior
• Apache Maven

• Subscrição do Azure - crie uma gratuitamente
• Java Development Kit (JDK) versão 8 ou superior
• Apache Maven
• CLI do desenvolvedor do Azure

Esta seção orienta você na preparação de um projeto para trabalhar com a biblioteca de cliente do Armazenamento de Blobs do Azure para Java.

Criar o projeto

Crie um aplicativo Java chamado blob-quickstart.

1. Em uma janela de console (como PowerShell ou Bash), use o Maven para criar um novo aplicativo de console com o nome blob-quickstart. Digite o seguinte comando mvn para criar um "Hello world!" Projeto Java.

   • 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. A saída da geração do projeto deve ser algo como isto:

   [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. Alterne para a pasta blob-quickstart recém-criada.

   cd blob-quickstart
   

4. Ao lado do diretório blob-quickstart , crie outro diretório chamado data. Esta pasta é onde os arquivos de dados de blob serão criados e armazenados.

   mkdir data
   

Instalar os pacotes

Abra o arquivo no editor de pom.xml texto.

Adicione azure-sdk-bom para depender da versão mais recente da biblioteca. No trecho a seguir, substitua o espaço reservado {bom_version_to_target} pelo número da versão. Usar azure-sdk-bom evita que você precise especificar a versão de cada dependência individual. Para saber mais sobre a lista técnica, consulte o Leiame da lista técnica do SDK do 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>

Em seguida, adicione os seguintes elementos de dependência ao grupo de dependências. A dependência azure-identity é necessária para conexões sem senha com os serviços do Azure.

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

Configurar a estrutura do aplicativo

No diretório do projeto, siga as etapas para criar a estrutura básica do aplicativo:

1. Navegue até o diretório /src/main/java/com/blobs/quickstart
2. Abra o App.java arquivo no editor
3. Excluir a linha System.out.println("Hello world!");
4. Aditar as diretivas necessárias import

O código deve assemelhar-se a esta estrutura:

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

Com a CLI do Desenvolvedor do Azure instalada, você pode criar uma conta de armazenamento e executar o código de exemplo com apenas alguns comandos. Você pode executar o projeto em seu ambiente de desenvolvimento local ou em um DevContainer.

Inicializar o modelo da CLI do Azure Developer e implantar recursos

Em um diretório vazio, siga estas etapas para inicializar o azd modelo, provisionar recursos do Azure e começar a usar o código:

• Clone os ativos do repositório de início rápido do GitHub e inicialize o modelo localmente:

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

  Ser-lhe-ão solicitadas as seguintes informações:

  • Nome do ambiente: esse valor é usado como um prefixo para todos os recursos do Azure criados pela CLI do Desenvolvedor do Azure. O nome deve ser exclusivo em todas as assinaturas do Azure e deve ter entre 3 e 24 caracteres. O nome pode conter apenas letras minúsculas e números.

• Faça logon no Azure:

  azd auth login
  

• Provisione e implante os recursos no Azure:

  azd up
  

  Ser-lhe-ão solicitadas as seguintes informações:

  • Assinatura: a assinatura do Azure na qual seus recursos são implantados.
  • Local: a região do Azure onde seus recursos são implantados.

  A implantação pode levar alguns minutos para ser concluída. A saída do azd up comando inclui o nome da conta de armazenamento recém-criada, que você precisará mais tarde para executar o código.

Execute o código de exemplo

Neste ponto, os recursos são implantados no Azure e o código está quase pronto para ser executado. Siga estas etapas para atualizar o nome da conta de armazenamento no código e execute o aplicativo de console de exemplo:

• Atualize o nome da conta de armazenamento:
  1. No diretório local, navegue até o diretório blob-quickstart/src/main/java/com/blobs/quickstart .
  2. Abra o arquivo chamado App.java no editor. Localize o espaço reservado <storage-account-name> e substitua-o pelo nome real da conta de armazenamento criada pelo azd up comando.
  3. Guarde as alterações.
• Execute o projeto:
  1. Navegue até o diretório blob-quickstart que contém o pom.xml arquivo. Compile o projeto usando o seguinte mvn comando:

     mvn compile
     

  2. Empacote o código compilado em seu formato distribuível:

     mvn package
     

  3. Execute o seguinte mvn comando para executar o aplicativo:

     mvn exec:java
     

• Observe a saída: Este aplicativo cria um arquivo de teste em sua pasta de dados local e o carrega em um contêiner na conta de armazenamento. O exemplo lista os blobs no contêiner e baixa o arquivo com um novo nome para que você possa comparar os arquivos antigos e novos.

Para saber mais sobre como o código de exemplo funciona, consulte Exemplos de código.

Quando terminar de testar o código, consulte a seção Limpar recursos para excluir os recursos criados pelo azd up comando.

Adicione este código ao final do Main método:

Adicione este código ao final do Main método:

Adicione este código ao final do Main método:

Adicione este código ao final do Main método:

Adicione este código ao final do Main método:

Executar o código

Este aplicativo cria um arquivo de teste em sua pasta local e o carrega para o armazenamento de Blob. O exemplo lista os blobs no contêiner e baixa o arquivo com um novo nome para que você possa comparar os arquivos antigos e novos.

Siga as etapas para compilar, empacotar e executar o código

1. Navegue até o diretório que contém o pom.xml arquivo e compile o projeto usando o seguinte mvn comando:

   mvn compile
   

2. Empacote o código compilado em seu formato distribuível:

   mvn package
   

3. Execute o seguinte mvn comando para executar o aplicativo:

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

   Para simplificar a etapa de execução, você pode adicionar exec-maven-pluginpom.xml e configurar como mostrado abaixo:

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

   Com essa configuração, você pode executar o aplicativo com o seguinte comando:

   mvn exec:java
   

A saída do aplicativo é semelhante ao exemplo a seguir (valores UUID omitidos para legibilidade):

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 iniciar o processo de limpeza, verifique a pasta de dados para os dois arquivos. Você pode compará-los e observar que eles são idênticos.

Depois de verificar os arquivos e concluir o teste, pressione a tecla Enter para excluir os arquivos de teste junto com o contêiner criado na conta de armazenamento. Você também pode usar a CLI do Azure para excluir recursos.

Quando terminar o início rápido, você poderá limpar os recursos criados executando o seguinte comando:

azd down

Você será solicitado a confirmar a exclusão dos recursos. Entre y para confirmar.