Utility Klasse

Referenz

Paket:: com.microsoft.azure.storage.core

java.lang.Object
- com.microsoft.azure.storage.core.Utility

public class Utility

RESERVIERT FÜR DEN INTERNEN GEBRAUCH. Eine Klasse, die Hilfsprogrammmethoden bereitstellt.

Feldzusammenfassung

Modifizierer und Typ	Feld und Beschreibung
final TimeZone	GMT_ZONE Speichert einen Verweis auf die GMT-Zeitzone.
final Locale	LOCALE_US Speichert einen Verweis auf das US-Gebietsschema.
final TimeZone	UTC_ZONE Speichert einen Verweis auf die UTC-Zeitzone.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
StreamMd5AndLength	analyzeStream(final InputStream sourceStream, long writeLength, long abandonLength, final boolean rewindSourceStream, final boolean calculateMD5) Bestimmt die Größe eines Eingabedatenstroms und berechnet optional den MD5-Hash für den Stream.
void	assertContinuationType(final ResultContinuation continuationToken, final ResultContinuationType continuationType) Bestätigt, dass ein Fortsetzungstoken vom angegebenen Typ ist.
void	assertGreaterThanOrEqual(final String param, final long value, final long min) Bestätigt, dass der angegebene Wert größer oder gleich dem min-Wert ist.
void	assertInBounds(final String param, final long value, final long min, final long max) Bestätigt, dass sich die angegebene ganze Zahl im gültigen Bereich befindet.
void	assertNotNull(final String param, final Object value) Bestätigt, dass ein Wert nicht ist.
void	assertNotNullOrEmpty(final String param, final String value) Bestätigt, dass die angegebene Zeichenfolge nicht oder leer ist.
byte []	binaryAppend(byte[] arr1, byte[] arr2) Fügt 2 Bytearrays an.
void	checkNullaryCtor(Class<?> clazzType)
XMLStreamWriter	createXMLStreamWriter(StringWriter outWriter) Gibt einen mit dem angegebenen zurück.
boolean	determinePathStyleFromUri(final URI baseURI) Gibt einen Wert zurück, der angibt, ob ein angegebener URI ein Pfad-URI ist.
long	encryptStreamIfUnderThreshold(final InputStream sourceStream, final ByteArrayOutputStream targetStream, Cipher cipher, long writeLength, long abandonLength) Verschlüsselt einen Eingabedatenstrom bis zu einer bestimmten Länge. Wird frühzeitig beendet, wenn die verschlüsselten Daten länger als die Abbruchlänge sind.
List<Integer>	findAllPatternOccurences(byte[] array, byte[] pattern) Scannt ein Bytearray auf alle Vorkommen eines Musters, ohne Dass sich die Vorkommensspannen überschneiden.
int	findPattern(byte[] array, byte[] pattern, int scanOffset) Scannt ein Bytearray auf das erste Vorkommen eines Musters, beginnend mit dem angegebenen Offset.
String	formatETag(final String etag) Liest Zeichendaten für das Etag-Element aus einem XML-Streamreader.
StorageException	generateNewUnexpectedStorageException(final Exception cause) Gibt eine unerwartete Speicher-Ausnahme zurück.
String	getGMTTime() Gibt die aktuelle GMT-Datums-/Uhrzeitzeichenfolge unter Verwendung des RFC1123-Musters zurück.
String	getGMTTime(final Date date) Gibt die GTM-Datums-/Uhrzeitzeichenfolge für den angegebenen Wert mithilfe des RFC1123-Musters zurück.
String	getJavaISO8601Time(Date date) Gibt die UTC-Datums-/Uhrzeitzeichenfolge für den angegebenen Wert unter Verwendung der Java-Version des ISO8601-Musters zurück, die auf die Genauigkeit in Millisekunden beschränkt ist.
JsonGenerator	getJsonGenerator(OutputStream outStream) Gibt einen mit dem angegebenen zurück.
JsonGenerator	getJsonGenerator(StringWriter strWriter) Gibt einen mit dem angegebenen zurück.
JsonParser	getJsonParser(final InputStream inStream) Gibt einen mit dem angegebenen zurück. Dieser JsonParser lässt nicht numerische Zahlen zu.
JsonParser	getJsonParser(final String jsonString) Gibt einen mit dem angegebenen zurück. Dieser JsonParser lässt nicht numerische Zahlen zu.
RequestLocationMode	getListingLocationMode(ResultContinuation token) Bestimmt, an welchem Speicherort das Listungsbefehlsziel verwendet werden kann, indem das Fortsetzungstoken betrachtet wird.
int	getRemainingTimeout(Long operationExpiryTimeInMs, Integer timeoutIntervalInMs) Gibt einen Wert zurück, der die verbleibende Zeit vor Ablauf des Vorgangs darstellt.
SAXParser	getSAXParser() Gibt einen Namespace zurück, der verwendet wird.
String	getStandardHeaderValue(final HttpURLConnection conn, final String headerName) Gibt den Standardheaderwert aus der angegebenen Verbindungsanforderung oder eine leere Zeichenfolge zurück, wenn für die Anforderung kein Headerwert angegeben wurde.
String	getUTCTimeOrEmpty(final Date value) Gibt das UTC-Datum/uhrzeit für den angegebenen Wert unter Verwendung des ISO8601-Musters zurück.
IOException	initIOException(final Exception ex) Erstellt eine instance der -Klasse unter Verwendung der angegebenen Ausnahme.
boolean	isNullOrEmpty(final String value) Gibt einen Wert zurück, der angibt, ob die angegebene Zeichenfolge leer ist.
boolean	isNullOrEmptyOrWhitespace(final String value) Gibt einen Wert zurück, der angibt, ob die angegebene Zeichenfolge leer oder leer ist.
void	logHttpError(StorageException ex, OperationContext opContext) Serialisiert die analysierte StorageException. Wenn eine Ausnahme gefunden wird, gibt eine leere Zeichenfolge zurück.
void	logHttpRequest(HttpURLConnection conn, OperationContext opContext) Protokolliert die HttpURLConnection-Anforderung. Wenn eine Ausnahme auftritt, werden keine Protokolle protokolliert.
void	logHttpResponse(HttpURLConnection conn, OperationContext opContext) Protokolliert die HttpURLConnection-Antwort. Wenn eine Ausnahme auftritt, werden keine Protokolle protokolliert.
HashMap<String, String>	parseAccountString(final String parseString) Analysiert eine Verbindungszeichenfolge und gibt ihre Werte als Hashzuordnung von Schlüssel-Wert-Paaren zurück.
Date	parseDate(String dateString) Bei einer Zeichenfolge, die ein Datum in einer Form des ISO8601 Musters darstellt, wird ein Date generiert, das es mit einer Genauigkeit von bis zu Millisekunden darstellt.
Date	parseDate(String dateString, boolean dateBackwardCompatibility) Bei einer Zeichenfolge, die ein Datum in einer Form des ISO8601 Musters darstellt, wird ein Date generiert, das es mit einer Genauigkeit von bis zu Millisekunden darstellt. Verwenden Sie parseDate(String dateString) stattdessen, es sei denn, dies ist erforderlich. Ausführlichere Informationen finden Sie hier.
Date	parseRFC1123DateFromStringInGMT(final String value) Gibt ein GMT-Datum für die angegebene Zeichenfolge im RFC1123-Muster zurück.
String	safeDecode(final String stringToDecode) Führt eine sichere Decodierung der angegebenen Zeichenfolge durch, wobei darauf geachtet wird, dass jedes Zeichen beibehalten wird, anstatt es durch ein Leerzeichen zu ersetzen.
String	safeEncode(final String stringToEncode) Führt eine sichere Codierung der angegebenen Zeichenfolge durch, wobei darauf geachtet wird, für jedes Leerzeichen einzufügen, anstatt das Zeichen einzufügen.
String	safeRelativize(final URI baseURI, final URI toUri) Bestimmt den relativen Unterschied zwischen den beiden angegebenen URIs.
List<byte[]>	splitOnPattern(byte[] array, byte[] pattern)
String	stringJoin(CharSequence delimiter, final String... strings) Äquivalent von String.join() in Java 8.
String	stringJoin(CharSequence delimiter, Iterable<String> strings) Äquivalent von String.join() in Java 8.
String	trimEnd(final String value, final char trimChar) Schneidet das angegebene Zeichen vom Ende einer Zeichenfolge ab.
String	trimStart(final String value) Schneidet Leerzeichen vom Anfang einer Zeichenfolge ab.
boolean	validateMaxExecutionTimeout(Long operationExpiryTimeInMs) Gibt einen Wert zurück, der angibt, ob die maximale Ausführungszeit überschritten wird.
boolean	validateMaxExecutionTimeout(Long operationExpiryTimeInMs, long additionalInterval) Gibt einen Wert zurück, der angibt, ob die maximale Ausführungszeit überschritten wird.
StreamMd5AndLength	writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options) Liest Daten aus einem Eingabedatenstrom und schreibt sie in einen Ausgabedatenstrom, berechnet die Länge der geschriebenen Daten und berechnet optional den MD5-Hash für die Daten.
StreamMd5AndLength	writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options, final Boolean shouldFlush) Liest Daten aus einem Eingabedatenstrom und schreibt sie in einen Ausgabedatenstrom, berechnet die Länge der geschriebenen Daten und berechnet optional den MD5-Hash für die Daten.
StreamMd5AndLength	writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options, final Boolean shouldFlush, StorageRequest<?, ?, Integer> request, StreamMd5AndLength descriptor) Liest Daten aus einem Eingabedatenstrom und schreibt sie in einen Ausgabedatenstrom, berechnet die Länge der geschriebenen Daten und berechnet optional den MD5-Hash für die Daten.

Felddetails

GMT_ZONE

public static final TimeZone GMT_ZONE= TimeZone.getTimeZone("GMT")

Speichert einen Verweis auf die GMT-Zeitzone.

LOCALE_US

public static final Locale LOCALE_US= Locale.US

Speichert einen Verweis auf das US-Gebietsschema.

UTC_ZONE

public static final TimeZone UTC_ZONE= TimeZone.getTimeZone("UTC")

Speichert einen Verweis auf die UTC-Zeitzone.

Details zur Methode

analyzeStream

public static StreamMd5AndLength analyzeStream(final InputStream sourceStream, long writeLength, long abandonLength, final boolean rewindSourceStream, final boolean calculateMD5)

Bestimmt die Größe eines Eingabedatenstroms und berechnet optional den MD5-Hash für den Stream.

Parameters:

sourceStream - Ein InputStream -Objekt, das den zu messenden Stream darstellt.

writeLength - Die Anzahl der Bytes, die aus dem Stream gelesen werden sollen.

abandonLength - Die Anzahl der Bytes, die gelesen werden sollen, bevor die Analyse abgebrochen wird. Legen Sie diesen Wert auf fest -1 , um das Lesen des gesamten Datenstroms zu erzwingen. Dieser Parameter wird bereitgestellt, um Uploadschwellenwerte zu unterstützen.

