StorageRequest<C,P,R> Clase

Paquete:

com.microsoft.azure.storage.core

• java.lang.Object
• • com.microsoft.azure.storage.core.StorageRequest<C,P,R>

Parámetros de tipo

C

Tipo de cliente de servicio

P

Tipo del objeto primario, es decir, CloudBlobContainer para downloadAttributes, etc.

R

El tipo del resultado esperado

public class StorageRequest<C,P,R>

RESERVADO PARA USO INTERNO. Clase que encapsula la ejecución de una operación de almacenamiento determinada.

Resumen del constructor

Constructor	Description
StorageRequest()	Ctor predeterminado.
StorageRequest(final RequestOptions options, StorageUri storageUri)	Inicializa una nueva instancia de la clase StorageRequest.

Resumen del método

Modificador y tipo	Método y descripción
void	applyLocationModeToRequest()
abstract HttpURLConnection	buildRequest(C client, P parentObject, OperationContext context) Función para construir la solicitud.
boolean	getArePropertiesPopulated()
final HttpURLConnection	getConnection()
final String	getContentMD5()
StreamMd5AndLength	getCurrentDescriptor()
StorageLocation	getCurrentLocation()
long	getCurrentRequestByteCount()
AccessCondition	getETagLockCondition()
final StorageException	getException()
Long	getLength()
LocationMode	getLocationMode()
final String	getLockedETag()
Long	getOffset()
RequestLocationMode	getRequestLocationMode()
final RequestOptions	getRequestOptions()
final RequestResult	getResult()
final InputStream	getSendStream()
StorageUri	getStorageUri()
final void	initialize(OperationContext opContext) Restablece las marcas de estado de la operación entre las operaciones.
void	initializeLocation()
final boolean	isNonExceptionedRetryableFailure()
boolean	isSent()
final StorageException	materializeException(final OperationContext opContext) Devuelve la excepción mantenida de la operación si se establece; de lo contrario, la excepción traducida.
StorageExtendedErrorInformation	parseErrorDetails() Devuelve información de error extendida para esta solicitud.
R	postProcessResponse(HttpURLConnection connection, P parentObject, C client, OperationContext context, R storageObject) Función Post-Stream Retrieval.
abstract R	preProcessResponse(P parentObject, C client, OperationContext context) Función Pre-Stream Retrieval.
void	recoveryAction(OperationContext context) Acción de recuperación para reintentos.
void	setArePropertiesPopulated(boolean arePropertiesPopulated)
final void	setConnection(final HttpURLConnection connection)
void	setContentMD5(String contentMD5)
void	setCurrentDescriptor(StreamMd5AndLength currentDescriptor)
void	setCurrentLocation(StorageLocation currentLocation)
void	setCurrentRequestByteCount(long currentRequestByteCount)
void	setETagLockCondition(AccessCondition etagLockCondition)
final void	setException(final StorageException exceptionReference)
void	setHeaders(HttpURLConnection connection, P parentObject, OperationContext context) Función para establecer encabezados personalizados.
void	setIsSent(boolean isSent)
void	setLength(Long length)
void	setLocationMode(LocationMode locationMode)
void	setLockedETag(String lockedETag)
final void	setNonExceptionedRetryableFailure(final boolean nonExceptionedRetryableFailure)
void	setOffset(Long offset)
void	setRequestLocationMode() Función para aplicar el modo de ubicación a la solicitud.
void	setRequestLocationMode(RequestLocationMode requestLocationMode)
final void	setRequestOptions(final RequestOptions requestOptions)
final void	setResult(final RequestResult result)
void	setSendStream(InputStream sendStream)
void	setStorageUri(StorageUri storageUri)
final String	signBlobQueueAndFileRequest(HttpURLConnection request, ServiceClient client, long contentLength, OperationContext context)
abstract void	signRequest(HttpURLConnection connection, C client, OperationContext context) Función para firmar encabezados.
final void	signTableRequest(HttpURLConnection request, ServiceClient client, long contentLength, OperationContext context)
void	validateLocation()
void	validateStreamWrite(StreamMd5AndLength descriptor) Valide la longitud de la secuencia escrita cuando se proporcione la longitud.

Detalles del constructor

StorageRequest

protected StorageRequest()

Ctor predeterminado.

