StorageRequest<C,P,R> Classe

Pacote:

com.microsoft.azure.storage.core

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

Parâmetros de tipo

C

O tipo de cliente de serviço

P

O tipo do objeto pai, ou seja, CloudBlobContainer para downloadAttributes etc.

R

O tipo do resultado esperado

public class StorageRequest<C,P,R>

RESERVADO PARA USO INTERNO. Uma classe que encapsula a execução de uma determinada operação de armazenamento.

Resumo do Construtor

Construtor	Description
StorageRequest()	Ctor padrão.
StorageRequest(final RequestOptions options, StorageUri storageUri)	Inicializa uma nova instância da classe StorageRequest.

Resumo do método

Modificador e tipo	Método e descrição
void	applyLocationModeToRequest()
abstract HttpURLConnection	buildRequest(C client, P parentObject, OperationContext context) Função para construir a solicitação.
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) Redefine a operação status sinalizadores entre as operações.
void	initializeLocation()
final boolean	isNonExceptionedRetryableFailure()
boolean	isSent()
final StorageException	materializeException(final OperationContext opContext) Retorna a exceção mantida da operação se ela estiver definida, caso contrário, a exceção traduzida.
StorageExtendedErrorInformation	parseErrorDetails() Retorna informações de erro estendidas para essa solicitação.
R	postProcessResponse(HttpURLConnection connection, P parentObject, C client, OperationContext context, R storageObject) Função recuperação pós-fluxo.
abstract R	preProcessResponse(P parentObject, C client, OperationContext context) Função de recuperação de pré-fluxo.
void	recoveryAction(OperationContext context) Ação de recuperação para novas tentativas.
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) Função para definir cabeçalhos 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() Função para aplicar o modo de localização à solicitação.
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) Função para Cabeçalhos de sinal.
final void	signTableRequest(HttpURLConnection request, ServiceClient client, long contentLength, OperationContext context)
void	validateLocation()
void	validateStreamWrite(StreamMd5AndLength descriptor) Valide o comprimento do fluxo gravado quando o comprimento for fornecido.

Detalhes do construtor

StorageRequest

protected StorageRequest()

Ctor padrão.

StorageRequest

public StorageRequest(final RequestOptions options, StorageUri storageUri)

Inicializa uma nova instância da classe StorageRequest.

Parameters:

options - o RequestOptions a ser usado

storageUri

Detalhes do método

applyLocationModeToRequest

public void applyLocationModeToRequest()

buildRequest

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

Função para construir a solicitação.

Parameters:

client

parentObject - Objeto pai, ou seja, CloudBlobContainer para downloadAttributes etc.

context - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

um HttpURLConnection configurado para a operação.

Throws:

Exception

getArePropertiesPopulated

public boolean getArePropertiesPopulated()

Returns:

o valor arePropertiesPopulated

getConnection

public final HttpURLConnection getConnection()

Returns:

a conexão de URL

getContentMD5

public final String getContentMD5()

Returns:

o ContentMD5

getCurrentDescriptor

protected StreamMd5AndLength getCurrentDescriptor()

Returns:

o descritor atual que contém o comprimento do fluxo e o hash MD5.

getCurrentLocation

public StorageLocation getCurrentLocation()

Returns:

o local atual para o qual a solicitação será enviada.

getCurrentRequestByteCount

public long getCurrentRequestByteCount()

Returns:

currentRequestByteCount

getETagLockCondition

public AccessCondition getETagLockCondition()

Returns:

a condição de ETag bloqueada

getException

public final StorageException getException()

Returns:

a exceção

getLength

public Long getLength()

Returns:

o comprimento, em bytes, do fluxo

getLocationMode

public LocationMode getLocationMode()

Returns:

o modo de localização usado para decidir para qual local a solicitação deve ser enviada.

getLockedETag

public final String getLockedETag()

Returns:

a ETag bloqueada

getOffset

public Long getOffset()

Returns:

o deslocamento do qual começar a ler

getRequestLocationMode

public RequestLocationMode getRequestLocationMode()

Returns:

o modo de localização usado para decidir para qual local a solicitação deve ser enviada.

getRequestOptions

public final RequestOptions getRequestOptions()

Returns:

requestOptions

getResult

public final RequestResult getResult()

Returns:

o resultado

getSendStream

public final InputStream getSendStream()

Returns:

o fluxo a ser enviado para o servidor

getStorageUri

public StorageUri getStorageUri()

Returns:

o URI para o qual a solicitação será enviada.

initialize

protected final void initialize(OperationContext opContext)

Redefine a operação status sinalizadores entre as operações.

Parameters:

opContext

initializeLocation

public void initializeLocation()

isNonExceptionedRetryableFailure

public final boolean isNonExceptionedRetryableFailure()

Returns:

