com.azure.storage.common

Class Utility

java.lang.Object

com.azure.storage.common.Utility

public final class Utility
extends Object

Utility methods for storage client libraries.

Field Summary

Fields

Modifier and Type	Field and Description
static String	STORAGE_TRACING_NAMESPACE_VALUE

Constructor Summary

Constructors

Constructor and Description
Utility()

Method Summary

Modifier and Type	Method and Description
static String	appendQueryParameter(String url, String key, String value) Appends a query parameter to a url.
static Flux<ByteBuffer>	convertStreamToByteBuffer(InputStream data, long length, int blockSize) A utility method for converting the input stream to Flux of ByteBuffer.
static String	encodeUrlPath(String url) Performs a safe encoding of a url string, only encoding the path.
static OffsetDateTime	parseDate(String dateString) Given a String representing a date in a form of the ISO8601 pattern, generates a Date representing it with up to millisecond precision.
static String	urlDecode(String stringToDecode) Performs a safe decoding of the passed string, taking care to preserve each + character rather than replacing it with a space character.
static String	urlEncode(String stringToEncode) Performs a safe encoding of the specified string, taking care to insert %20 for each space character instead of inserting the + character.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

STORAGE_TRACING_NAMESPACE_VALUE

public static final String STORAGE_TRACING_NAMESPACE_VALUE

See Also:

Constant Field Values

Constructor Detail

Utility

public Utility()

Method Detail

urlDecode

public static String urlDecode(String stringToDecode)

Performs a safe decoding of the passed string, taking care to preserve each + character rather than replacing it with a space character.

Parameters:

stringToDecode - String value to decode

Returns:

the decoded string value

Throws:

RuntimeException - If the UTF-8 charset isn't supported

urlEncode

public static String urlEncode(String stringToEncode)

Performs a safe encoding of the specified string, taking care to insert %20 for each space character instead of inserting the + character.

Parameters:

stringToEncode - String value to encode

Returns:

the encoded string value

Throws:

RuntimeException - If the UTF-8 charset ins't supported

encodeUrlPath

public static String encodeUrlPath(String url)

Performs a safe encoding of a url string, only encoding the path.

Parameters:

url - The url to encode.

Returns:

The encoded url.

parseDate

public static OffsetDateTime parseDate(String dateString)

Given a String representing a date in a form of the ISO8601 pattern, generates a Date representing it with up to millisecond precision.

Parameters:

dateString - the String to be interpreted as a Date

Returns:

the corresponding Date object

Throws:

IllegalArgumentException - If dateString doesn't match an ISO8601 pattern

convertStreamToByteBuffer

public static Flux<ByteBuffer> convertStreamToByteBuffer(InputStream data,
                                                         long length,
                                                         int blockSize)

A utility method for converting the input stream to Flux of ByteBuffer. Will check the equality of entity length and the input length.

Parameters:

data - The input data which needs to convert to ByteBuffer.

length - The expected input data length.

blockSize - The size of each ByteBuffer.

Returns:

ByteBuffer which contains the input data.

Throws:

com.azure.core.exception.UnexpectedLengthException - when input data length mismatch input length.

RuntimeException - When I/O error occurs.

appendQueryParameter

public static String appendQueryParameter(String url,
                                          String key,
                                          String value)

Appends a query parameter to a url.

Parameters:

url - The url.

key - The query key.

value - The query value.

Returns:

The updated url.