StorageRequest

public StorageRequest(final RequestOptions options, StorageUri storageUri)

Inicializa una nueva instancia de la clase StorageRequest.

Parameters:

options - RequestOptions que se va a usar

storageUri

Detalles del método

applyLocationModeToRequest

public void applyLocationModeToRequest()

buildRequest

public abstract HttpURLConnection buildRequest(C client, P parentObject, OperationContext context)

Función para construir la solicitud.

Parameters:

client

parentObject - Objeto primario, es decir, CloudBlobContainer para downloadAttributes, etc.

context - Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

Returns:

httpURLConnection configurado para la operación.

Throws:

Exception

getArePropertiesPopulated

public boolean getArePropertiesPopulated()

Returns:

el valor arePropertiesPopulated

getConnection

public final HttpURLConnection getConnection()

Returns:

la conexión URL

getContentMD5

public final String getContentMD5()

Returns:

ContentMD5

getCurrentDescriptor

protected StreamMd5AndLength getCurrentDescriptor()

Returns:

descriptor actual que contiene la longitud de la secuencia y el hash MD5.

getCurrentLocation

public StorageLocation getCurrentLocation()

Returns:

la ubicación actual a la que se enviará la solicitud.

getCurrentRequestByteCount

public long getCurrentRequestByteCount()

Returns:

currentRequestByteCount

getETagLockCondition

public AccessCondition getETagLockCondition()

Returns:

la condición ETag bloqueada

getException

public final StorageException getException()

Returns:

la excepción

getLength

public Long getLength()

Returns:

longitud, en bytes, de la secuencia

getLocationMode

public LocationMode getLocationMode()

Returns:

el modo de ubicación utilizado para decidir a qué ubicación se debe enviar la solicitud.

getLockedETag

public final String getLockedETag()

Returns:

la etiqueta ETag bloqueada

getOffset

public Long getOffset()

Returns:

desplazamiento desde el que se va a empezar a leer

getRequestLocationMode

public RequestLocationMode getRequestLocationMode()

Returns:

el modo de ubicación utilizado para decidir a qué ubicación se debe enviar la solicitud.

getRequestOptions

public final RequestOptions getRequestOptions()

Returns:

requestOptions

getResult

public final RequestResult getResult()

Returns:

el resultado

getSendStream

public final InputStream getSendStream()

Returns:

secuencia que se va a enviar al servidor

getStorageUri

public StorageUri getStorageUri()

Returns:

el URI al que se enviará la solicitud.

initialize

protected final void initialize(OperationContext opContext)

Restablece las marcas de estado de la operación entre las operaciones.

Parameters:

opContext

initializeLocation

public void initializeLocation()

isNonExceptionedRetryableFailure

public final boolean isNonExceptionedRetryableFailure()

Returns:

nonExceptionedRetryableFailure

isSent

protected boolean isSent()

Returns:

el valor isSent

materializeException

protected final StorageException materializeException(final OperationContext opContext)

Devuelve la excepción mantenida de la operación si se establece; de lo contrario, la excepción traducida.

Parameters:

opContext - un objeto utilizado para realizar un seguimiento de la ejecución de la operación

Returns:

excepción que se va a producir.

parseErrorDetails

public StorageExtendedErrorInformation parseErrorDetails()

Devuelve información de error extendida para esta solicitud.

Returns:

Objeto StorageExtendedErrorInformation que representa los detalles del error de la solicitud especificada.

postProcessResponse

public R postProcessResponse(HttpURLConnection connection, P parentObject, C client, OperationContext context, R storageObject)

Función Post-Stream Retrieval.

Parameters:

connection - HttpURLConnection configurado para la operación.

parentObject

client

context

storageObject - Objeto del tipo de resultado esperado.

Returns:

el resultado esperado de la operación.

Throws:

Exception

preProcessResponse

public abstract R preProcessResponse(P parentObject, C client, OperationContext context)

Función Pre-Stream Retrieval.

Parameters:

parentObject - Objeto primario, es decir, CloudBlobContainer para downloadAttributes, etc.

client - El cliente de servicio.

context - Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

Returns:

un objeto del tipo del resultado esperado.

Throws:

Exception

recoveryAction

public void recoveryAction(OperationContext context)

