Freigeben über


RetryOptions Klasse

  • java.lang.Object
    • com.microsoft.azure.cosmosdb.RetryOptions

public class RetryOptions

Kapselt Wiederholungsoptionen im Azure Cosmos DB-Datenbankdienst.

Zusammenfassung zum Konstruktor

Konstruktor Beschreibung
RetryOptions()

Erstellt eine neue instance der RetryOptions-Klasse und initialisiert alle Eigenschaften als Standardwerte.

Methodenzusammenfassung

Modifizierer und Typ Methode und Beschreibung
int getMaxRetryAttemptsOnThrottledRequests()

Ruft die maximale Anzahl von Wiederholungen ab, wenn die Anforderung fehlschlägt, weil der Dienst die Ratenbegrenzung auf den Client angewendet hat.

int getMaxRetryWaitTimeInSeconds()

Ruft die maximale Wiederholungszeit in Sekunden ab.

void setMaxRetryAttemptsOnThrottledRequests(int maxRetryAttemptsOnThrottledRequests)

Legt die maximale Anzahl von Wiederholungen für den Fall fest, dass die Anforderung fehlschlägt, weil der Dienst die Ratenbegrenzung auf den Client angewendet hat.

Wenn ein Client Anforderungen schneller als die zulässige Rate sendet, gibt der Dienst HttpStatusCode 429 (Too Many Request) zurück, um den Client zu drosseln. Die aktuelle Implementierung im SDK wartet dann auf die Zeit, die der Dienst ihr mitteilt, dass sie warten soll, und wiederholen sie, nachdem die Zeit verstrichen ist.

Der Standardwert ist 9. Dies bedeutet, dass für den Fall, dass die Anforderung gedrosselt wird, dieselbe Anforderung maximal 10 Mal an den Server ausgegeben wird, bevor ein Fehler an die Anwendung zurückgegeben wird.

void setMaxRetryWaitTimeInSeconds(int maxRetryWaitTimeInSeconds)

Legt die maximale Wiederholungszeit in Sekunden fest.

Wenn eine Anforderung aufgrund eines Drosselungsfehlers fehlschlägt, sendet der Dienst eine Antwort zurück, die einen Wert enthält, der angibt, dass der Client vor Ablauf des Zeitraums keine Wiederholungen ausführen sollte (Wiederholungs-Nach). Mit dem Flag MaxRetryWaitTime kann die Anwendung eine maximale Wartezeit für alle Wiederholungsversuche festlegen. Wenn die kumulative Wartezeit die MaxRetryWaitTime überschreitet, beendet das SDK die Wiederholung und gibt den Fehler an die Anwendung zurück.

Der Standardwert ist 30 Sekunden.

String toString()

Details zum Konstruktor

RetryOptions

public RetryOptions()

Erstellt eine neue instance der RetryOptions-Klasse und initialisiert alle Eigenschaften als Standardwerte.

Details zur Methode

getMaxRetryAttemptsOnThrottledRequests

public int getMaxRetryAttemptsOnThrottledRequests()

Ruft die maximale Anzahl von Wiederholungen ab, wenn die Anforderung fehlschlägt, weil der Dienst die Ratenbegrenzung auf den Client angewendet hat.

Gibt zurück:

die maximale Anzahl von Wiederholungen.

getMaxRetryWaitTimeInSeconds

public int getMaxRetryWaitTimeInSeconds()

Ruft die maximale Wiederholungszeit in Sekunden ab.

Gibt zurück:

die maximale Wiederholungszeit in Sekunden.

setMaxRetryAttemptsOnThrottledRequests

public void setMaxRetryAttemptsOnThrottledRequests(int maxRetryAttemptsOnThrottledRequests)

Legt die maximale Anzahl von Wiederholungen für den Fall fest, dass die Anforderung fehlschlägt, weil der Dienst die Ratenbegrenzung auf den Client angewendet hat.

Wenn ein Client Anforderungen schneller als die zulässige Rate sendet, gibt der Dienst HttpStatusCode 429 (Too Many Request) zurück, um den Client zu drosseln. Die aktuelle Implementierung im SDK wartet dann auf die Zeit, die der Dienst ihr mitteilt, dass sie warten soll, und wiederholen sie, nachdem die Zeit verstrichen ist.

Der Standardwert ist 9. Dies bedeutet, dass für den Fall, dass die Anforderung gedrosselt wird, dieselbe Anforderung maximal 10 Mal an den Server ausgegeben wird, bevor ein Fehler an die Anwendung zurückgegeben wird.

Parameter:

maxRetryAttemptsOnThrottledRequests - die maximale Anzahl von Wiederholungsversuchen bei fehlgeschlagenen Anforderungen aufgrund eines Drosselungsfehlers.

setMaxRetryWaitTimeInSeconds

public void setMaxRetryWaitTimeInSeconds(int maxRetryWaitTimeInSeconds)

Legt die maximale Wiederholungszeit in Sekunden fest.

Wenn eine Anforderung aufgrund eines Drosselungsfehlers fehlschlägt, sendet der Dienst eine Antwort zurück, die einen Wert enthält, der angibt, dass der Client vor Ablauf des Zeitraums keine Wiederholungen ausführen sollte (Wiederholungs-Nach). Mit dem Flag MaxRetryWaitTime kann die Anwendung eine maximale Wartezeit für alle Wiederholungsversuche festlegen. Wenn die kumulative Wartezeit die MaxRetryWaitTime überschreitet, beendet das SDK die Wiederholung und gibt den Fehler an die Anwendung zurück.

Der Standardwert ist 30 Sekunden.

Parameter:

maxRetryWaitTimeInSeconds - die maximale Anzahl von Sekunden, die eine Anforderung wiederholt.

toString

public String toString()

Gilt für: