Share via

Introdução ao Armazenamento de Blobs do Azure e ao Java

  • Artigo

Este artigo mostra como se conectar ao Armazenamento de Blobs do Azure usando a biblioteca de clientes para Java do Armazenamento de Blobs do Azure. Após se conectar, seu código pode operar em contêineres, blobs e recursos do serviço de Armazenamento de Blobs.

Referência de API | Pacote (Maven) | Código-fonte da biblioteca | Exemplos | Enviar comentários

Pré-requisitos

Configurar o seu projeto

Observação

Este artigo usa a ferramenta de build do Maven para compilar e executar o código de exemplo. Outras ferramentas de build, como o Gradle, também funcionam com o SDK do Azure para Java.

Use o Maven para criar um novo aplicativo de console ou abrir um projeto existente. Siga estas etapas para instalar pacotes e adicionar as diretivas necessárias import .

Instalar Pacotes

Abra o arquivo pom.xml no seu editor de texto. Instale os pacotes incluindo o arquivo BOM ou incluindo uma dependência direta.

Incluir o arquivo da BOM

Adicione azure-sdk-bom para usar uma dependência da última versão da biblioteca. No snippet a seguir, substitua o espaço reservado {bom_version_to_target} pelo número de versão. O uso do azure-sdk-bom elimina a necessidade de especificação da versão de cada dependência individual. Para saber mais sobre o BOM, confira o LEIAME do BOM 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>

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-storage-common</artifactId>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
</dependency>

Incluir uma dependência direta

Para assumir a dependência de uma versão específica da biblioteca, adicione a dependência direta ao seu projeto:

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-storage-blob</artifactId>
    <version>{package_version_to_target}</version>
</dependency>
<dependency>
      <groupId>com.azure</groupId>
      <artifactId>azure-storage-common</artifactId>
      <version>{package_version_to_target}</version>
</dependency>
<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>{package_version_to_target}</version>
</dependency>

Incluir diretivas de importação

Em seguida, abra o arquivo de código e adicione as diretivas import necessárias. Neste exemplo, adicionamos as seguintes diretivas no arquivo App.java:

import com.azure.core.credential.*;
import com.azure.identity.*;
import com.azure.storage.blob.*;
import com.azure.storage.blob.models.*;
import com.azure.storage.blob.specialized.*;
import com.azure.storage.common.*;

Informações da biblioteca de clientes do blob:

Autorizar o acesso e se conectar ao Armazenamento de Blobs

Para conectar um aplicativo ao Armazenamento de Blobs, crie uma instância da classe BlobServiceClient. Você também pode usar a classe BlobServiceAsyncClient de programação assíncrona. Esse objeto é seu ponto de partida para interagir com os recursos de dados no nível da conta de armazenamento. Você pode usá-lo para operar na conta de armazenamento e nos respectivos contêineres. Você também pode usar o cliente de serviço para criar clientes de contêiner ou clientes de blob, dependendo do recurso com o qual você precisa trabalhar.

Para saber mais sobre como criar e gerenciar objetos clientes, confira Criar e gerenciar objetos clientes que interagem com recursos de dados.

Você pode autorizar um objeto BlobServiceClient usando um token de autorização do Microsoft Entra, uma chave de acesso de conta ou uma assinatura de acesso compartilhado (SAS).

Para autorizar com o Microsoft Entra ID, precisará usar uma entidade de segurança. Qual tipo de entidade de segurança você precisa. depende do local em que o aplicativo é executado. Use a tabela a seguir como guia:

Onde o aplicativo é executado Entidade de segurança Diretrizes
Computador local (desenvolvimento e teste) Entidade de serviço Para saber como registrar o aplicativo, configure um grupo do Microsoft Entra, atribua funções e configure variáveis de ambiente, consulte Autorizar o acesso usando entidades de serviço do desenvolvedor.
Computador local (desenvolvimento e teste) Identidade do usuário Para saber como configurar um grupo do Microsoft Entra, atribua funções e entre no Azure, consulte Autorizar acesso usando credenciais de desenvolvedor.
Hospedada no Azure Identidade gerenciada Para saber como habilitar a identidade gerenciada e atribuir funções, confira Autorizar o acesso de aplicativos hospedados no Azure usando uma identidade gerenciada.
Hospedado fora do Azure (por exemplo, aplicativos locais) Entidade de serviço Para saber como registrar o aplicativo, atribuir funções e configurar variáveis de ambiente, confira Autorizar o acesso em aplicativos locais usando uma entidade de serviço de aplicativo

Autorizar o acesso usando DefaultAzureCredential

Uma maneira fácil e segura de autorizar o acesso e se conectar ao Armazenamento de Blobs é obter um token OAuth criando uma instância de DefaultAzureCredential. Depois, você pode usar essa credencial para criar um objeto BlobServiceClient.

Verifique se você tem as dependências corretas no pom.xml e as diretivas de importação necessárias, conforme descrito em Configurar seu projeto.

O exemplo a seguir usa BlobServiceClientBuilder para criar um objeto BlobServiceClient usando DefaultAzureCredential:

public static BlobServiceClient GetBlobServiceClientTokenCredential() {
    TokenCredential credential = new DefaultAzureCredentialBuilder().build();

    // Azure SDK client builders accept the credential as a parameter
    // TODO: Replace <storage-account-name> with your actual storage account name
    BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
            .endpoint("https://<storage-account-name>.blob.core.windows.net/")
            .credential(credential)
            .buildClient();

    return blobServiceClient;
}

Crie seu aplicativo

À medida que você cria aplicativos para trabalhar com recursos de dados no Armazenamento de Blobs do Azure, seu código interage principalmente com três tipos de recursos: contas de armazenamento, contêineres e blobs. Para saber mais sobre esses tipos de recursos, como eles se relacionam entre si e como os aplicativos interagem com os recursos, confira Entender como os aplicativos interagem com os recursos de dados do Armazenamento de Blobs.

Os guias a seguir mostram como trabalhar com recursos de dados e executar ações específicas usando a biblioteca de clientes do Armazenamento do Microsoft Azure para Java:

Guia Descrição
Criar um contêiner Crie contêineres.
Excluir e restaurar contêineres Exclua contêineres e, se a exclusão reversível estiver habilitada, restaure os contêineres excluídos.
Listar contêineres Liste os contêineres em uma conta e as diversas opções disponíveis para personalizar uma listagem.
Gerenciar propriedades e metadados (contêineres) Obtenha e defina as propriedades e metadados dos contêineres.
Criar e gerenciar concessões de contêiner Estabeleça e gerencie um bloqueio em um contêiner.
Criar e gerenciar concessões de blob Estabeleça e gerencie um bloqueio em um blob.
Carregar blobs Saiba como carregar blobs usando cadeias de caracteres, fluxos, caminhos de arquivo e outros métodos.
Baixar blobs Baixe blobs usando cadeias de caracteres, fluxos e caminhos de arquivo.
Copiar blobs Copie um blob de uma localização para outra.
Listar blobs Liste blobs de maneiras diferentes.
Excluir e restauração Exclua os blobs, e, se a exclusão reversível estiver habilitada, restaure os blobs excluídos.
Encontrar blobs usando marcas Defina e recupere marcas, bem como use marcas para localizar blobs.
Gerenciar propriedades e metadados (blobs) Obtenha e defina as propriedades e metadados dos blobs.
Definir ou alterar o nível de acesso de um blob Defina ou altere a camada de acesso para um blob de blocos.