RequestOptions Clase

Paquete:

com.microsoft.azure.storage

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

public class RequestOptions

Representa las opciones que se van a usar durante el procesamiento de una solicitud determinada.

Resumen del constructor

Constructor	Description
RequestOptions()	Cree una instancia de la clase.
RequestOptions(final RequestOptions other)	Crea una instancia de la clase copiando valores de otra instancia.

Resumen del método

Modificador y tipo	Método y descripción
void	applyBaseDefaultsInternal(final RequestOptions modifiedOptions) Rellena el tiempo de espera predeterminado, la directiva de reintento y el modo de ubicación del cliente si son NULL.
Boolean	disableHttpsSocketKeepAlive() Obtiene un valor para indicar si el socket https keep-alive debe deshabilitarse. Use para deshabilitar keep-alive; Lo contrario. Para obtener más información sobre los valores predeterminados disableHttpsSocketKeepAlive, consulte getDefaultRequestOptions()
final LocationMode	getLocationMode() Obtiene el modo de ubicación predeterminado para esta solicitud. Para obtener más información sobre el modo de ubicación, vea setLocationMode(final LocationMode locationMode).
Integer	getMaximumExecutionTimeInMs() Obtiene el tiempo de ejecución máximo de esta solicitud. Para obtener más información sobre los valores predeterminados de tiempo de ejecución máximo, vea setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs).
Long	getOperationExpiryTimeInMs() RESERVADO PARA USO INTERNO. Devuelve la hora en la que expira esta operación. Esto se calcula agregando la hora en que comienza la operación y el tiempo máximo de ejecución y será null si el tiempo de ejecución máximo es NULL. Para obtener más información sobre el tiempo de ejecución máximo, vea setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs).
final RetryPolicyFactory	getRetryPolicyFactory() Obtiene la directiva de reintento que se va a usar para esta solicitud. Para obtener más información sobre los valores predeterminados de la directiva de reintentos, vea setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory).
final Integer	getTimeoutIntervalInMs() Devuelve el valor de tiempo de espera de esta solicitud. Para obtener más información sobre los valores predeterminados de tiempo de espera, vea setTimeoutIntervalInMs(final Integer timeoutIntervalInMs).
void	populateRequestOptions(RequestOptions modifiedOptions, final RequestOptions clientOptions, final boolean setStartTime) Rellena los campos NULL del primer objeto requestOptions con valores del segundo objeto requestOptions.
Boolean	requireEncryption() Obtiene un valor para indicar si todos los datos escritos y leídos deben cifrarse. Se usa para cifrar o descifrar datos para transacciones; Lo contrario. Para obtener más información sobre los valores predeterminados de cifrado, vea setRequireEncryption(Boolean requireEncryption).
void	setDisableHttpsSocketKeepAlive(Boolean disableHttpsSocketKeepAlive) Establece un valor para indicar si el socket https keep-alive debe deshabilitarse. Use para deshabilitar keep-alive; Lo contrario El valor predeterminado se establece en el cliente y es true de forma predeterminada, lo que indica que el socket https keep-alive se deshabilitará. Puede cambiar el valor de esta solicitud estableciendo esta propiedad. También puede cambiar el valor en en el getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen el valor adecuado. Establecer keep-alive en sockets https es solucionar un error en la JVM donde no se respetan los tiempos de espera de conexión en las solicitudes de reintentación. En esos casos, puede optar por usar socket keep-alive como reserva. Desafortunadamente, el valor de tiempo de espera debe tomarse de una propiedad JVM en lugar de configurarse localmente. Por lo tanto, en raras ocasiones, la JVM ha configurado tiempos de mantenimiento dinámicos agresivamente cortos, puede que no sea beneficioso habilitar el uso de keep-alives para que interfieran con operaciones de transferencia de datos de larga duración.
void	setLocationMode(final LocationMode locationMode) Establece para LocationMode esta solicitud. El valor predeterminado LocationMode se establece en el cliente y es de forma predeterminada PRIMARY_ONLY. Puede cambiar en LocationMode esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese LocationMode.
void	setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs) Establece el tiempo de ejecución máximo que se usará al realizar esta solicitud. El intervalo de tiempo de ejecución máximo comienza en el momento en que el cliente comienza a compilar la solicitud. El tiempo máximo de ejecución se comprueba de forma intermitente mientras se cargan datos, se descargan datos y antes de ejecutar reintentos. El servicio seguirá cargando, descargando y reintentando hasta que se alcance el tiempo máximo de ejecución. En ese momento, se cancelarán las cargas o descargas parciales y se producirá una excepción. La ejecución máxima predeterminada se establece en el cliente y es null de forma predeterminada, lo que indica que no hay tiempo máximo. Puede cambiar el tiempo máximo de ejecución en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen el tiempo de ejecución máximo.
void	setRequireEncryption(Boolean requireEncryption) Establece un valor para indicar si todos los datos escritos y leídos deben cifrarse. Se usa para cifrar o descifrar datos para transacciones; Lo contrario. El valor predeterminado se establece en el cliente y es false de forma predeterminada, lo que indica que el cifrado no es necesario. Puede cambiar el valor de esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen el valor adecuado.
final void	setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory) Establece el objeto RetryPolicyFactory que se va a usar para esta solicitud. RetryPolicyFactory predeterminado se establece en el cliente y es de forma predeterminada RetryExponentialRetry. Puede cambiar RetryPolicyFactory en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen retryPolicyFactory.
final void	setTimeoutIntervalInMs(final Integer timeoutIntervalInMs) Establece el tiempo de espera que se usará al realizar esta solicitud. El intervalo de tiempo de espera del servidor comienza en el momento en que el servicio ha recibido la solicitud completa y el servidor comienza a procesar la respuesta. Si el intervalo de tiempo de espera transcurre antes de que se devuelva la respuesta al cliente, se agota el tiempo de espera de la operación. El intervalo de tiempo de espera se restablece con cada reintento, si se reintenta la solicitud. El tiempo de espera predeterminado del servidor se establece en el cliente y es null de forma predeterminada, lo que indica que no se ha agotado el tiempo de espera del servidor. Puede cambiar el tiempo de espera del servidor en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese tiempo de espera del servidor.

