Compartilhar via


RequestOptions Classe

  • java.lang.Object
    • com.microsoft.azure.storage.RequestOptions

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 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).

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 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).

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:

other - Um 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:

modifiedOptions - As opções de entrada a serem copiadas ao aplicar padrões

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:

Um valor para indicar se o keep alive do soquete https deve ser desabilitado.

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:

Um LocationMode objeto que representa o modo de localização para essa solicitação.

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:

O tempo máximo de execução atual, em milissegundos, para essa solicitação.

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:

O tempo de expiração da operação atual, em milissegundos, para essa solicitação.

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:

Um RetryPolicyFactory objeto que representa a política de repetição atual.

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:

O valor de tempo limite atual, em milissegundos, para essa solicitação.

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:

modifiedOptions
clientOptions
setStartTime

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:

Um valor para indicar se todos os dados gravados e lidos devem ser criptografados.

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:

disableHttpsSocketKeepAlive - Um valor para indicar se o keep alive do soquete https deve ser desabilitado.

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:

locationMode - o locationMode a ser definido

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:

maximumExecutionTimeInMs - O tempo máximo de execução, em milissegundos, a ser usado para essa solicitação.

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:

requireEncryption - Um valor para indicar se todos os dados gravados e lidos devem ser criptografados.

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:

retryPolicyFactory - o objeto RetryPolicyFactory a ser usado ao fazer solicitações de serviço.

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:

timeoutIntervalInMs - O tempo limite, em milissegundos, a ser usado para essa solicitação.

Aplica-se a