Vytváření a správa zapůjčení objektů blob pomocí Javy
Tento článek ukazuje, jak vytvořit a spravovat zapůjčení objektů blob pomocí klientské knihovny Azure Storage pro Javu. Klientskou knihovnu můžete použít k získání, obnovení, uvolnění a přerušení zapůjčení objektů blob.
Požadavky
- Předplatné Azure – vytvoření bezplatného předplatného
- Účet úložiště Azure – Vytvoření účtu úložiště
- Sada Java Development Kit (JDK) verze 8 nebo novější (pro zajištění co nejlepšího prostředí doporučujeme verzi 17)
- Apache Maven se používá pro řízení projektů v tomto příkladu.
Nastavení prostředí
Pokud nemáte existující projekt, v této části se dozvíte, jak nastavit projekt pro práci s klientskou knihovnou Azure Blob Storage pro Javu. Další informace najdete v tématu Začínáme se službou Azure Blob Storage a Javou.
Pokud chcete pracovat s příklady kódu v tomto článku, nastavte projekt pomocí následujícího postupu.
Poznámka:
Tento článek používá nástroj pro sestavení Maven k sestavení a spuštění ukázkového kódu. Další nástroje sestavení, jako je Gradle, také pracují se sadou Azure SDK pro Javu.
Instalace balíčků
Otevřete soubor v textovém pom.xml editoru. Nainstalujte balíčky zahrnutím souboru kusovníku nebo zahrnutím přímé závislosti.
Přidání příkazů importu
Přidejte následující příkazy import:
import com.azure.storage.blob.*;
import com.azure.storage.blob.specialized.*;
Autorizace
Autorizační mechanismus musí mít potřebná oprávnění pro práci s zapůjčením objektu blob. K autorizaci pomocí Microsoft Entra ID (doporučeno) potřebujete předdefinovanou roli Přispěvatel dat objektů blob služby Azure RBAC nebo vyšší. Další informace najdete v pokynech k autorizaci pro zapůjčení objektu blob (REST API).
Vytvoření objektu klienta
Pokud chcete připojit aplikaci ke službě Blob Storage, vytvořte instanci BlobServiceClient.
Následující příklad používá BlobServiceClientBuilder k sestavení BlobServiceClient objektu pomocí DefaultAzureCredentiala ukazuje, jak vytvořit kontejner a klienty objektů blob v případě potřeby:
// 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(new DefaultAzureCredentialBuilder().build())
.buildClient();
// If needed, you can create a BlobContainerClient object from the BlobServiceClient
BlobContainerClient containerClient = blobServiceClient
.getBlobContainerClient("<container-name>");
// If needed, you can create a BlobClient object from the BlobContainerClient
BlobClient blobClient = containerClient
.getBlobClient("<blob-name>");
Další informace o vytváření a správě klientských objektů najdete v tématu Vytváření a správa klientských objektů, které pracují s datovými prostředky.
O zapůjčení objektů blob
Zapůjčení vytvoří a spravuje zámek objektu blob pro operace zápisu a odstranění. Doba trvání zámku může být 15 až 60 sekund nebo může být nekonečná. Zapůjčení objektu blob poskytuje výhradní přístup k zápisu a odstranění objektu blob. Pokud chcete zapisovat do objektu blob s aktivním zapůjčením, musí klient do žádosti o zápis zahrnout aktivní ID zapůjčení.
Další informace o stavech zapůjčení a o tom, kdy můžete provést danou akci u zapůjčení, najdete v tématu Stavy zapůjčení a akce.
Všechny operace kontejneru jsou povoleny v kontejneru, který zahrnuje objekty blob s aktivním zapůjčením, včetně odstranění kontejneru. Kontejner se proto může odstranit i v případě, že objekty blob v něm mají aktivní zapůjčení. Pomocí operace Zapůjčení kontejneru můžete řídit práva k odstranění kontejneru.
Operace zapůjčení zpracovává třída BlobLeaseClient , která poskytuje klienta obsahující všechny operace zapůjčení objektů blob a kontejnerů. Další informace o zapůjčení kontejnerů pomocí klientské knihovny najdete v tématu Vytváření a správa zapůjčení kontejnerů pomocí Javy.
Získání zapůjčení
Když získáte zapůjčení objektu blob, získáte ID zapůjčení, které váš kód může použít k provozu s objektem blob. Pokud objekt blob již má aktivní zapůjčení, můžete požádat pouze o nové zapůjčení pomocí ID aktivního zapůjčení. Můžete ale zadat novou dobu zapůjčení.
Pokud chcete získat zapůjčení, vytvořte instanci třídy BlobLeaseClient a pak použijte následující metodu:
Následující příklad získá 30sekundové zapůjčení objektu 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;
}
Prodloužení zapůjčení
Pokud ID zapůjčení zadané v požadavku odpovídá ID zapůjčení přidružené k objektu blob, můžete obnovit zapůjčení objektu blob. Zapůjčení je možné obnovit i v případě, že vypršela jeho platnost, pokud se objekt blob od vypršení platnosti tohoto zapůjčení nezměnil nebo zapůjčení znovu neprodloužil. Když prodloužíte zapůjčení, doba trvání zapůjčení se resetuje.
Pokud chcete obnovit stávající zapůjčení, použijte následující metodu:
Následující příklad obnoví zapůjčení objektu blob:
public void renewBlobLease(BlobLeaseClient leaseClient) {
leaseClient.renewLease();
}
Uvolnění zapůjčení
Zapůjčení objektu blob můžete uvolnit, pokud ID zapůjčení zadané v požadavku odpovídá ID zapůjčení přidružené k objektu blob. Uvolnění zapůjčení umožňuje jinému klientovi získat zapůjčení objektu blob okamžitě po dokončení vydání.
Zapůjčení můžete uvolnit pomocí následující metody:
Následující příklad uvolní zapůjčení objektu blob:
public void releaseBlobLease(BlobLeaseClient leaseClient) {
leaseClient.releaseLease();
System.out.println("Release lease operation completed");
}
Přerušení zapůjčení
Pokud má objekt blob aktivní zapůjčení, můžete přerušit zapůjčení objektu blob. Jakákoli autorizovaná žádost může přerušit zapůjčení; požadavek není nutný k zadání odpovídajícího ID zapůjčení. Zapůjčení nejde obnovit, jakmile se přeruší, a přerušení zapůjčení zabrání získání nového zapůjčení po určitou dobu, dokud nevyprší platnost původního zapůjčení nebo se uvolní.
Zapůjčení můžete přerušit pomocí následující metody:
Následující příklad přeruší zapůjčení objektu blob:
public void breakBlobLease(BlobLeaseClient leaseClient) {
leaseClient.breakLease();
}
Stavy a akce zapůjčení
Následující diagram znázorňuje pět stavů zapůjčení a příkazy nebo události, které způsobují změny stavu zapůjčení.
Následující tabulka uvádí pět stavů zapůjčení, uvádí stručný popis jednotlivých stavů a uvádí akce zapůjčení povolené v daném stavu. Tyto akce zapůjčení způsobují přechody stavu, jak je znázorněno v diagramu.
| Stav zapůjčení | Popis | Povolené akce zapůjčení |
|---|---|---|
| Dostupný | Zapůjčení je odemknuté a dá se získat. | acquire |
| Pronajatý | Zapůjčení je uzamčeno. | acquire (pouze stejné ID zapůjčení), renew, change, releasea break |
| Platnost vypršela | Doba trvání zapůjčení vypršela. | acquire, renew, releasea break |
| Lámání | Zapůjčení bylo přerušeno, ale zapůjčení bude nadále uzamčeno, dokud nevypršela doba přerušení. | release a break |
| Rozbitý | Zapůjčení bylo přerušeno a doba přerušení vypršela. | acquire, releasea break |
Po vypršení zapůjčení je ID zapůjčení udržováno službou Blob Service, dokud se objekt blob znovu nezmění nebo zapůjčí. Klient se může pokusit obnovit nebo uvolnit zapůjčení pomocí ID zapůjčení, jehož platnost vypršela. Pokud je tato operace úspěšná, klient ví, že se objekt blob od posledního platnosti ID zapůjčení nezměnil. Pokud požadavek selže, klient ví, že se objekt blob změnil nebo se objekt blob zapůjčený znovu od poslední aktivní zapůjčení. Klient pak musí získat nové zapůjčení objektu blob.
Pokud vyprší platnost zapůjčení místo explicitního uvolnění, klient může muset počkat až jednu minutu, než se pro objekt blob získá nové zapůjčení. Klient však může obnovit zapůjčení s ID zapůjčení okamžitě, pokud objekt blob nebyl změněn.
Zapůjčení nejde udělit pro snímek objektu blob, protože snímky jsou jen pro čtení. Vyžádání zapůjčení snímku způsobí stavový kód 400 (Bad Request).
Zdroje informací
Další informace o správě zapůjčení objektů blob pomocí klientské knihovny azure Blob Storage pro Javu najdete v následujících zdrojích informací.
Ukázky kódu
Operace rozhraní REST API
Sada Azure SDK pro Javu obsahuje knihovny, které jsou postavené na rozhraní Azure REST API a umožňují interakci s operacemi rozhraní REST API prostřednictvím známých paradigmat Javy. Metody klientské knihovny pro správu zapůjčení objektů blob používají následující operaci rozhraní REST API:
Prostředky klientské knihovny
Viz také
Související obsah
- Tento článek je součástí příručky pro vývojáře služby Blob Storage pro Javu. Další informace najdete v úplném seznamu článků příručky pro vývojáře na webu Sestavení aplikace v Javě.