Detalles del constructor

RequestOptions

public RequestOptions()

Cree una instancia de la clase.

RequestOptions

public RequestOptions(final RequestOptions other)

Crea una instancia de la clase copiando valores de otra instancia.

Parameters:

other - Objeto RequestOptions que representa las opciones de solicitud que se van a copiar.

Detalles del método

applyBaseDefaultsInternal

protected static void applyBaseDefaultsInternal(final RequestOptions modifiedOptions)

Rellena el tiempo de espera predeterminado, la directiva de reintento y el modo de ubicación del cliente si son NULL.

Parameters:

modifiedOptions - Opciones de entrada desde las que se va a copiar al aplicar los valores predeterminados

disableHttpsSocketKeepAlive

public Boolean disableHttpsSocketKeepAlive()

Obtiene un valor para indicar si el socket https keep-alive debe deshabilitarse. Use para deshabilitar keep-alive; Lo contrario. Para obtener más información sobre los valores predeterminados disableHttpsSocketKeepAlive, consulte getDefaultRequestOptions()

Returns:

Valor que indica si el socket https keep-alive debe estar deshabilitado.

getLocationMode

public final LocationMode getLocationMode()

Obtiene el modo de ubicación predeterminado para esta solicitud. Para obtener más información sobre el modo de ubicación, vea setLocationMode(final LocationMode locationMode).

Returns:

Objeto LocationMode que representa el modo de ubicación de esta solicitud.

getMaximumExecutionTimeInMs

public Integer getMaximumExecutionTimeInMs()

Obtiene el tiempo de ejecución máximo de esta solicitud. Para obtener más información sobre los valores predeterminados de tiempo de ejecución máximo, vea setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs).

Returns:

Tiempo de ejecución máximo actual, en milisegundos, para esta solicitud.

getOperationExpiryTimeInMs

public Long getOperationExpiryTimeInMs()

RESERVADO PARA USO INTERNO.

Devuelve la hora en la que expira esta operación. Esto se calcula agregando la hora en que comienza la operación y el tiempo máximo de ejecución y será null si el tiempo de ejecución máximo es NULL. Para obtener más información sobre el tiempo de ejecución máximo, vea setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs).

Returns:

Hora de expiración de la operación actual, en milisegundos, para esta solicitud.

getRetryPolicyFactory

public final RetryPolicyFactory getRetryPolicyFactory()

Obtiene la directiva de reintento que se va a usar para esta solicitud. Para obtener más información sobre los valores predeterminados de la directiva de reintentos, vea setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory).

Returns:

Objeto RetryPolicyFactory que representa la directiva de reintento actual.

getTimeoutIntervalInMs

public final Integer getTimeoutIntervalInMs()

Devuelve el valor de tiempo de espera de esta solicitud. Para obtener más información sobre los valores predeterminados de tiempo de espera, vea setTimeoutIntervalInMs(final Integer timeoutIntervalInMs).

Returns:

Valor de tiempo de espera actual, en milisegundos, para esta solicitud.

populateRequestOptions

protected static void populateRequestOptions(RequestOptions modifiedOptions, final RequestOptions clientOptions, final boolean setStartTime)

Rellena los campos NULL del primer objeto requestOptions con valores del segundo objeto requestOptions.

Parameters:

modifiedOptions

clientOptions

setStartTime

requireEncryption

public Boolean requireEncryption()

