Implementace zásad opakování pomocí Javy
Každá aplikace, která běží v cloudu nebo komunikuje se vzdálenými službami a prostředky, musí být schopná zpracovat přechodné chyby. U těchto aplikací je běžné, že dochází k chybám kvůli momentální ztrátě síťového připojení, vypršení časového limitu požadavku, když je služba nebo prostředek zaneprázdněný, nebo kvůli jiným faktorům. Vývojáři by měli vytvářet aplikace pro transparentní zpracování přechodných chyb za účelem zlepšení stability a odolnosti.
V tomto článku se dozvíte, jak pomocí klientské knihovny Azure Storage pro Javu nakonfigurovat zásady opakování pro aplikaci, která se připojuje ke službě Azure Blob Storage. Zásady opakování definují, jak aplikace zpracovává neúspěšné požadavky, a měly by se vždy ladit tak, aby odpovídaly obchodním požadavkům aplikace a povaze selhání.
Konfigurace možností opakování
Zásady opakování pro Blob Storage se konfigurují programově a nabízejí kontrolu nad tím, jak se možnosti opakování použijí pro různé požadavky a scénáře služby. Například webová aplikace, která vydává požadavky na základě interakce uživatele, může implementovat zásadu s menším počtem opakování a kratšími prodlevami, aby se zvýšila rychlost odezvy a upozorňují uživatele, když dojde k chybě. Případně může aplikace nebo komponenta, která spouští dávkové požadavky na pozadí, zvýšit počet opakovaných pokusů a použít exponenciální strategii zpětného odpočtu, která umožní úspěšné dokončení žádosti.
Následující tabulka uvádí dostupné parametry při vytváření instance RequestRetryOptions spolu s typem, stručným popisem a výchozí hodnotou, pokud neprovádíte žádné změny. Měli byste být proaktivní při ladění hodnot těchto vlastností tak, aby vyhovovaly potřebám vaší aplikace.
| Vlastnost | Type | Popis | Default value |
|---|---|---|---|
retryPolicyType |
RetryPolicyType | Nepovinné. Přístup k výpočtu zpoždění opakování. | EXPONENCIÁLNÍ |
maxTries |
Celé číslo | Nepovinné. Maximální počet pokusů o opakování před předáním. | 4 |
tryTimeoutInSeconds |
Celé číslo | Nepovinné. Maximální povolená doba před zrušením požadavku a předpokládá se, že selhala. Všimněte si, že časový limit se vztahuje na požadavek operace, nikoli na celkovou operaci na konci. Tato hodnota by měla být založená na šířce pásma dostupné hostitelskému počítači a blízkosti služby Storage. Dobrým výchozím bodem může být 60 sekund za MB očekávané velikosti datové části. | Integer.MAX_VALUE (sekundy) |
retryDelayInMs |
Dlouhé celé číslo | Nepovinné. Určuje množství zpoždění, které se má použít před opakováním operace. | 4ms pro EXPONENTIAL, 30ms pro FIXED |
maxRetryDelayInMs |
Dlouhé celé číslo | Nepovinné. Určuje maximální povolenou prodlevu před opakováním operace. | 120 ms |
secondaryHost |
String | Nepovinné. Sekundární koncový bod účtu úložiště pro opakování požadavků. Před nastavením této hodnoty byste měli porozumět problémům se čtením zastaralých a potenciálně nekonzistentních dat. Další informace najdete v tématu Použití geografické redundance k návrhu aplikací s vysokou dostupností. | Nic |
V následujícím příkladu kódu nakonfigurujeme možnosti opakování v instanci RequestRetryOptions a předáme ji k BlobServiceClientBuilder vytvoření objektu klienta:
RequestRetryOptions retryOptions = new RequestRetryOptions(RetryPolicyType.FIXED, 2, 3, 1000L, 1500L, null);
BlobServiceClient client = new BlobServiceClientBuilder()
.endpoint("https://<storage-account-name>.blob.core.windows.net/")
.credential(credential)
.retryOptions(retryOptions)
.buildClient();
V tomto příkladu každý požadavek služby vydaný z objektu BlobServiceClient používá možnosti opakování definované v RequestRetryOptions instanci. Tato zásada se vztahuje na požadavky klientů. Pro klienty služeb můžete nakonfigurovat různé strategie opakování na základě potřeb vaší aplikace.
Další kroky
- Tento článek je součástí příručky pro vývojáře služby Blob Storage pro Javu. Podívejte se na úplný seznam článků příručky pro vývojáře na webu Sestavení aplikace.
- Pokyny k architektuře a obecné osvědčené postupy pro zásady opakování najdete v tématu Zpracování přechodných chyb.
- Pokyny k implementaci vzoru opakování pro přechodné selhání najdete v tématu Vzor opakování.