RequestOptions Classe
- java.
lang. Object - com.
microsoft. azure. storage. RequestOptions
- com.
public class RequestOptions
Representa as opções a serem usadas durante o processamento de uma determinada solicitação.
Resumo do Construtor
Construtor | Description |
---|---|
RequestOptions() |
Cria uma instância da classe . |
RequestOptions(final RequestOptions other) |
Cria uma instância da classe copiando valores de outra instância. |
Resumo do método
Modificador e tipo | Método e descrição |
---|---|
void |
applyBaseDefaultsInternal(final RequestOptions modifiedOptions)
Preencherá o tempo limite padrão, a política de repetição e o modo de localização do cliente se eles forem nulos. |
Boolean |
disableHttpsSocketKeepAlive()
Obtém um valor para indicar se o keep alive do soquete https deve ser desabilitado. Use para desabilitar keep alive; Caso contrário. Para obter mais informações sobre os padrões disableHttpsSocketKeepAlive, consulte getDefaultRequestOptions() |
final Location |
getLocationMode()
Obtém o modo de local padrão para essa solicitação. Para obter mais informações sobre o modo de localização, consulte setLocationMode(final LocationMode locationMode). |
Integer |
getMaximumExecutionTimeInMs()
Obtém o tempo máximo de execução para essa solicitação. Para obter mais informações sobre padrões máximos de tempo de execução, consulte setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs). |
Long |
getOperationExpiryTimeInMs()
RESERVADO PARA USO INTERNO. Retorna a hora em que essa operação expira. Isso é calculado adicionando a hora em que a operação começa e o tempo máximo de execução e será nulo se o tempo máximo de execução for nulo. Para obter mais informações sobre o tempo máximo de execução, consulte setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs). |
final Retry |
getRetryPolicyFactory()
Obtém a política de repetição a ser usada para essa solicitação. Para obter mais informações sobre os padrões de política de repetição, consulte setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory). |
final Integer |
getTimeoutIntervalInMs()
Retorna o valor de tempo limite para essa solicitação. Para obter mais informações sobre os padrões de tempo limite, consulte setTimeoutIntervalInMs(final Integer timeoutIntervalInMs). |
void |
populateRequestOptions(RequestOptions modifiedOptions, final RequestOptions clientOptions, final boolean setStartTime)
Preenche todos os campos nulos no primeiro objeto requestOptions com valores do segundo objeto requestOptions. |
Boolean |
requireEncryption()
Obtém um valor para indicar se todos os dados gravados e lidos devem ser criptografados. Use para criptografar/descriptografar dados para transações; Caso contrário. Para obter mais informações sobre como exigir padrões de criptografia, consulte setRequireEncryption(Boolean requireEncryption). |
void |
setDisableHttpsSocketKeepAlive(Boolean disableHttpsSocketKeepAlive)
Define um valor para indicar se o keep alive do soquete https deve ser desabilitado. Use para desabilitar keep alive; Caso contrário O padrão é definido no cliente e, por padrão, é true, indicando que o keep alive do soquete https será desabilitado. Você pode alterar o valor nessa solicitação definindo essa propriedade. Você também pode alterar o valor em no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem o valor apropriado. Definir keep alive em soquetes https é contornar um bug na JVM em que os tempos limite de conexão não são respeitados em solicitações repetidas. Nesses casos, você pode optar por usar keep alive de soquete como um fallback. Infelizmente, o valor de tempo limite deve ser obtido de uma propriedade JVM em vez de configurado localmente. Portanto, em casos raros em que a JVM configurou tempos de keep alive agressivamente curtos, pode não ser benéfico habilitar o uso de keep alives para que eles não interfiram em operações de transferência de dados de execução prolongada. |
void |
setLocationMode(final LocationMode locationMode)
Define o LocationMode para esta solicitação. O padrão LocationMode é definido no cliente e é por padrão PRIMARY_ONLY. Você pode alterar o LocationMode nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse LocationMode. |
void |
setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs)
Define o tempo máximo de execução a ser usado ao fazer essa solicitação. O intervalo máximo de tempo de execução começa no momento em que o cliente começa a compilar a solicitação. O tempo máximo de execução é verificado intermitentemente ao carregar dados, baixar dados e antes de executar novas tentativas. O serviço continuará carregando, baixando e repetindo até que o tempo máximo de execução seja atingido. Nesse momento, todos os uploads ou downloads parciais serão cancelados e uma exceção será gerada. A execução máxima padrão é definida no cliente e é, por padrão, nula, indicando que não há tempo máximo. Você pode alterar o tempo máximo de execução nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem o tempo máximo de execução. |
void |
setRequireEncryption(Boolean requireEncryption)
Define um valor para indicar se todos os dados gravados e lidos devem ser criptografados. Use para criptografar/descriptografar dados para transações; Caso contrário. O padrão é definido no cliente e é false por padrão, indicando que a criptografia não é necessária. Você pode alterar o valor nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem o valor apropriado. |
final void |
setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory)
Define o objeto RetryPolicyFactory a ser usado para essa solicitação. O Padrão RetryPolicyFactory é definido no cliente e é por padrão RetryExponentialRetry. Você pode alterar RetryPolicyFactory nesta solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem essa RetryPolicyFactory. |
final void |
setTimeoutIntervalInMs(final Integer timeoutIntervalInMs)
Define o tempo limite a ser usado ao fazer essa solicitação. O intervalo de tempo limite do servidor começa no momento em que a solicitação completa foi recebida pelo serviço e o servidor começa a processar a resposta. Se o intervalo de tempo limite expirar antes que a resposta seja retornada ao cliente, a operação atingirá o tempo limite. O intervalo de tempo limite será redefinido com cada repetição, se a solicitação for repetida. O tempo limite do servidor padrão é definido no cliente e é nulo por padrão, indicando que não há tempo limite do servidor. Você pode alterar o tempo limite do servidor nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse tempo limite do servidor. |
Detalhes do construtor
RequestOptions
public RequestOptions()
Cria uma instância da classe .
RequestOptions
public RequestOptions(final RequestOptions other)
Cria uma instância da classe copiando valores de outra instância.
Parameters:
RequestOptions
objeto que representa as opções de solicitação a serem copiadas.
Detalhes do método
applyBaseDefaultsInternal
protected static void applyBaseDefaultsInternal(final RequestOptions modifiedOptions)
Preencherá o tempo limite padrão, a política de repetição e o modo de localização do cliente se eles forem nulos.
Parameters:
disableHttpsSocketKeepAlive
public Boolean disableHttpsSocketKeepAlive()
Obtém um valor para indicar se o keep alive do soquete https deve ser desabilitado. Use para desabilitar keep alive; Caso contrário. Para obter mais informações sobre os padrões disableHttpsSocketKeepAlive, consulte getDefaultRequestOptions()
Returns:
getLocationMode
public final LocationMode getLocationMode()
Obtém o modo de local padrão para essa solicitação. Para obter mais informações sobre o modo de localização, consulte setLocationMode(final LocationMode locationMode).
Returns:
getMaximumExecutionTimeInMs
public Integer getMaximumExecutionTimeInMs()
Obtém o tempo máximo de execução para essa solicitação. Para obter mais informações sobre padrões máximos de tempo de execução, consulte setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs).
Returns:
getOperationExpiryTimeInMs
public Long getOperationExpiryTimeInMs()
RESERVADO PARA USO INTERNO.
Retorna a hora em que essa operação expira. Isso é calculado adicionando a hora em que a operação começa e o tempo máximo de execução e será nulo se o tempo máximo de execução for nulo. Para obter mais informações sobre o tempo máximo de execução, consulte setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs).
Returns:
getRetryPolicyFactory
public final RetryPolicyFactory getRetryPolicyFactory()
Obtém a política de repetição a ser usada para essa solicitação. Para obter mais informações sobre os padrões de política de repetição, consulte setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory).
Returns:
getTimeoutIntervalInMs
public final Integer getTimeoutIntervalInMs()
Retorna o valor de tempo limite para essa solicitação. Para obter mais informações sobre os padrões de tempo limite, consulte setTimeoutIntervalInMs(final Integer timeoutIntervalInMs).
Returns:
populateRequestOptions
protected static void populateRequestOptions(RequestOptions modifiedOptions, final RequestOptions clientOptions, final boolean setStartTime)
Preenche todos os campos nulos no primeiro objeto requestOptions com valores do segundo objeto requestOptions.
Parameters:
requireEncryption
public Boolean requireEncryption()
Obtém um valor para indicar se todos os dados gravados e lidos devem ser criptografados. Use para criptografar/descriptografar dados para transações; Caso contrário. Para obter mais informações sobre como exigir padrões de criptografia, consulte setRequireEncryption(Boolean requireEncryption).
Returns:
setDisableHttpsSocketKeepAlive
public void setDisableHttpsSocketKeepAlive(Boolean disableHttpsSocketKeepAlive)
Define um valor para indicar se o keep alive do soquete https deve ser desabilitado. Use para desabilitar keep alive; Caso contrário
O padrão é definido no cliente e, por padrão, é true, indicando que o keep alive do soquete https será desabilitado. Você pode alterar o valor nessa solicitação definindo essa propriedade. Você também pode alterar o valor em no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem o valor apropriado.
Definir keep alive em soquetes https é contornar um bug na JVM em que os tempos limite de conexão não são respeitados em solicitações repetidas. Nesses casos, você pode optar por usar keep alive de soquete como um fallback. Infelizmente, o valor de tempo limite deve ser obtido de uma propriedade JVM em vez de configurado localmente. Portanto, em casos raros em que a JVM configurou tempos de keep alive agressivamente curtos, pode não ser benéfico habilitar o uso de keep alives para que eles não interfiram em operações de transferência de dados de execução prolongada.
Parameters:
setLocationMode
public void setLocationMode(final LocationMode locationMode)
Define o LocationMode para esta solicitação.
O padrão LocationMode é definido no cliente e é por padrão PRIMARY_ONLY. Você pode alterar o LocationMode nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse LocationMode.
Parameters:
setMaximumExecutionTimeInMs
public void setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs)
Define o tempo máximo de execução a ser usado ao fazer essa solicitação.
O intervalo máximo de tempo de execução começa no momento em que o cliente começa a compilar a solicitação. O tempo máximo de execução é verificado intermitentemente ao carregar dados, baixar dados e antes de executar novas tentativas. O serviço continuará carregando, baixando e repetindo até que o tempo máximo de execução seja atingido. Nesse momento, todos os uploads ou downloads parciais serão cancelados e uma exceção será gerada.
A execução máxima padrão é definida no cliente e é, por padrão, nula, indicando que não há tempo máximo. Você pode alterar o tempo máximo de execução nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem o tempo máximo de execução.
Parameters:
setRequireEncryption
public void setRequireEncryption(Boolean requireEncryption)
Define um valor para indicar se todos os dados gravados e lidos devem ser criptografados. Use para criptografar/descriptografar dados para transações; Caso contrário.
O padrão é definido no cliente e é false por padrão, indicando que a criptografia não é necessária. Você pode alterar o valor nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem o valor apropriado.
Parameters:
setRetryPolicyFactory
public final void setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory)
Define o objeto RetryPolicyFactory a ser usado para essa solicitação.
O Padrão RetryPolicyFactory é definido no cliente e é por padrão RetryExponentialRetry. Você pode alterar RetryPolicyFactory nesta solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem essa RetryPolicyFactory.
Parameters:
setTimeoutIntervalInMs
public final void setTimeoutIntervalInMs(final Integer timeoutIntervalInMs)
Define o tempo limite a ser usado ao fazer essa solicitação.
O intervalo de tempo limite do servidor começa no momento em que a solicitação completa foi recebida pelo serviço e o servidor começa a processar a resposta. Se o intervalo de tempo limite expirar antes que a resposta seja retornada ao cliente, a operação atingirá o tempo limite. O intervalo de tempo limite será redefinido com cada repetição, se a solicitação for repetida.
O tempo limite do servidor padrão é definido no cliente e é nulo por padrão, indicando que não há tempo limite do servidor. Você pode alterar o tempo limite do servidor nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse tempo limite do servidor.
Parameters:
Aplica-se a
Azure SDK for Java