rewindSourceStream -

true , wenn der Stream nach dem Lesen umgewickelt werden soll; falseandernfalls .

calculateMD5 -

true , wenn ein MD5-Hash berechnet wird; falseandernfalls .

Returns:

Ein StreamMd5AndLength -Objekt, das die Streamlänge und optional den MD5-Hash enthält.

Throws:

IOException - Wenn ein E/A-Fehler auftritt.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

assertContinuationType

public static void assertContinuationType(final ResultContinuation continuationToken, final ResultContinuationType continuationType)

Bestätigt, dass ein Fortsetzungstoken vom angegebenen Typ ist.

Parameters:

continuationToken - Ein ResultContinuation -Objekt, das das Fortsetzungstoken darstellt, dessen Typ untersucht wird.

continuationType - Ein ResultContinuationType -Wert, der den Fortsetzungstokentyp darstellt, der mit dem angegebenen Fortsetzungstoken bestätigt wird.

assertGreaterThanOrEqual

public static void assertGreaterThanOrEqual(final String param, final long value, final long min)

Bestätigt, dass der angegebene Wert größer oder gleich dem min-Wert ist.

Parameters:

param - Ein String , der den Namen des Parameters darstellt, der zum Ausnahmemeldungstext wird, wenn der value Parameter außerhalb der Grenzen liegt.