Acción de recuperación para reintentos.

Parameters:

context

Throws:

IOException

setArePropertiesPopulated

public void setArePropertiesPopulated(boolean arePropertiesPopulated)

Parameters:

arePropertiesPopulated - el valor arePropertiesPopulated

setConnection

public final void setConnection(final HttpURLConnection connection)

Parameters:

connection - la conexión que se va a establecer

setContentMD5

public void setContentMD5(String contentMD5)

Parameters:

contentMD5 - contentMD5

setCurrentDescriptor

protected void setCurrentDescriptor(StreamMd5AndLength currentDescriptor)

Parameters:

currentDescriptor - el valor del descriptor

setCurrentLocation

public void setCurrentLocation(StorageLocation currentLocation)

Parameters:

currentLocation - el valor currentLocation

setCurrentRequestByteCount

public void setCurrentRequestByteCount(long currentRequestByteCount)

Parameters:

currentRequestByteCount - currentRequestByteCount que se va a establecer

setETagLockCondition

public void setETagLockCondition(AccessCondition etagLockCondition)

Parameters:

etagLockCondition - la condición ETag bloqueada

setException

protected final void setException(final StorageException exceptionReference)

Parameters:

exceptionReference - excepción que se va a establecer

setHeaders

public void setHeaders(HttpURLConnection connection, P parentObject, OperationContext context)

Función para establecer encabezados personalizados.

Parameters:

connection - HttpURLConnection configurado para la operación.

parentObject - Objeto primario, es decir, CloudBlobContainer para downloadAttributes, etc.

context - Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

setIsSent

protected void setIsSent(boolean isSent)

Parameters:

isSent - el valor isSent

setLength

public void setLength(Long length)

Parameters:

length - longitud, en bytes, de la secuencia

setLocationMode

public void setLocationMode(LocationMode locationMode)

Parameters:

locationMode - el valor locationMode

setLockedETag

public void setLockedETag(String lockedETag)

Parameters:

lockedETag - la etiqueta ETag bloqueada

setNonExceptionedRetryableFailure

public final void setNonExceptionedRetryableFailure(final boolean nonExceptionedRetryableFailure)

Parameters:

nonExceptionedRetryableFailure - nonExceptionedRetryableFailure que se va a establecer

setOffset

public void setOffset(Long offset)

Parameters:

offset - desplazamiento de secuencia desde el que se va a empezar a copiar

setRequestLocationMode

public void setRequestLocationMode()

Función para aplicar el modo de ubicación a la solicitud.

setRequestLocationMode

public void setRequestLocationMode(RequestLocationMode requestLocationMode)

Parameters:

requestLocationMode - el valor requestLocationMode

setRequestOptions

protected final void setRequestOptions(final RequestOptions requestOptions)

Parameters:

requestOptions - requestOptions que se va a establecer

setResult

public final void setResult(final RequestResult result)

Parameters:

result - el resultado que se va a establecer

setSendStream

public void setSendStream(InputStream sendStream)

Parameters:

sendStream - secuencia que se va a enviar al servidor

setStorageUri

public void setStorageUri(StorageUri storageUri)

Parameters:

storageUri - el valor storageUri

signBlobQueueAndFileRequest

public static final String signBlobQueueAndFileRequest(HttpURLConnection request, ServiceClient client, long contentLength, OperationContext context)

Parameters:

request

client

contentLength

context

signRequest

public abstract void signRequest(HttpURLConnection connection, C client, OperationContext context)

Función para firmar encabezados.

Parameters:

connection - HttpURLConnection configurado para la operación.

client - El cliente de servicio.

context - Objeto OperationContext que representa el contexto para la operación actual. Este objeto se utiliza para hacer un seguimiento de las solicitudes al servicio de almacenamiento y para proporcionar información adicional en tiempo de ejecución sobre la operación.

Throws:

Exception

signTableRequest

public static final void signTableRequest(HttpURLConnection request, ServiceClient client, long contentLength, OperationContext context)

Parameters:

request

client

contentLength

context

validateLocation

public void validateLocation()

validateStreamWrite

public void validateStreamWrite(StreamMd5AndLength descriptor)

Valide la longitud de la secuencia escrita cuando se proporcione la longitud.

Parameters:

descriptor

Throws:

StorageException