Partager via


StorageRequest<C,P,R> Classe

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

Paramètres de type

C

Type de client de service

P

Type de l’objet parent, c’est-à-dire CloudBlobContainer pour downloadAttributes, etc.

R

Type du résultat attendu

public class StorageRequest<C,P,R>

RÉSERVÉ À UN USAGE INTERNE. Classe qui encapsule l’exécution d’une opération de stockage donnée.

Récapitulatif du constructeur

Constructeur Description
StorageRequest()

Ctor par défaut.

StorageRequest(final RequestOptions options, StorageUri storageUri)

Initialise une nouvelle instance de la classe StorageRequest.

Résumé de la méthode

Modificateur et type Méthode et description
void applyLocationModeToRequest()
abstract HttpURLConnection buildRequest(C client, P parentObject, OperationContext context)

Fonction pour construire la requête.

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)

Réinitialise l’opération status indicateurs entre les opérations.

void initializeLocation()
final boolean isNonExceptionedRetryableFailure()
boolean isSent()
final StorageException materializeException(final OperationContext opContext)

Retourne l’exception conservée de l’opération si elle est définie, sinon l’exception traduite.

StorageExtendedErrorInformation parseErrorDetails()

Retourne des informations d’erreur étendues pour cette demande.

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

Fonction post-récupération de flux.

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

Fonction pré-récupération de flux.

void recoveryAction(OperationContext context)

Action de récupération pour les nouvelles tentatives.

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)

Fonction pour définir des en-têtes personnalisés.

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

Fonction pour appliquer le mode d’emplacement à la requête.

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)

Fonction pour signer les en-têtes.

final void signTableRequest(HttpURLConnection request, ServiceClient client, long contentLength, OperationContext context)
void validateLocation()
void validateStreamWrite(StreamMd5AndLength descriptor)

Validez la longueur du flux écrit lorsque la longueur est fournie.

Détails du constructeur

StorageRequest

protected StorageRequest()

Ctor par défaut.

StorageRequest

public StorageRequest(final RequestOptions options, StorageUri storageUri)

Initialise une nouvelle instance de la classe StorageRequest.

Parameters:

options - RequestOptions à utiliser
storageUri

Détails de la méthode

applyLocationModeToRequest

public void applyLocationModeToRequest()

buildRequest

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

Fonction pour construire la requête.

Parameters:

client
parentObject - Objet parent, c’est-à-dire CloudBlobContainer pour downloadAttributes, etc.
context - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

HttpURLConnection configuré pour l’opération.

Throws:

Exception

getArePropertiesPopulated

public boolean getArePropertiesPopulated()

Returns:

valeur arePropertiesPopulated

getConnection

public final HttpURLConnection getConnection()

Returns:

connexion d’URL

getContentMD5

public final String getContentMD5()

Returns:

ContentMD5

getCurrentDescriptor

protected StreamMd5AndLength getCurrentDescriptor()

Returns:

descripteur actuel qui contient la longueur du flux et le hachage MD5.

getCurrentLocation

public StorageLocation getCurrentLocation()

Returns:

emplacement actuel auquel la demande sera envoyée.

getCurrentRequestByteCount

public long getCurrentRequestByteCount()

Returns:

currentRequestByteCount

getETagLockCondition

public AccessCondition getETagLockCondition()

Returns:

condition ETag verrouillée

getException

public final StorageException getException()

Returns:

l’exception

getLength

public Long getLength()

Returns:

longueur, en octets, du flux

getLocationMode

public LocationMode getLocationMode()

Returns:

mode d’emplacement utilisé pour décider de l’emplacement vers lequel la demande doit être envoyée.

getLockedETag

public final String getLockedETag()

Returns:

L’ETag verrouillé

getOffset

public Long getOffset()

Returns:

décalage à partir duquel commencer la lecture

getRequestLocationMode

public RequestLocationMode getRequestLocationMode()

Returns:

mode d’emplacement utilisé pour décider de l’emplacement vers lequel la demande doit être envoyée.

getRequestOptions

public final RequestOptions getRequestOptions()

Returns:

requestOptions

getResult

public final RequestResult getResult()

Returns:

le résultat

getSendStream

public final InputStream getSendStream()

Returns:

flux à envoyer au serveur

getStorageUri

public StorageUri getStorageUri()

Returns:

URI auquel la demande sera envoyée.

initialize

protected final void initialize(OperationContext opContext)

Réinitialise l’opération status indicateurs entre les opérations.

Parameters:

opContext

initializeLocation

public void initializeLocation()

isNonExceptionedRetryableFailure

public final boolean isNonExceptionedRetryableFailure()

Returns:

nonExceptionedRetryableFailure

isSent

protected boolean isSent()

Returns:

valeur isSent

materializeException

protected final StorageException materializeException(final OperationContext opContext)

Retourne l’exception conservée de l’opération si elle est définie, sinon l’exception traduite.

Parameters:

opContext - objet utilisé pour suivre l’exécution de l’opération

Returns:

exception à lever.

parseErrorDetails

public StorageExtendedErrorInformation parseErrorDetails()

Retourne des informations d’erreur étendues pour cette demande.

Returns:

Objet StorageExtendedErrorInformation qui représente les détails de l’erreur pour la requête spécifiée.

postProcessResponse

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

Fonction post-récupération de flux.

Parameters:

connection - HttpURLConnection configuré pour l’opération.
parentObject
client
context
storageObject - Objet du type du résultat attendu.

Returns:

résultat attendu de l’opération.

Throws:

Exception

preProcessResponse

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

Fonction pré-récupération de flux.

Parameters:

parentObject - Objet parent, c’est-à-dire CloudBlobContainer pour downloadAttributes, etc.
client - Client de service.
context - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

objet du type du résultat attendu.

Throws:

Exception

recoveryAction

public void recoveryAction(OperationContext context)

Action de récupération pour les nouvelles tentatives.

Parameters:

context

Throws:

IOException

setArePropertiesPopulated

public void setArePropertiesPopulated(boolean arePropertiesPopulated)

Parameters:

arePropertiesPopulated - valeur arePropertiesPopulated

setConnection

public final void setConnection(final HttpURLConnection connection)

Parameters:

connection - la connexion à définir

setContentMD5

public void setContentMD5(String contentMD5)

Parameters:

contentMD5 - contentMD5

setCurrentDescriptor

protected void setCurrentDescriptor(StreamMd5AndLength currentDescriptor)

Parameters:

currentDescriptor - valeur de descripteur

setCurrentLocation

public void setCurrentLocation(StorageLocation currentLocation)

Parameters:

currentLocation - valeur currentLocation

setCurrentRequestByteCount

public void setCurrentRequestByteCount(long currentRequestByteCount)

Parameters:

currentRequestByteCount - currentRequestByteCount à définir

setETagLockCondition

public void setETagLockCondition(AccessCondition etagLockCondition)

Parameters:

etagLockCondition - condition ETag verrouillée

setException

protected final void setException(final StorageException exceptionReference)

Parameters:

exceptionReference - l’exception à définir

setHeaders

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

Fonction pour définir des en-têtes personnalisés.

Parameters:

connection - HttpURLConnection configuré pour l’opération.
parentObject - Objet parent, c’est-à-dire CloudBlobContainer pour downloadAttributes, etc.
context - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

setIsSent

protected void setIsSent(boolean isSent)

Parameters:

isSent - valeur isSent

setLength

public void setLength(Long length)

Parameters:

length - longueur, en octets, du flux

setLocationMode

public void setLocationMode(LocationMode locationMode)

Parameters:

locationMode - valeur locationMode

setLockedETag

public void setLockedETag(String lockedETag)

Parameters:

lockedETag - L’ETag verrouillé

setNonExceptionedRetryableFailure

public final void setNonExceptionedRetryableFailure(final boolean nonExceptionedRetryableFailure)

Parameters:

nonExceptionedRetryableFailure - nonExceptionedRetryableFailure à définir

setOffset

public void setOffset(Long offset)

Parameters:

offset - décalage de flux à partir duquel commencer la copie

setRequestLocationMode

public void setRequestLocationMode()

Fonction pour appliquer le mode d’emplacement à la requête.

setRequestLocationMode

public void setRequestLocationMode(RequestLocationMode requestLocationMode)

Parameters:

requestLocationMode - la valeur requestLocationMode

setRequestOptions

protected final void setRequestOptions(final RequestOptions requestOptions)

Parameters:

requestOptions - requestOptions à définir

setResult

public final void setResult(final RequestResult result)

Parameters:

result - le résultat à définir

setSendStream

public void setSendStream(InputStream sendStream)

Parameters:

sendStream - flux à envoyer au serveur

setStorageUri

public void setStorageUri(StorageUri storageUri)

Parameters:

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

Fonction pour signer les en-têtes.

Parameters:

connection - HttpURLConnection configuré pour l’opération.
client - Client de service.
context - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

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)

Validez la longueur du flux écrit lorsque la longueur est fournie.

Parameters:

descriptor

Throws:

StorageException

S’applique à