value - Der Wert des angegebenen Parameters.

min - Der Mindestwert für den angegebenen Parameter.

assertInBounds

public static void assertInBounds(final String param, final long value, final long min, final long max)

Bestätigt, dass sich die angegebene ganze Zahl im gültigen Bereich befindet.

Parameters:

param - Ein String , der den Namen des Parameters darstellt, der zum Ausnahmemeldungstext wird, wenn der value Parameter außerhalb der Grenzen liegt.

value - Der Wert des angegebenen Parameters.

min - Der Mindestwert für den angegebenen Parameter.

max - Der Maximalwert für den angegebenen Parameter.

assertNotNull

public static void assertNotNull(final String param, final Object value)

Bestätigt, dass ein Wert nicht ist.

Parameters:

param - Ein String , der den Namen des Parameters darstellt, der zum Ausnahmemeldungstext wird, wenn der value Parameter ist null.

value - Ein Object -Objekt, das den Wert des angegebenen Parameters darstellt. Dies ist der Wert, der als nicht nullbestätigt wird.

assertNotNullOrEmpty

public static void assertNotNullOrEmpty(final String param, final String value)

Bestätigt, dass die angegebene Zeichenfolge nicht oder leer ist.

Parameters:

param - Ein String , der den Namen des Parameters darstellt, der zum Ausnahmemeldungstext wird, wenn der value Parameter oder eine leere Zeichenfolge ist null .

value - Ein String , der den Wert des angegebenen Parameters darstellt. Dies ist der Wert, der als nicht null und nicht als leere Zeichenfolge bestätigt wird.

binaryAppend

public static byte [] binaryAppend(byte[] arr1, byte[] arr2)

Fügt 2 Bytearrays an.

Parameters:

arr1 - Erstes Array.

arr2 - Zweites Array.

Returns:

Das Ergebnisbytearray.

checkNullaryCtor

public static void checkNullaryCtor(Class clazzType)

Parameters:

clazzType

createXMLStreamWriter

public static XMLStreamWriter createXMLStreamWriter(StringWriter outWriter)

Gibt einen mit dem angegebenen zurück.

Parameters:

outWriter - Die StringWriter , die zum Erstellen der XMLStreamWriter instance verwendet werden soll.

Returns:

eine XMLStreamWriter-Instanz

Throws:

XMLStreamException

determinePathStyleFromUri

public static boolean determinePathStyleFromUri(final URI baseURI)

Gibt einen Wert zurück, der angibt, ob ein angegebener URI ein Pfad-URI ist.

Parameters:

baseURI - Ein java.net.URI -Wert, der den zu überprüfenden URI darstellt.

Returns:

true , wenn der angegebene URI im Pfadformat ist; falseandernfalls .

encryptStreamIfUnderThreshold

public static long encryptStreamIfUnderThreshold(final InputStream sourceStream, final ByteArrayOutputStream targetStream, Cipher cipher, long writeLength, long abandonLength)

Verschlüsselt einen Eingabedatenstrom bis zu einer bestimmten Länge. Wird frühzeitig beendet, wenn die verschlüsselten Daten länger als die Abbruchlänge sind.

Parameters:

sourceStream - Ein InputStream -Objekt, das den zu messenden Stream darstellt.