o nonExceptionedRetryableFailure

isSent

protected boolean isSent()

Returns:

o valor isSent

materializeException

protected final StorageException materializeException(final OperationContext opContext)

Retorna a exceção mantida da operação se ela estiver definida, caso contrário, a exceção traduzida.

Parameters:

opContext - um objeto usado para acompanhar a execução da operação

Returns:

a exceção a ser lançada.

parseErrorDetails

public StorageExtendedErrorInformation parseErrorDetails()

Retorna informações de erro estendidas para essa solicitação.

Returns:

Um StorageExtendedErrorInformation objeto que representa os detalhes do erro para a solicitação especificada.

postProcessResponse

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

Função recuperação pós-fluxo.

Parameters:

connection - HttpURLConnection configurado para a operação.

parentObject

client

context

storageObject - Um objeto do tipo do resultado esperado.

Returns:

o resultado esperado da operação.

Throws:

Exception

preProcessResponse

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

Função de recuperação de pré-fluxo.

Parameters:

parentObject - Objeto pai, ou seja, CloudBlobContainer para downloadAttributes etc.

client - O cliente de serviço.

context - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

Returns:

um Objeto do tipo do resultado esperado.

Throws:

Exception

recoveryAction

public void recoveryAction(OperationContext context)

Ação de recuperação para novas tentativas.

Parameters:

context

Throws:

IOException

setArePropertiesPopulated

public void setArePropertiesPopulated(boolean arePropertiesPopulated)

Parameters:

arePropertiesPopulated - o valor arePropertiesPopulated

setConnection

public final void setConnection(final HttpURLConnection connection)

Parameters:

connection - a conexão a ser definida

setContentMD5

public void setContentMD5(String contentMD5)

Parameters:

contentMD5 - o contentMD5

setCurrentDescriptor

protected void setCurrentDescriptor(StreamMd5AndLength currentDescriptor)

Parameters:

currentDescriptor - o valor do descritor

setCurrentLocation

public void setCurrentLocation(StorageLocation currentLocation)

Parameters:

currentLocation - o valor currentLocation

setCurrentRequestByteCount

public void setCurrentRequestByteCount(long currentRequestByteCount)

Parameters:

currentRequestByteCount - o currentRequestByteCount a ser definido

setETagLockCondition

public void setETagLockCondition(AccessCondition etagLockCondition)

Parameters:

etagLockCondition - a condição de ETag bloqueada

setException

protected final void setException(final StorageException exceptionReference)

Parameters:

exceptionReference - a exceção a ser definida

setHeaders

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

Função para definir cabeçalhos personalizados.

Parameters:

connection - HttpURLConnection configurado para a operação.

parentObject - Objeto pai, ou seja, CloudBlobContainer para downloadAttributes etc.

context - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

setIsSent

protected void setIsSent(boolean isSent)

Parameters:

isSent - o valor isSent

setLength

public void setLength(Long length)

Parameters:

length - o comprimento, em bytes, do fluxo

setLocationMode

public void setLocationMode(LocationMode locationMode)

Parameters:

locationMode - o valor locationMode

setLockedETag

public void setLockedETag(String lockedETag)

Parameters:

lockedETag - a ETag bloqueada

setNonExceptionedRetryableFailure

public final void setNonExceptionedRetryableFailure(final boolean nonExceptionedRetryableFailure)

Parameters:

nonExceptionedRetryableFailure - o nonExceptionedRetryableFailure a ser definido

setOffset

public void setOffset(Long offset)

Parameters:

offset - o deslocamento de fluxo do qual começar a copiar

setRequestLocationMode

public void setRequestLocationMode()

Função para aplicar o modo de localização à solicitação.

setRequestLocationMode

public void setRequestLocationMode(RequestLocationMode requestLocationMode)

Parameters:

requestLocationMode - o valor requestLocationMode

setRequestOptions

protected final void setRequestOptions(final RequestOptions requestOptions)

Parameters:

requestOptions - o requestOptions a ser definido

setResult

public final void setResult(final RequestResult result)

Parameters:

result - o resultado a ser definido

setSendStream

public void setSendStream(InputStream sendStream)

Parameters:

sendStream - o fluxo a ser enviado para o servidor

setStorageUri

public void setStorageUri(StorageUri storageUri)

Parameters:

storageUri - o 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)

Função para Cabeçalhos de sinal.

Parameters:

connection - HttpURLConnection configurado para a operação.

client - O cliente de serviço.

context - Um objeto OperationContext que representa o contexto da operação atual. Esse objeto é usado para controlar solicitações para o serviço de armazenamento, e para fornecer informações adicionais de tempo de execução sobre a operação.

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 o comprimento do fluxo gravado quando o comprimento for fornecido.

Parameters:

descriptor

Throws:

StorageException