Aan de slag met Azure Blob Storage en Java
In dit artikel wordt beschreven hoe u verbinding maakt met Azure Blob Storage met behulp van de Azure Blob Storage-clientbibliotheek voor Java. Zodra de code is verbonden, kan uw code worden uitgevoerd op containers, blobs en functies van de Blob Storage-service.
Voorbeelden van | broncode van | API-referentiepakket | (Maven) | Library geven feedback
Vereisten
- Azure-abonnement: u kunt een gratis abonnement nemen
- Azure Storage-account: maak een opslagaccount
- Java Development Kit (JDK)-versie 8 of hoger
- Apache Maven wordt in dit voorbeeld gebruikt voor projectbeheer
Uw project instellen
Notitie
In dit artikel wordt het Maven-buildhulpprogramma gebruikt om de voorbeeldcode te bouwen en uit te voeren. Andere buildhulpprogramma's, zoals Gradle, werken ook met de Azure SDK voor Java.
Gebruik Maven om een nieuwe console-app te maken of een bestaand project te openen. Volg deze stappen om pakketten te installeren en de benodigde import
instructies toe te voegen.
Pakketten installeren
Open het pom.xml
bestand in de teksteditor. Installeer de pakketten door het BOM-bestand op te slaan of door een directe afhankelijkheid op te slaan.
Het BOM-bestand opnemen
Voeg azure-sdk-bom toe om een afhankelijkheid te maken van de nieuwste versie van de bibliotheek. Vervang in het volgende codefragment de {bom_version_to_target}
tijdelijke aanduiding door het versienummer. Als u azure-sdk-bom gebruikt, hoeft u niet de versie van elke afzonderlijke afhankelijkheid op te geven. Zie de Azure SDK BOM README voor meer informatie over de BOM.
<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>
Voeg de volgende afhankelijkheidselementen toe aan de groep met afhankelijkheden. De azure-identity-afhankelijkheid is nodig voor verbindingen zonder wachtwoord met Azure-services.
<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>
Een directe afhankelijkheid opnemen
Als u afhankelijk wilt worden van een bepaalde versie van de bibliotheek, voegt u de directe afhankelijkheid toe aan uw project:
<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>
Importrichtlijnen opnemen
Open vervolgens het codebestand en voeg de benodigde import
instructies toe. In dit voorbeeld voegen we de volgende instructies toe in het bestand 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.*;
Informatie over de Blob-clientbibliotheek:
- com.azure.storage.blob: bevat de primaire klassen (clientobjecten) die u kunt gebruiken om te werken op de service, containers en blobs.
- com.azure.storage.blob.models: Bevat hulpprogrammaklassen, structuren en opsommingstypen.
- com.azure.storage.blob.specialized: bevat klassen die u kunt gebruiken om bewerkingen uit te voeren die specifiek zijn voor een blobtype (bijvoorbeeld toevoeg-blobs).
Toegang autoriseren en verbinding maken met Blob Storage
Als u een toepassing wilt verbinden met Blob Storage, maakt u een exemplaar van de BlobServiceClient-klasse . U kunt ook de BlobServiceAsyncClient-klasse gebruiken voor asynchrone programmering. Dit object is het startpunt om te communiceren met gegevensbronnen op het niveau van het opslagaccount. U kunt het gebruiken om te werken op het opslagaccount en de bijbehorende containers. U kunt de serviceclient ook gebruiken om containerclients of blob-clients te maken, afhankelijk van de resource waarmee u moet werken.
Zie Clientobjecten maken en beheren die interactie hebben met gegevensbronnen voor meer informatie over het maken en beheren van clientobjecten.
U kunt een BlobServiceClient
object autoriseren met behulp van een Microsoft Entra-autorisatietoken, een toegangssleutel voor een account of een SAS (Shared Access Signature).
Als u wilt autoriseren met Microsoft Entra-id, moet u een beveiligingsprincipaal gebruiken. Welk type beveiligingsprincipaal u nodig hebt, is afhankelijk van waar uw toepassing wordt uitgevoerd. Gebruik de volgende tabel als richtlijn:
Toegang autoriseren met DefaultAzureCredential
Een eenvoudige en veilige manier om toegang te verlenen en verbinding te maken met Blob Storage is door een OAuth-token te verkrijgen door een DefaultAzureCredential-exemplaar te maken. Vervolgens kunt u die referentie gebruiken om een BlobServiceClient-object te maken.
Zorg ervoor dat u over de juiste afhankelijkheden in pom.xml en de benodigde importrichtlijnen beschikt, zoals beschreven in Uw project instellen.
In het volgende voorbeeld wordt BlobServiceClientBuilder gebruikt om een BlobServiceClient
object te bouwen met behulp vanDefaultAzureCredential
:
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;
}
Uw toepassing bouwen
Wanneer u toepassingen bouwt om te werken met gegevensresources in Azure Blob Storage, communiceert uw code voornamelijk met drie resourcetypen: opslagaccounts, containers en blobs. Voor meer informatie over deze resourcetypen, hoe deze zich verhouden tot elkaar en hoe apps communiceren met resources, raadpleegt u Begrijpen hoe apps communiceren met Blob Storage-gegevensresources.
De volgende handleidingen laten zien hoe u met gegevensbronnen werkt en specifieke acties uitvoert met behulp van de Azure Storage-clientbibliotheek voor Java:
Guide | Beschrijving |
---|---|
Een container maken | Containers maken. |
Containers verwijderen en herstellen | Verwijder containers en als voorlopig verwijderen is ingeschakeld, herstelt u verwijderde containers. |
Containers weergeven | Lijst met containers in een account en de verschillende opties die beschikbaar zijn om een vermelding aan te passen. |
Eigenschappen en metagegevens beheren (containers) | Eigenschappen en metagegevens voor containers ophalen en instellen. |
Containerleases maken en beheren | Een vergrendeling voor een container tot stand brengen en beheren. |
Blob-leases maken en beheren | Een vergrendeling op een blob tot stand brengen en beheren. |
Blobs uploaden | Meer informatie over het uploaden van blobs met behulp van tekenreeksen, streams, bestandspaden en andere methoden. |
Blobs downloaden | Download blobs met behulp van tekenreeksen, streams en bestandspaden. |
Blobs kopiƫren | Kopieer een blob van de ene locatie naar de andere. |
Blobs vermelden | Geef blobs op verschillende manieren weer. |
Verwijderen en herstellen | Verwijder blobs en als voorlopig verwijderen is ingeschakeld, herstelt u verwijderde blobs. |
Blobs zoeken met behulp van tags | Stel tags in en haal ze op en gebruik tags om blobs te vinden. |
Eigenschappen en metagegevens beheren (blobs) | Eigenschappen en metagegevens voor blobs ophalen en instellen. |
De toegangslaag van een blob instellen of wijzigen | Stel de toegangslaag voor een blok-blob in of wijzig deze. |