targetStream - Ein ByteArrayOutputStream -Objekt, das den Datenstrom zum Schreiben der verschlüsselten Daten darstellt.

cipher - Die Cipher , die zum Verschlüsseln der Daten verwendet werden soll.

writeLength - Die Anzahl der Bytes, die aus dem sourceStream gelesen und verschlüsselt werden sollen.

Returns:

Die Größe des verschlüsselten Datenstroms oder -1, wenn der verschlüsselte Datenstrom über dem abandonLength liegen würde.

Throws:

IOException - Wenn ein E/A-Fehler auftritt.

findAllPatternOccurences

public static List findAllPatternOccurences(byte[] array, byte[] pattern)

Scannt ein Bytearray auf alle Vorkommen eines Musters, ohne Dass sich die Vorkommensspannen überschneiden.

Parameters:

array - Das Array, das durchsucht werden soll.

pattern - Das zu suchende Muster.

Returns:

Eine Liste der Startindizes aller Vorkommen des Musters in aufsteigender Reihenfolge.

findPattern

public static int findPattern(byte[] array, byte[] pattern, int scanOffset)

Scannt ein Bytearray auf das erste Vorkommen eines Musters, beginnend mit dem angegebenen Offset.

Parameters:

array - Das Array, das durchsucht werden soll.

pattern - Das zu suchende Muster.

scanOffset - Wo die Suche beginnen soll.

Returns:

Der Startindex des gefundenen Musters. -1, wenn nicht gefunden.

formatETag

public static String formatETag(final String etag)

Liest Zeichendaten für das Etag-Element aus einem XML-Streamreader.

Parameters:

etag

Returns:

Ein String , der die Zeichendaten für das Etag-Element darstellt.

generateNewUnexpectedStorageException

public static StorageException generateNewUnexpectedStorageException(final Exception cause)

Gibt eine unerwartete Speicher-Ausnahme zurück.

Parameters:

cause - Ein Exception -Objekt, das die anfängliche Ausnahme darstellt, die den unerwarteten Fehler verursacht hat.

Returns:

Ein StorageException -Objekt, das die ausgelöste unerwartete Speicher-Ausnahme darstellt.

getGMTTime

public static String getGMTTime()

Gibt die aktuelle GMT-Datums-/Uhrzeitzeichenfolge unter Verwendung des RFC1123-Musters zurück.

Returns:

Ein String , der das aktuelle GMT-Datum/die aktuelle Gmt-Uhrzeit mit dem RFC1123-Muster darstellt.

getGMTTime

public static String getGMTTime(final Date date)

Gibt die GTM-Datums-/Uhrzeitzeichenfolge für den angegebenen Wert mithilfe des RFC1123-Musters zurück.

Parameters:

date - Ein Date -Objekt, das das Datum darstellt, das in GMT-Datum/Uhrzeit im RFC1123-Muster konvertiert werden soll.

Returns:

public static RequestLocationMode getListingLocationMode(ResultContinuation token)

Bestimmt, an welchem Speicherort das Listungsbefehlsziel verwendet werden kann, indem das Fortsetzungstoken betrachtet wird.

Parameters:

token - Fortsetzungstoken

Returns:

Standortmodus

getRemainingTimeout

public static int getRemainingTimeout(Long operationExpiryTimeInMs, Integer timeoutIntervalInMs)

Gibt einen Wert zurück, der die verbleibende Zeit vor Ablauf des Vorgangs darstellt.

Parameters:

operationExpiryTimeInMs - der Zeitpunkt, zu dem die Anforderung abläuft

timeoutIntervalInMs - das serverseitige Timeoutintervall

Returns:

die verbleibende Zeit vor Ablauf des Vorgangs

Throws:

StorageException - umschließt eine TimeoutException, wenn keine zeit mehr vorhanden ist

getSAXParser

public static SAXParser getSAXParser()

Gibt einen Namespace zurück, der verwendet wird.

Returns:

Eine SAXParser instance, die namespacefähig ist

Throws:

ParserConfigurationException

SAXException

getStandardHeaderValue

public static String getStandardHeaderValue(final HttpURLConnection conn, final String headerName)

Gibt den Standardheaderwert aus der angegebenen Verbindungsanforderung oder eine leere Zeichenfolge zurück, wenn für die Anforderung kein Headerwert angegeben wurde.

Parameters:

conn - Ein HttpURLConnection Objekt, das die Anforderung darstellt.

headerName - Eine String , die den Namen des angeforderten Headers darstellt.

Returns:

Eine String , die den Headerwert darstellt, oder null wenn kein entsprechender Headerwert für headerNamevorhanden ist.

getUTCTimeOrEmpty

public static String getUTCTimeOrEmpty(final Date value)

Gibt das UTC-Datum/uhrzeit für den angegebenen Wert unter Verwendung des ISO8601-Musters zurück.

Parameters:

value - Ein Date -Objekt, das das Datum darstellt, das in UTC-Datum/Uhrzeit im ISO8601-Muster konvertiert werden soll. Wenn dieser Wert ist null, gibt diese Methode eine leere Zeichenfolge zurück.

Returns:

Eine String , die das UTC-Datum/die Uhrzeit für den angegebenen Wert mit dem ISO8601-Muster oder eine leere Zeichenfolge darstellt, wenn value ist null.

initIOException

public static IOException initIOException(final Exception ex)

Erstellt eine instance der -Klasse unter Verwendung der angegebenen Ausnahme.

Parameters:

ex - Ein Exception -Objekt, das die Ausnahme darstellt, die zum Erstellen der E/A-Ausnahme verwendet wird.

Returns:

Ein java.io.IOException -Objekt, das die erstellte E/A-Ausnahme darstellt.

isNullOrEmpty

public static boolean isNullOrEmpty(final String value)

Gibt einen Wert zurück, der angibt, ob die angegebene Zeichenfolge leer ist.

Parameters:

value - Eine String , die auf null oder leer untersucht wird.

Returns:

true , wenn der angegebene Wert leer ist null , andernfalls false

isNullOrEmptyOrWhitespace

public static boolean isNullOrEmptyOrWhitespace(final String value)

Gibt einen Wert zurück, der angibt, ob die angegebene Zeichenfolge leer oder leer ist.

Parameters:

value - Ein String , der auf null, leer oder Leerzeichen untersucht wird.

Returns:

true , wenn der angegebene Wert leer oder Leerzeichen ist null, andernfalls false

logHttpError

public static void logHttpError(StorageException ex, OperationContext opContext)

Serialisiert die analysierte StorageException. Wenn eine Ausnahme gefunden wird, gibt eine leere Zeichenfolge zurück.

Parameters:

ex - Die zu serialisierende StorageException.

opContext - Der Vorgangskontext, der die Protokollierung bereitstellt.

logHttpRequest

public static void logHttpRequest(HttpURLConnection conn, OperationContext opContext)

Protokolliert die HttpURLConnection-Anforderung. Wenn eine Ausnahme auftritt, werden keine Protokolle protokolliert.

Parameters:

conn - Die zu serialisierende HttpURLConnection.

opContext - Der Vorgangskontext, der die Protokollierung bereitstellt.

public static Date parseDate(String dateString, boolean dateBackwardCompatibility)

Bei einer Zeichenfolge, die ein Datum in einer Form des ISO8601 Musters darstellt, wird ein Date generiert, das es mit einer Genauigkeit von bis zu Millisekunden darstellt. Verwenden Sie parseDate(String dateString) stattdessen, es sei denn, dies ist erforderlich.

Ausführlichere Informationen finden Sie hier.

Parameters:

dateString - die String als interpretiert werden soll Date

dateBackwardCompatibility -

true um Datumswerte zu korrigieren, die möglicherweise mit Versionen dieser Bibliothek vor 2.0.0 geschrieben wurden; Andernfalls false

Returns:

das entsprechende Date Objekt

parseRFC1123DateFromStringInGMT

public static Date parseRFC1123DateFromStringInGMT(final String value)

Gibt ein GMT-Datum für die angegebene Zeichenfolge im RFC1123-Muster zurück.

Parameters:

value - Ein String , der die zu analysierende Zeichenfolge darstellt.

Returns:

Ein Date -Objekt, das das GMT-Datum im RFC1123-Muster darstellt.

Throws:

ParseException - Wenn die angegebene Zeichenfolge ungültig ist.

safeDecode

public static String safeDecode(final String stringToDecode)

Führt eine sichere Decodierung der angegebenen Zeichenfolge durch, wobei darauf geachtet wird, dass jedes Zeichen beibehalten wird, anstatt es durch ein Leerzeichen zu ersetzen.

Parameters:

stringToDecode - Eine String , die die zu decodierende Zeichenfolge darstellt.

Returns:

Eine String , die die decodierte Zeichenfolge darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

safeEncode

public static String safeEncode(final String stringToEncode)

Führt eine sichere Codierung der angegebenen Zeichenfolge durch, wobei darauf geachtet wird, für jedes Leerzeichen einzufügen, anstatt das Zeichen einzufügen.

Parameters:

stringToEncode - Eine String , die die zu codierende Zeichenfolge darstellt.

Returns:

Eine String , die die codierte Zeichenfolge darstellt.

Throws:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

safeRelativize

public static String safeRelativize(final URI baseURI, final URI toUri)

Bestimmt den relativen Unterschied zwischen den beiden angegebenen URIs.

Parameters:

baseURI - Ein java.net.URI -Objekt, das den Basis-URI darstellt, für den toUri relativ festgelegt wird.

toUri - Ein java.net.URI -Objekt, das den URI darstellt, der relativ zu machen ist baseURI.

Returns:

Eine String , die entweder den relativen URI von toUri oder baseURIden URI von toUri darstellt, je nachdem, ob Hostname und Schema für toUri und baseURIidentisch sind. Wenn Hostname und Schema von baseURI und toUri identisch sind, gibt diese Methode einen nicht codierten relativen URI zurück, sodass , wenn sie an baseURIangefügt wird, ergibt toUri. Wenn der Hostname oder das Schema von baseURI und toUri nicht identisch sind, gibt diese Methode einen nicht codierten vollständigen URI zurück, der durch angegeben wird toUri.

public static String trimStart(final String value)

Schneidet Leerzeichen vom Anfang einer Zeichenfolge ab.

Parameters:

value - Eine String , die die zu kürzeende Zeichenfolge darstellt.

Returns:

Die Zeichenfolge mit von Anfang an gekürztem Leerzeichen.

validateMaxExecutionTimeout

public static boolean validateMaxExecutionTimeout(Long operationExpiryTimeInMs)

Gibt einen Wert zurück, der angibt, ob die maximale Ausführungszeit überschritten wird.

Parameters:

operationExpiryTimeInMs - der Zeitpunkt, zu dem die Anforderung abläuft

Returns:

true , wenn die maximale Ausführungszeit überschritten würde; falseandernfalls .

validateMaxExecutionTimeout

public static boolean validateMaxExecutionTimeout(Long operationExpiryTimeInMs, long additionalInterval)

Gibt einen Wert zurück, der angibt, ob die maximale Ausführungszeit überschritten wird.

Parameters:

operationExpiryTimeInMs - der Zeitpunkt, zu dem die Anforderung abläuft

additionalInterval - alle zusätzlichen Zeit, die ab sofort erforderlich ist

Returns:

true , wenn die maximale Ausführungszeit überschritten würde; falseandernfalls .

writeToOutputStream

public static StreamMd5AndLength writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options)

Liest Daten aus einem Eingabedatenstrom und schreibt sie in einen Ausgabedatenstrom, berechnet die Länge der geschriebenen Daten und berechnet optional den MD5-Hash für die Daten.

Parameters:

