RetryOptions Classe

Referência

Pacote:: com.microsoft.azure.cosmosdb

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

public class RetryOptions

Encapsula as opções de repetição no serviço de banco de dados do Azure Cosmos DB.

Resumo do Construtor

Construtor	Description
RetryOptions()	Cria uma nova instância da classe RetryOptions e inicializa todas as propriedades para valores padrão.

Resumo do método

Modificador e tipo	Método e descrição
int	getMaxRetryAttemptsOnThrottledRequests() Obtém o número máximo de repetições no caso em que a solicitação falha porque o serviço aplicou a limitação de taxa no cliente.
int	getMaxRetryWaitTimeInSeconds() Obtém o tempo máximo de repetição em segundos.
void	setMaxRetryAttemptsOnThrottledRequests(int maxRetryAttemptsOnThrottledRequests) Define o número máximo de repetições no caso em que a solicitação falha porque o serviço aplicou a limitação de taxa no cliente. Quando um cliente estiver enviando solicitações mais rapidamente do que a taxa permitida, o serviço retornará HttpStatusCode 429 (Solicitação Demais) para limitar o cliente. A implementação atual no SDK aguardará a quantidade de tempo que o serviço informa para aguardar e tentar novamente depois que o tempo tiver decorrido. O valor padrão é 9. Isso significa que, no caso em que a solicitação é limitada, a mesma solicitação será emitida no máximo 10 vezes para o servidor antes que um erro seja retornado ao aplicativo.
void	setMaxRetryWaitTimeInSeconds(int maxRetryWaitTimeInSeconds) Define o tempo máximo de repetição em segundos. Quando uma solicitação falha devido a um erro de limitação, o serviço envia de volta uma resposta que contém um valor que indica que o cliente não deve tentar novamente antes que o período de tempo tenha decorrido (Retry-After). O sinalizador MaxRetryWaitTime permite que o aplicativo defina um tempo máximo de espera para todas as tentativas de repetição. Se o tempo de espera cumulativo exceder o MaxRetryWaitTime, o SDK deixará de tentar novamente e retornará o erro ao aplicativo. O valor padrão é 30 segundos.
String	toString()

Detalhes do construtor

RetryOptions

public RetryOptions()

Cria uma nova instância da classe RetryOptions e inicializa todas as propriedades para valores padrão.

Detalhes do método

getMaxRetryAttemptsOnThrottledRequests

public int getMaxRetryAttemptsOnThrottledRequests()

Obtém o número máximo de repetições no caso em que a solicitação falha porque o serviço aplicou a limitação de taxa no cliente.

Retornos:

o número máximo de repetições.

getMaxRetryWaitTimeInSeconds

public int getMaxRetryWaitTimeInSeconds()

Obtém o tempo máximo de repetição em segundos.

Retornos:

o tempo máximo de repetição em segundos.

setMaxRetryAttemptsOnThrottledRequests

public void setMaxRetryAttemptsOnThrottledRequests(int maxRetryAttemptsOnThrottledRequests)

Define o número máximo de repetições no caso em que a solicitação falha porque o serviço aplicou a limitação de taxa no cliente.

Quando um cliente estiver enviando solicitações mais rapidamente do que a taxa permitida, o serviço retornará HttpStatusCode 429 (Solicitação Demais) para limitar o cliente. A implementação atual no SDK aguardará a quantidade de tempo que o serviço informa para aguardar e tentar novamente depois que o tempo tiver decorrido.

O valor padrão é 9. Isso significa que, no caso em que a solicitação é limitada, a mesma solicitação será emitida no máximo 10 vezes para o servidor antes que um erro seja retornado ao aplicativo.

Parâmetros:

maxRetryAttemptsOnThrottledRequests - o número máximo de tentativas de repetição em solicitações com falha devido a um erro de limitação.

setMaxRetryWaitTimeInSeconds

public void setMaxRetryWaitTimeInSeconds(int maxRetryWaitTimeInSeconds)

Define o tempo máximo de repetição em segundos.

Quando uma solicitação falha devido a um erro de limitação, o serviço envia de volta uma resposta que contém um valor que indica que o cliente não deve tentar novamente antes que o período de tempo tenha decorrido (Retry-After). O sinalizador MaxRetryWaitTime permite que o aplicativo defina um tempo máximo de espera para todas as tentativas de repetição. Se o tempo de espera cumulativo exceder o MaxRetryWaitTime, o SDK deixará de tentar novamente e retornará o erro ao aplicativo.

O valor padrão é 30 segundos.

Parâmetros:

maxRetryWaitTimeInSeconds - o número máximo de segundos em que uma solicitação será repetida.

toString

public String toString()

Partilhar via