Skapa och hantera bloblån med Java
Den här artikeln visar hur du skapar och hanterar bloblån med hjälp av Azure Storage-klientbiblioteket för Java. Du kan använda klientbiblioteket för att hämta, förnya, frigöra och bryta bloblån.
Förutsättningar
- Den här artikeln förutsätter att du redan har ett projekt konfigurerat för att fungera med Azure Blob Storage-klientbiblioteket för Java. Mer information om hur du konfigurerar projektet, inklusive paketinstallation, tillägg
importav direktiv och skapande av ett auktoriserat klientobjekt finns i Komma igång med Azure Storage och Java. - Auktoriseringsmekanismen måste ha behörighet att arbeta med ett bloblån. Mer information finns i auktoriseringsvägledningen för följande REST API-åtgärd:
Om bloblån
Ett lån skapar och hanterar ett lås på en blob för skriv- och borttagningsåtgärder. Låsvaraktigheten kan vara mellan 15 och 60 sekunder, eller så kan den vara oändlig. Ett lån på en blob ger exklusiv skriv- och borttagningsåtkomst till bloben. Om du vill skriva till en blob med ett aktivt lån måste en klient inkludera det aktiva låne-ID:t med skrivbegäran.
Mer information om lånetillstånd och när du kan utföra en viss åtgärd på ett lån finns i Lånetillstånd och åtgärder.
Alla containeråtgärder är tillåtna för en container som innehåller blobar med ett aktivt lån, inklusive Ta bort container. Därför kan en container tas bort även om blobar i den har aktiva lån. Använd åtgärden Lånecontainer för att kontrollera behörigheter för att ta bort en container.
Låneåtgärder hanteras av klassen BlobLeaseClient , som tillhandahåller en klient som innehåller alla låneåtgärder för blobar och containrar. Mer information om containerlån med hjälp av klientbiblioteket finns i Skapa och hantera containerlån med Java.
Skaffa ett lån
När du skaffar ett bloblån får du ett låne-ID som koden kan använda för att fungera på bloben. Om blobben redan har ett aktivt lån kan du bara begära ett nytt lån med hjälp av det aktiva låne-ID:t. Du kan dock ange en ny lånetid.
Om du vill skaffa ett lån skapar du en instans av klassen BlobLeaseClient och använder sedan följande metod:
I följande exempel hämtas ett lån på 30 sekunder för en blob:
public BlobLeaseClient acquireBlobLease(BlobClient blob) {
// Create the lease client
BlobLeaseClient leaseClient = new BlobLeaseClientBuilder()
.blobClient(blob)
.buildClient();
// Acquire the lease - specify duration between 15 and 60 seconds, or -1 for
// infinite duration
String leaseID = leaseClient.acquireLease(30);
System.out.printf("Acquired lease ID: %s%n", leaseID);
return leaseClient;
}
Förnya ett lån
Du kan förnya ett bloblån om låne-ID:t som anges i begäran matchar det låne-ID som är associerat med bloben. Lånet kan förnyas även om det har upphört att gälla, så länge blobben inte har ändrats eller hyrts igen sedan lånet upphör att gälla. När du förnyar ett lån återställs lånets varaktighet.
Om du vill förnya ett befintligt lån använder du följande metod:
I följande exempel förnyas ett lån för en blob:
public void renewBlobLease(BlobLeaseClient leaseClient) {
leaseClient.renewLease();
}
Frigöra ett lån
Du kan frigöra ett bloblån om låne-ID:t som anges i begäran matchar låne-ID:t som är associerat med bloben. Om du släpper ett lån kan en annan klient skaffa ett lån för bloben omedelbart efter att versionen har slutförts.
Du kan frigöra ett lån med hjälp av följande metod:
I följande exempel släpps lånet på en blob:
public void releaseBlobLease(BlobLeaseClient leaseClient) {
leaseClient.releaseLease();
System.out.println("Release lease operation completed");
}
Bryta ett lån
Du kan bryta ett bloblån om blobben har ett aktivt lån. Alla auktoriserade begäranden kan bryta lånet. begäran krävs inte för att ange ett matchande låne-ID. Ett lån kan inte förnyas efter att det har brutits, och om du bryter ett lån förhindras ett nytt lån från att förvärvas under en tidsperiod tills det ursprungliga lånet upphör att gälla eller frisläpps.
Du kan bryta ett lån med hjälp av följande metod:
I följande exempel bryts lånet för en blob:
public void breakBlobLease(BlobLeaseClient leaseClient) {
leaseClient.breakLease();
}
Lånetillstånd och åtgärder
Följande diagram visar de fem tillstånden för ett lån och de kommandon eller händelser som orsakar ändringar i lånetillståndet.
I följande tabell visas de fem lånetillstånden, en kort beskrivning av var och en och en av de låneåtgärder som tillåts i ett visst tillstånd. Dessa låneåtgärder orsakar tillståndsövergångar, som visas i diagrammet.
| Lånetillstånd | Description | Låneåtgärder tillåts |
|---|---|---|
| Tillgängligt | Lånet är olåst och kan förvärvas. | acquire |
| Leasade | Lånet är låst. | acquire (endast samma låne-ID), renew, change, releaseoch break |
| Upphört | Lånetiden har upphört att gälla. | acquire, renew, releaseoch break |
| Bryta | Lånet har brutits, men lånet fortsätter att vara låst tills brytperioden har upphört att gälla. | release och break |
| Bruten | Lånet har brutits och brytperioden har upphört att gälla. | acquire, release, och break |
När ett lån upphör att gälla underhålls låne-ID:t av Blob-tjänsten tills blobben ändras eller leasas igen. En klient kan försöka förnya eller frigöra lånet med det utgångna låne-ID:t. Om den här åtgärden lyckas vet klienten att bloben inte har ändrats sedan låne-ID:t senast var giltigt. Om begäran misslyckas vet klienten att bloben har ändrats eller att blobben hyrdes igen eftersom lånet senast var aktivt. Klienten måste sedan skaffa ett nytt lån för bloben.
Om ett lån upphör att gälla i stället för att uttryckligen frisläppas kan en klient behöva vänta upp till en minut innan ett nytt lån kan hämtas för bloben. Klienten kan dock förnya lånet med sitt låne-ID omedelbart om bloben inte har ändrats.
Det går inte att bevilja ett lån för en blobögonblicksbild eftersom ögonblicksbilder är skrivskyddade. Att begära ett lån mot en ögonblicksbild resulterar i statuskoden 400 (Bad Request).
Resurser
Mer information om hur du hanterar bloblån med hjälp av Azure Blob Storage-klientbiblioteket för Java finns i följande resurser.
REST API-åtgärder
Azure SDK för Java innehåller bibliotek som bygger på Azure REST API, så att du kan interagera med REST API-åtgärder via välbekanta Java-paradigm. Klientbiblioteksmetoderna för att hantera bloblån använder följande REST API-åtgärd: