StorageRequest<C,P,R> Klasse

Paket:

com.microsoft.azure.storage.core

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

Typparameter

C

Der Dienstclienttyp

P

Der Typ des übergeordneten Objekts, d. h. CloudBlobContainer für downloadAttributes usw.

R

Der Typ des erwarteten Ergebnisses

public class StorageRequest<C,P,R>

RESERVIERT FÜR DIE INTERNE VERWENDUNG. Eine Klasse, die die Ausführung eines bestimmten Speichervorgangs kapselt.

Zusammenfassung zum Konstruktor

Konstruktor	Beschreibung
StorageRequest()	Standard-Ctor.
StorageRequest(final RequestOptions options, StorageUri storageUri)	Initialisiert eine neue instance der StorageRequest-Klasse.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
void	applyLocationModeToRequest()
abstract HttpURLConnection	buildRequest(C client, P parentObject, OperationContext context) Funktion zum Erstellen der Anforderung.
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) Setzt den Vorgang status Flags zwischen Vorgängen zurück.
void	initializeLocation()
final boolean	isNonExceptionedRetryableFailure()
boolean	isSent()
final StorageException	materializeException(final OperationContext opContext) Gibt entweder die gehaltene Ausnahme aus dem Vorgang zurück, wenn sie festgelegt ist, andernfalls die übersetzte Ausnahme.
StorageExtendedErrorInformation	parseErrorDetails() Gibt erweiterte Fehlerinformationen für diese Anforderung zurück.
R	postProcessResponse(HttpURLConnection connection, P parentObject, C client, OperationContext context, R storageObject) Post-Stream Retrieval-Funktion.
abstract R	preProcessResponse(P parentObject, C client, OperationContext context) Pre-Stream Retrieval-Funktion.
void	recoveryAction(OperationContext context) Wiederherstellungsaktion für Wiederholungen.
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) Funktion zum Festlegen benutzerdefinierter Header.
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() Funktion zum Anwenden des Standortmodus auf die Anforderung.
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) Funktion zum Signieren von Headern.
final void	signTableRequest(HttpURLConnection request, ServiceClient client, long contentLength, OperationContext context)
void	validateLocation()
void	validateStreamWrite(StreamMd5AndLength descriptor) Überprüfen Sie die geschriebene Streamlänge, wenn die Länge angegeben wird.

Details zum Konstruktor

StorageRequest

protected StorageRequest()

Standard-Ctor.

StorageRequest

public StorageRequest(final RequestOptions options, StorageUri storageUri)

Initialisiert eine neue instance der StorageRequest-Klasse.

Parameters:

options - die zu verwendenden RequestOptions

storageUri

Details zur Methode

applyLocationModeToRequest

public void applyLocationModeToRequest()

buildRequest

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

Funktion zum Erstellen der Anforderung.

Parameters:

client

parentObject - Übergeordnetes Objekt, d. h. CloudBlobContainer für downloadAttributes usw.

context - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

eine httpURLConnection, die für den Vorgang konfiguriert ist.

Throws:

Exception

getArePropertiesPopulated

public boolean getArePropertiesPopulated()

Returns:

der wert arePropertiesPopulated

getConnection

public final HttpURLConnection getConnection()

Returns:

die URL-Verbindung

getContentMD5

public final String getContentMD5()

Returns:

ContentMD5

getCurrentDescriptor

protected StreamMd5AndLength getCurrentDescriptor()

Returns:

der aktuelle Deskriptor, der die Streamlänge und den MD5-Hash enthält.

getCurrentLocation

public StorageLocation getCurrentLocation()

Returns:

der aktuelle Speicherort, an den die Anforderung gesendet wird.

getCurrentRequestByteCount

public long getCurrentRequestByteCount()

Returns:

currentRequestByteCount

getETagLockCondition

public AccessCondition getETagLockCondition()

Returns:

die gesperrte ETag-Bedingung

getException

public final StorageException getException()

Returns:

die Ausnahme

getLength

public Long getLength()

Returns:

die Länge des Datenstroms in Bytes

getLocationMode

public LocationMode getLocationMode()

Returns:

der Standortmodus, der verwendet wird, um zu entscheiden, an welchen Speicherort die Anforderung gesendet werden soll.

getLockedETag

public final String getLockedETag()

Returns:

das gesperrte ETag

getOffset

public Long getOffset()

Returns:

der Offset, von dem gelesen werden soll

getRequestLocationMode

public RequestLocationMode getRequestLocationMode()

Returns:

der Standortmodus, der verwendet wird, um zu entscheiden, an welchen Speicherort die Anforderung gesendet werden soll.

getRequestOptions

public final RequestOptions getRequestOptions()

Returns:

requestOptions

getResult

public final RequestResult getResult()

Returns:

das Ergebnis

getSendStream

public final InputStream getSendStream()

Returns:

der Stream, der an den Server gesendet werden soll

getStorageUri

public StorageUri getStorageUri()

Returns:

der URI, an den die Anforderung gesendet wird.

initialize

protected final void initialize(OperationContext opContext)

Setzt den Vorgang status Flags zwischen Vorgängen zurück.

Parameters:

opContext

initializeLocation

public void initializeLocation()

isNonExceptionedRetryableFailure

public final boolean isNonExceptionedRetryableFailure()

Returns:

nonExceptionedRetryableFailure

isSent

protected boolean isSent()

Returns:

der isSent-Wert

materializeException

protected final StorageException materializeException(final OperationContext opContext)

Gibt entweder die gehaltene Ausnahme aus dem Vorgang zurück, wenn sie festgelegt ist, andernfalls die übersetzte Ausnahme.

Parameters:

opContext - ein Objekt, das zum Nachverfolgen der Ausführung des Vorgangs verwendet wird

Returns:

die ausnahme, die ausgelöst werden soll.

parseErrorDetails

public StorageExtendedErrorInformation parseErrorDetails()

Gibt erweiterte Fehlerinformationen für diese Anforderung zurück.

Returns:

Ein StorageExtendedErrorInformation -Objekt, das die Fehlerdetails für die angegebene Anforderung darstellt.

postProcessResponse

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

Post-Stream Retrieval-Funktion.

Parameters:

connection - HttpURLConnection wurde für den Vorgang konfiguriert.

parentObject

client

context

storageObject - Ein Objekt des Typs des erwarteten Ergebnisses.

Returns:

das erwartete Ergebnis des Vorgangs.

Throws:

Exception

preProcessResponse

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

Pre-Stream Retrieval-Funktion.

Parameters:

parentObject - Übergeordnetes Objekt, d. h. CloudBlobContainer für downloadAttributes usw.

client - Der Dienstclient.

context - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

Returns:

ein Objekt des Typs des erwarteten Ergebnisses.

Throws:

Exception

recoveryAction

public void recoveryAction(OperationContext context)

Wiederherstellungsaktion für Wiederholungen.

Parameters:

context

Throws:

IOException

setArePropertiesPopulated

public void setArePropertiesPopulated(boolean arePropertiesPopulated)

Parameters:

arePropertiesPopulated - der wert arePropertiesPopulated

setConnection

public final void setConnection(final HttpURLConnection connection)

Parameters:

connection - die festzulegende Verbindung

setContentMD5

public void setContentMD5(String contentMD5)

Parameters:

contentMD5 - contentMD5

setCurrentDescriptor

protected void setCurrentDescriptor(StreamMd5AndLength currentDescriptor)

Parameters:

currentDescriptor - der Deskriptorwert

setCurrentLocation

public void setCurrentLocation(StorageLocation currentLocation)

Parameters:

currentLocation - der currentLocation-Wert

setCurrentRequestByteCount

public void setCurrentRequestByteCount(long currentRequestByteCount)

Parameters:

currentRequestByteCount - die festzulegende currentRequestByteCount

setETagLockCondition

public void setETagLockCondition(AccessCondition etagLockCondition)

Parameters:

etagLockCondition - die gesperrte ETag-Bedingung

setException

protected final void setException(final StorageException exceptionReference)

Parameters:

exceptionReference - die festzulegende Ausnahme

setHeaders

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

Funktion zum Festlegen benutzerdefinierter Header.

Parameters:

connection - HttpURLConnection wurde für den Vorgang konfiguriert.

parentObject - Übergeordnetes Objekt, d. h. CloudBlobContainer für downloadAttributes usw.

context - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

setIsSent

protected void setIsSent(boolean isSent)

Parameters:

isSent - der isSent-Wert

setLength

public void setLength(Long length)

Parameters:

length - die Länge des Datenstroms in Bytes

setLocationMode

public void setLocationMode(LocationMode locationMode)

Parameters:

locationMode - der LocationMode-Wert

setLockedETag

public void setLockedETag(String lockedETag)

Parameters:

lockedETag - das gesperrte ETag

setNonExceptionedRetryableFailure

public final void setNonExceptionedRetryableFailure(final boolean nonExceptionedRetryableFailure)

Parameters:

nonExceptionedRetryableFailure - die festzulegende nonExceptionedRetryableFailure

setOffset

public void setOffset(Long offset)

Parameters:

offset - der Streamoffset, aus dem das Kopieren gestartet werden soll

setRequestLocationMode

public void setRequestLocationMode()

Funktion zum Anwenden des Standortmodus auf die Anforderung.

setRequestLocationMode

public void setRequestLocationMode(RequestLocationMode requestLocationMode)

Parameters:

requestLocationMode - der RequestLocationMode-Wert

setRequestOptions

protected final void setRequestOptions(final RequestOptions requestOptions)

Parameters:

requestOptions - die festzulegenden requestOptions

setResult

public final void setResult(final RequestResult result)

Parameters:

result - das festzulegende Ergebnis

setSendStream

public void setSendStream(InputStream sendStream)

Parameters:

sendStream - der Stream, der an den Server gesendet werden soll

setStorageUri

public void setStorageUri(StorageUri storageUri)

Parameters:

storageUri - der wert 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)

Funktion zum Signieren von Headern.

Parameters:

connection - HttpURLConnection wurde für den Vorgang konfiguriert.

client - Der Dienstclient.

context - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt. Dieses Objekt wird verwendet, um an den Speicherdienst gerichtete Anforderungen nachzuverfolgen und um zusätzliche Laufzeitinformationen zum Vorgang bereitzustellen.

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)

Überprüfen Sie die geschriebene Streamlänge, wenn die Länge angegeben wird.

Parameters:

descriptor

Throws:

StorageException