sourceStream - Ein InputStream -Objekt, das den Eingabedatenstrom darstellt, der als Quelle verwendet werden soll.

outStream - Ein OutputStream -Objekt, das den Ausgabestream darstellt, der als Ziel verwendet werden soll.

writeLength - Die Anzahl der Bytes, die aus dem Stream gelesen werden sollen.

rewindSourceStream -

true , wenn der Eingabedatenstrom erneut aktiviert werden soll, bevor er gelesen wird; Andernfalls false

calculateMD5 -

true , wenn ein MD5-Hash berechnet wird; falseandernfalls .

opContext - 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.

options - Ein RequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Nämlich die maximale Ausführungszeit.

Returns:

Ein StreamMd5AndLength -Objekt, das die Ausgabedatenstromlänge und optional den MD5-Hash enthält.

Throws:

IOException - Wenn ein E/A-Fehler auftritt.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

writeToOutputStream

Liest Daten aus einem Eingabedatenstrom und schreibt sie in einen Ausgabedatenstrom, berechnet die Länge der geschriebenen Daten und berechnet optional den MD5-Hash für die Daten.

Parameters:

sourceStream - Ein InputStream -Objekt, das den Eingabedatenstrom darstellt, der als Quelle verwendet werden soll.

outStream - Ein OutputStream -Objekt, das den Ausgabestream darstellt, der als Ziel verwendet werden soll.

writeLength - Die Anzahl der Bytes, die aus dem Stream gelesen werden sollen.

rewindSourceStream -

true , wenn der Eingabedatenstrom erneut aktiviert werden soll, bevor er gelesen wird; Andernfalls false

calculateMD5 -

true , wenn ein MD5-Hash berechnet wird; falseandernfalls .

options - Ein RequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Nämlich die maximale Ausführungszeit.

shouldFlush

Returns:

Ein StreamMd5AndLength -Objekt, das die Ausgabedatenstromlänge und optional den MD5-Hash enthält.

Throws:

IOException - Wenn ein E/A-Fehler auftritt.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

writeToOutputStream

Liest Daten aus einem Eingabedatenstrom und schreibt sie in einen Ausgabedatenstrom, berechnet die Länge der geschriebenen Daten und berechnet optional den MD5-Hash für die Daten.

Parameters:

sourceStream - Ein InputStream -Objekt, das den Eingabedatenstrom darstellt, der als Quelle verwendet werden soll.

outStream - Ein OutputStream -Objekt, das den Ausgabestream darstellt, der als Ziel verwendet werden soll.

writeLength - Die Anzahl der Bytes, die aus dem Stream gelesen werden sollen.

rewindSourceStream -

true , wenn der Eingabedatenstrom erneut aktiviert werden soll, bevor er gelesen wird; Andernfalls false

calculateMD5 -

true , wenn ein MD5-Hash berechnet wird; falseandernfalls .

options - Ein RequestOptions -Objekt, das alle zusätzlichen Optionen für die Anforderung angibt. Nämlich die maximale Ausführungszeit.

shouldFlush

request - Wird vom Download-Lebenslauf verwendet, um currentRequestByteCount für die Anforderung festzulegen. Andernfalls wird immer NULL verwendet.

descriptor - Ein StreamMd5AndLength Objekt, an das im Falle einer Wiederherstellungsaktion angefügt werden soll, oder NULL, wenn dies nicht von einer Wiederherstellung aufgerufen wird. Dieser Wert muss für die Wiederherstellung übergeben werden, falls ein Teil des Textkörpers bereits gelesen wurde, versucht die Wiederherstellung, die verbleibenden Bytes herunterzuladen, führt jedoch eine MD5-Überprüfung für die ursprünglich angeforderte Bereichsgröße durch.

Returns:

Ein StreamMd5AndLength -Objekt, das die Ausgabedatenstromlänge und optional den MD5-Hash enthält.

Throws:

IOException - Wenn ein E/A-Fehler auftritt.

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

Gilt für:

Feedback

War diese Seite hilfreich?