Obtiene un valor para indicar si todos los datos escritos y leídos deben cifrarse. Se usa para cifrar o descifrar datos para transacciones; Lo contrario. Para obtener más información sobre los valores predeterminados de cifrado, vea setRequireEncryption(Boolean requireEncryption).

Returns:

Valor que indica si todos los datos escritos y leídos deben cifrarse.

setDisableHttpsSocketKeepAlive

public void setDisableHttpsSocketKeepAlive(Boolean disableHttpsSocketKeepAlive)

Establece un valor para indicar si el socket https keep-alive debe deshabilitarse. Use para deshabilitar keep-alive; Lo contrario

El valor predeterminado se establece en el cliente y es true de forma predeterminada, lo que indica que el socket https keep-alive se deshabilitará. Puede cambiar el valor de esta solicitud estableciendo esta propiedad. También puede cambiar el valor en en el getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen el valor adecuado.

Establecer keep-alive en sockets https es solucionar un error en la JVM donde no se respetan los tiempos de espera de conexión en las solicitudes de reintentación. En esos casos, puede optar por usar socket keep-alive como reserva. Desafortunadamente, el valor de tiempo de espera debe tomarse de una propiedad JVM en lugar de configurarse localmente. Por lo tanto, en raras ocasiones, la JVM ha configurado tiempos de mantenimiento dinámicos agresivamente cortos, puede que no sea beneficioso habilitar el uso de keep-alives para que interfieran con operaciones de transferencia de datos de larga duración.

Parameters:

disableHttpsSocketKeepAlive - Valor que indica si el socket https keep-alive debe estar deshabilitado.

setLocationMode

public void setLocationMode(final LocationMode locationMode)

Establece para LocationMode esta solicitud.

El valor predeterminado LocationMode se establece en el cliente y es de forma predeterminada PRIMARY_ONLY. Puede cambiar en LocationMode esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese LocationMode.

Parameters:

locationMode - locationMode que se va a establecer

setMaximumExecutionTimeInMs

public void setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs)

Establece el tiempo de ejecución máximo que se usará al realizar esta solicitud.

El intervalo de tiempo de ejecución máximo comienza en el momento en que el cliente comienza a compilar la solicitud. El tiempo máximo de ejecución se comprueba de forma intermitente mientras se cargan datos, se descargan datos y antes de ejecutar reintentos. El servicio seguirá cargando, descargando y reintentando hasta que se alcance el tiempo máximo de ejecución. En ese momento, se cancelarán las cargas o descargas parciales y se producirá una excepción.

La ejecución máxima predeterminada se establece en el cliente y es null de forma predeterminada, lo que indica que no hay tiempo máximo. Puede cambiar el tiempo máximo de ejecución en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen el tiempo de ejecución máximo.

Parameters:

maximumExecutionTimeInMs - Tiempo de ejecución máximo, en milisegundos, que se usará para esta solicitud.

setRequireEncryption

public void setRequireEncryption(Boolean requireEncryption)

Establece un valor para indicar si todos los datos escritos y leídos deben cifrarse. Se usa para cifrar o descifrar datos para transacciones; Lo contrario.

El valor predeterminado se establece en el cliente y es false de forma predeterminada, lo que indica que el cifrado no es necesario. Puede cambiar el valor de esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen el valor adecuado.

Parameters:

requireEncryption - Valor que indica si todos los datos escritos y leídos deben cifrarse.

setRetryPolicyFactory

public final void setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory)

Establece el objeto RetryPolicyFactory que se va a usar para esta solicitud.

RetryPolicyFactory predeterminado se establece en el cliente y es de forma predeterminada RetryExponentialRetry. Puede cambiar RetryPolicyFactory en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen retryPolicyFactory.

Parameters:

retryPolicyFactory - el objeto RetryPolicyFactory que se va a usar al realizar solicitudes de servicio.

setTimeoutIntervalInMs

public final void setTimeoutIntervalInMs(final Integer timeoutIntervalInMs)

Establece el tiempo de espera que se usará al realizar esta solicitud.

El intervalo de tiempo de espera del servidor comienza en el momento en que el servicio ha recibido la solicitud completa y el servidor comienza a procesar la respuesta. Si el intervalo de tiempo de espera transcurre antes de que se devuelva la respuesta al cliente, se agota el tiempo de espera de la operación. El intervalo de tiempo de espera se restablece con cada reintento, si se reintenta la solicitud.

El tiempo de espera predeterminado del servidor se establece en el cliente y es null de forma predeterminada, lo que indica que no se ha agotado el tiempo de espera del servidor. Puede cambiar el tiempo de espera del servidor en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese tiempo de espera del servidor.

Parameters:

timeoutIntervalInMs - Tiempo de espera, en milisegundos, que se usará para esta solicitud.