Compartilhar via

Utility Classe

  • Referência
Pacote:
com.microsoft.azure.storage.core
  • java.lang.Object
    • com.microsoft.azure.storage.core.Utility

public class Utility

RESERVADO PARA USO INTERNO. Uma classe que fornece métodos utilitários.

Resumo do campo

Modificador e tipo Campo e descrição
final TimeZone GMT_ZONE

Armazena uma referência ao fuso horário GMT.

final Locale LOCALE_US

Armazena uma referência à localidade dos EUA.

final TimeZone UTC_ZONE

Armazena uma referência ao fuso horário UTC.

Resumo do método

Modificador e tipo Método e descrição
StreamMd5AndLength analyzeStream(final InputStream sourceStream, long writeLength, long abandonLength, final boolean rewindSourceStream, final boolean calculateMD5)

Determina o tamanho de um fluxo de entrada e, opcionalmente, calcula o hash MD5 para o fluxo.
void assertContinuationType(final ResultContinuation continuationToken, final ResultContinuationType continuationType)

Declara que um token de continuação é do tipo especificado.
void assertGreaterThanOrEqual(final String param, final long value, final long min)

Afirma que o valor especificado é maior ou igual ao valor mínimo.
void assertInBounds(final String param, final long value, final long min, final long max)

Afirma que o inteiro especificado está no intervalo válido.
void assertNotNull(final String param, final Object value)

Afirma que um valor não é .
void assertNotNullOrEmpty(final String param, final String value)

Afirma que a cadeia de caracteres especificada não está ou está vazia.
byte [] binaryAppend(byte[] arr1, byte[] arr2)

Acrescenta matrizes de 2 bytes.

void checkNullaryCtor(Class<?> clazzType)
XMLStreamWriter createXMLStreamWriter(StringWriter outWriter)

Retorna um com o especificado.
boolean determinePathStyleFromUri(final URI baseURI)

Retorna um valor que indica se um URI especificado é um URI de estilo de caminho.
long encryptStreamIfUnderThreshold(final InputStream sourceStream, final ByteArrayOutputStream targetStream, Cipher cipher, long writeLength, long abandonLength)

Criptografa um fluxo de entrada até um determinado comprimento. Sairá mais cedo se os dados criptografados forem maiores do que o comprimento de abandono.
List<Integer> findAllPatternOccurences(byte[] array, byte[] pattern)

Examina uma matriz de bytes para todas as ocorrências de um padrão, sem sobreposição de intervalos de ocorrência.
int findPattern(byte[] array, byte[] pattern, int scanOffset)

Examina uma matriz de bytes para a primeira ocorrência de um padrão, começando no deslocamento fornecido.
String formatETag(final String etag)

Lê dados de caractere para o elemento Etag de um leitor de fluxo XML.
StorageException generateNewUnexpectedStorageException(final Exception cause)

Retorna uma exceção de armazenamento inesperada.
String getGMTTime()

Retorna a cadeia de caracteres de data/hora GMT atual usando o padrão RFC1123.
String getGMTTime(final Date date)

Retorna a cadeia de caracteres de data/hora do GTM para o valor especificado usando o padrão de RFC1123.
String getJavaISO8601Time(Date date)

Retorna a cadeia de caracteres de data/hora UTC para o valor especificado usando a versão do Java do padrão ISO8601, que é limitado à precisão de milissegundos.
JsonGenerator getJsonGenerator(OutputStream outStream)

Retorna um com o especificado.
JsonGenerator getJsonGenerator(StringWriter strWriter)

Retorna um com o especificado.
JsonParser getJsonParser(final InputStream inStream)

Retorna um com o especificado. Esse JsonParser permitirá números não numéricos.
JsonParser getJsonParser(final String jsonString)

Retorna um com o especificado. Esse JsonParser permitirá números não numéricos.
RequestLocationMode getListingLocationMode(ResultContinuation token)

Determina qual local pode o destino do comando de listagem examinando o token de continuação.
int getRemainingTimeout(Long operationExpiryTimeInMs, Integer timeoutIntervalInMs)

Retorna um valor que representa o tempo restante antes que a operação expire.
SAXParser getSAXParser()

Retorna um namespace com reconhecimento de .
String getStandardHeaderValue(final HttpURLConnection conn, final String headerName)

Retorna o valor de cabeçalho padrão da solicitação de conexão especificada ou uma cadeia de caracteres vazia se nenhum valor de cabeçalho tiver sido especificado para a solicitação.
String getUTCTimeOrEmpty(final Date value)

Retorna a data/hora UTC para o valor especificado usando o padrão ISO8601.
IOException initIOException(final Exception ex)

Cria uma instância da classe usando a exceção especificada.
boolean isNullOrEmpty(final String value)

Retorna um valor que indica se a cadeia de caracteres especificada está ou vazia.
boolean isNullOrEmptyOrWhitespace(final String value)

Retorna um valor que indica se a cadeia de caracteres especificada é , vazia ou espaço em branco.
void logHttpError(StorageException ex, OperationContext opContext)

Serializa o StorageException analisado. Se uma exceção for encontrada, retornará uma cadeia de caracteres vazia.
void logHttpRequest(HttpURLConnection conn, OperationContext opContext)

Registra a solicitação HttpURLConnection. Se uma exceção for encontrada, não registrará em log nada.
void logHttpResponse(HttpURLConnection conn, OperationContext opContext)

Registra a resposta HttpURLConnection. Se uma exceção for encontrada, não registrará em log nada.
HashMap<String, String> parseAccountString(final String parseString)

Analisa uma cadeia de conexão e retorna seus valores como um mapa de hash de pares chave/valor.
Date parseDate(String dateString)

Dado um String que representa uma data em uma forma do padrão ISO8601, gera uma Data representando-a com precisão de até milissegundos.
Date parseDate(String dateString, boolean dateBackwardCompatibility)

Dado um String que representa uma data em uma forma do padrão ISO8601, gera uma Data representando-a com precisão de até milissegundos. Use parseDate(String dateString) em vez disso, a menos que seja necessário.

Veja aqui para obter mais detalhes.
Date parseRFC1123DateFromStringInGMT(final String value)

Retorna uma data GMT para a cadeia de caracteres especificada no padrão RFC1123.
String safeDecode(final String stringToDecode)

Executa a decodificação segura da cadeia de caracteres especificada, tendo o cuidado de preservar cada caractere, em vez de substituí-lo por um caractere de espaço.
String safeEncode(final String stringToEncode)

Executa a codificação segura da cadeia de caracteres especificada, tendo o cuidado de inserir para cada caractere de espaço, em vez de inserir o caractere.
String safeRelativize(final URI baseURI, final URI toUri)

Determina a diferença relativa entre os dois URIs especificados.
List<byte[]> splitOnPattern(byte[] array, byte[] pattern)
String stringJoin(CharSequence delimiter, final String... strings)

Equivalente a String.join() no Java 8.
String stringJoin(CharSequence delimiter, Iterable<String> strings)

Equivalente a String.join() no Java 8.
String trimEnd(final String value, final char trimChar)

Corta o caractere especificado do final de uma cadeia de caracteres.
String trimStart(final String value)

Corta o espaço em branco desde o início de uma cadeia de caracteres.
boolean validateMaxExecutionTimeout(Long operationExpiryTimeInMs)

Retorna um valor que representa se o tempo máximo de execução seria ultrapassado.
boolean validateMaxExecutionTimeout(Long operationExpiryTimeInMs, long additionalInterval)

Retorna um valor que representa se o tempo máximo de execução seria ultrapassado.
StreamMd5AndLength writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options)

Lê dados de um fluxo de entrada e os grava em um fluxo de saída, calcula o comprimento dos dados gravados e, opcionalmente, calcula o hash MD5 para os dados.
StreamMd5AndLength writeToOutputStream(final InputStream sourceStream, final OutputStream outStream, long writeLength, final boolean rewindSourceStream, final boolean calculateMD5, OperationContext opContext, final RequestOptions options, final Boolean shouldFlush)

Lê dados de um fluxo de entrada e os grava em um fluxo de saída, calcula o comprimento dos dados gravados e, opcionalmente, calcula o hash MD5 para os dados.
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)

Lê dados de um fluxo de entrada e os grava em um fluxo de saída, calcula o comprimento dos dados gravados e, opcionalmente, calcula o hash MD5 para os dados.

Detalhes do campo

GMT_ZONE

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

Armazena uma referência ao fuso horário GMT.

LOCALE_US

public static final Locale LOCALE_US= Locale.US

Armazena uma referência à localidade dos EUA.

UTC_ZONE

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

Armazena uma referência ao fuso horário UTC.

Detalhes do método

analyzeStream

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

Determina o tamanho de um fluxo de entrada e, opcionalmente, calcula o hash MD5 para o fluxo.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo a ser medido.
writeLength - O número de bytes a serem lidos do fluxo.
abandonLength - O número de bytes a serem lidos antes que a análise seja abandonada. Defina esse valor como -1 para forçar a leitura de todo o fluxo. Esse parâmetro é fornecido para dar suporte a limites de upload.
rewindSourceStream -

true se o fluxo deve ser relançado depois de lido; caso contrário, false.

calculateMD5 -

true se um hash MD5 for calculado; caso contrário, false.

Returns:

Um StreamMd5AndLength objeto que contém o comprimento do fluxo e, opcionalmente, o hash MD5.

Throws:

IOException - Se ocorrer um erro de E/S.
StorageException - Se ocorreu um erro de serviço de armazenamento.

assertContinuationType

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

Declara que um token de continuação é do tipo especificado.

Parameters:

continuationToken - Um ResultContinuation objeto que representa o token de continuação cujo tipo está sendo examinado.
continuationType - Um ResultContinuationType valor que representa o tipo de token de continuação que está sendo declarado com o token de continuação especificado.

assertGreaterThanOrEqual

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

Afirma que o valor especificado é maior ou igual ao valor mínimo.

Parameters:

param - Um String que representa o nome do parâmetro , que se tornará o texto da mensagem de exceção se o value parâmetro estiver fora dos limites.
value - O valor do parâmetro especificado.
min - O valor mínimo para o parâmetro especificado.

assertInBounds

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

Afirma que o inteiro especificado está no intervalo válido.

Parameters:

param - Um String que representa o nome do parâmetro , que se tornará o texto da mensagem de exceção se o value parâmetro estiver fora dos limites.
value - O valor do parâmetro especificado.
min - O valor mínimo para o parâmetro especificado.
max - O valor máximo para o parâmetro especificado.

assertNotNull

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

Afirma que um valor não é .

Parameters:

param - Um String que representa o nome do parâmetro , que se tornará o texto da mensagem de exceção se o value parâmetro for null.
value - Um Object objeto que representa o valor do parâmetro especificado. Esse é o valor que está sendo declarado como não null.

assertNotNullOrEmpty

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

Afirma que a cadeia de caracteres especificada não está ou está vazia.

Parameters:

param - Um String que representa o nome do parâmetro , que se tornará o texto da mensagem de exceção se o value parâmetro for null ou uma cadeia de caracteres vazia.
value - Um String que representa o valor do parâmetro especificado. Esse é o valor que está sendo declarado como não null e não como uma cadeia de caracteres vazia.

binaryAppend

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

Acrescenta matrizes de 2 bytes.

Parameters:

arr1 - Primeira matriz.
arr2 - Segunda matriz.

Returns:

A matriz de bytes de resultado.

checkNullaryCtor

public static void checkNullaryCtor(Class clazzType)

Parameters:

clazzType

createXMLStreamWriter

public static XMLStreamWriter createXMLStreamWriter(StringWriter outWriter)

Retorna um com o especificado.

Parameters:

outWriter - O StringWriter a ser usado para criar a XMLStreamWriter instância.

Returns:

Uma instância de XMLStreamWriter

Throws:

XMLStreamException

determinePathStyleFromUri

public static boolean determinePathStyleFromUri(final URI baseURI)

Retorna um valor que indica se um URI especificado é um URI de estilo de caminho.

Parameters:

baseURI - Um java.net.URI valor que representa o URI que está sendo verificado.

Returns:

true se o URI especificado for estilo de caminho; caso contrário, false.

encryptStreamIfUnderThreshold

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

Criptografa um fluxo de entrada até um determinado comprimento. Sairá mais cedo se os dados criptografados forem maiores do que o comprimento de abandono.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo a ser medido.
targetStream - Um ByteArrayOutputStream objeto que representa o fluxo para gravar os dados criptografados.
cipher - O Cipher a ser usado para criptografar os dados.
writeLength - O número de bytes a serem lidos e criptografados do sourceStream.
abandonLength - O número de bytes a serem lidos antes que a análise seja abandonada. Defina esse valor como -1 para forçar a leitura de todo o fluxo. Esse parâmetro é fornecido para dar suporte a limites de upload.

Returns:

O tamanho do fluxo criptografado ou -1 se o fluxo criptografado estiver sobre o abandonLength.

Throws:

IOException - Se ocorrer um erro de E/S.

findAllPatternOccurences

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

Examina uma matriz de bytes para todas as ocorrências de um padrão, sem sobreposição de intervalos de ocorrência.

Parameters:

array - Matriz a ser pesquisada.
pattern - O padrão a ser pesquisado.

Returns:

Uma lista de índices iniciais de todas as ocorrências do padrão, em ordem crescente.

findPattern

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

Examina uma matriz de bytes para a primeira ocorrência de um padrão, começando no deslocamento fornecido.

Parameters:

array - Matriz a ser pesquisada.
pattern - O padrão a ser pesquisado.
scanOffset - Onde iniciar a pesquisa.

Returns:

O índice inicial do padrão encontrado. -1 se não for encontrado.

formatETag

public static String formatETag(final String etag)

Lê dados de caractere para o elemento Etag de um leitor de fluxo XML.

Parameters:

etag

Returns:

Um String que representa os dados de caractere para o elemento Etag.

generateNewUnexpectedStorageException

public static StorageException generateNewUnexpectedStorageException(final Exception cause)

Retorna uma exceção de armazenamento inesperada.

Parameters:

cause - Um Exception objeto que representa a exceção inicial que causou o erro inesperado.

Returns:

Um StorageException objeto que representa a exceção de armazenamento inesperada que está sendo gerada.

getGMTTime

public static String getGMTTime()

Retorna a cadeia de caracteres de data/hora GMT atual usando o padrão RFC1123.

Returns:

Um String que representa a data/hora GMT atual usando o padrão de RFC1123.

getGMTTime

public static String getGMTTime(final Date date)

Retorna a cadeia de caracteres de data/hora do GTM para o valor especificado usando o padrão de RFC1123.

Parameters:

date - Um Date objeto que representa a data a ser convertida em data/hora GMT no padrão de RFC1123.

Returns:

Um String que representa a data/hora GMT do valor especificado usando o padrão de RFC1123.

getJavaISO8601Time

public static String getJavaISO8601Time(Date date)

Retorna a cadeia de caracteres de data/hora UTC para o valor especificado usando a versão do Java do padrão ISO8601, que é limitado à precisão de milissegundos.

Parameters:

date - Um Date objeto que representa a data a ser convertida em data/hora UTC na versão do java do padrão ISO8601.

Returns:

Um String que representa a data/hora UTC para o valor especificado usando a versão do Java do padrão ISO8601.

getJsonGenerator

public static JsonGenerator getJsonGenerator(OutputStream outStream)

Retorna um com o especificado.

Parameters:

outStream - O OutputStream a ser usado para criar a JsonGenerator instância.

Returns:

Uma instância de JsonGenerator

Throws:

IOException

getJsonGenerator

public static JsonGenerator getJsonGenerator(StringWriter strWriter)

Retorna um com o especificado.

Parameters:

strWriter - O StringWriter a ser usado para criar a JsonGenerator instância.

Returns:

Uma instância de JsonGenerator

Throws:

IOException

getJsonParser

public static JsonParser getJsonParser(final InputStream inStream)

Retorna um com o especificado. Esse JsonParser permitirá números não numéricos.

Parameters:

inStream - O InputStream a ser usado para criar a JsonGenerator instância.

Returns:

Uma instância de JsonGenerator.

Throws:

IOException

getJsonParser

public static JsonParser getJsonParser(final String jsonString)

Retorna um com o especificado. Esse JsonParser permitirá números não numéricos.

Parameters:

jsonString - O String a ser usado para criar a JsonGenerator instância.

Returns:

Uma instância de JsonGenerator.

Throws:

IOException

getListingLocationMode

public static RequestLocationMode getListingLocationMode(ResultContinuation token)

Determina qual local pode o destino do comando de listagem examinando o token de continuação.

Parameters:

token - Token de continuação

Returns:

Modo de localização

getRemainingTimeout

public static int getRemainingTimeout(Long operationExpiryTimeInMs, Integer timeoutIntervalInMs)

Retorna um valor que representa o tempo restante antes que a operação expire.

Parameters:

operationExpiryTimeInMs - a hora em que a solicitação expira
timeoutIntervalInMs - o intervalo de tempo limite do lado do servidor

Returns:

o tempo restante antes que a operação expire

Throws:

StorageException - encapsula um TimeoutException se não houver mais tempo restante

getSAXParser

public static SAXParser getSAXParser()

Retorna um namespace com reconhecimento de .

Returns:

Uma SAXParser instância que tem reconhecimento de namespace

Throws:

ParserConfigurationException
SAXException

getStandardHeaderValue

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

Retorna o valor de cabeçalho padrão da solicitação de conexão especificada ou uma cadeia de caracteres vazia se nenhum valor de cabeçalho tiver sido especificado para a solicitação.

Parameters:

conn - Um HttpURLConnection objeto que representa a solicitação.
headerName - Um String que representa o nome do cabeçalho que está sendo solicitado.

Returns:

Um String que representa o valor do cabeçalho ou null se não há nenhum valor de cabeçalho correspondente para headerName.

getUTCTimeOrEmpty

public static String getUTCTimeOrEmpty(final Date value)

Retorna a data/hora UTC para o valor especificado usando o padrão ISO8601.

Parameters:

value - Um Date objeto que representa a data a ser convertida em data/hora UTC no padrão ISO8601. Se esse valor for null, esse método retornará uma cadeia de caracteres vazia.

Returns:

Um String que representa a data/hora UTC para o valor especificado usando o padrão ISO8601 ou uma cadeia de caracteres vazia se value for null.

initIOException

public static IOException initIOException(final Exception ex)

Cria uma instância da classe usando a exceção especificada.

Parameters:

ex - Um Exception objeto que representa a exceção usada para criar a exceção de E/S.

Returns:

Um java.io.IOException objeto que representa a exceção de E/S criada.

isNullOrEmpty

public static boolean isNullOrEmpty(final String value)

Retorna um valor que indica se a cadeia de caracteres especificada está ou vazia.

Parameters:

value - Um String que está sendo examinado ou null vazio.

Returns:

true se o valor especificado for null ou vazio; caso contrário, false

isNullOrEmptyOrWhitespace

public static boolean isNullOrEmptyOrWhitespace(final String value)

Retorna um valor que indica se a cadeia de caracteres especificada é , vazia ou espaço em branco.

Parameters:

value - Um String que está sendo examinado para null, vazio ou espaço em branco.

Returns:

true se o valor especificado for null, vazio ou espaço em branco; caso contrário, false

logHttpError

public static void logHttpError(StorageException ex, OperationContext opContext)

Serializa o StorageException analisado. Se uma exceção for encontrada, retornará uma cadeia de caracteres vazia.

Parameters:

ex - A StorageException a ser serializada.
opContext - O contexto de operação que fornece o agente.

logHttpRequest

public static void logHttpRequest(HttpURLConnection conn, OperationContext opContext)

Registra a solicitação HttpURLConnection. Se uma exceção for encontrada, não registrará em log nada.

Parameters:

conn - O HttpURLConnection a ser serializado.
opContext - O contexto de operação que fornece o agente.

logHttpResponse

public static void logHttpResponse(HttpURLConnection conn, OperationContext opContext)

Registra a resposta HttpURLConnection. Se uma exceção for encontrada, não registrará em log nada.

Parameters:

conn - O HttpURLConnection a ser serializado.
opContext - O contexto de operação que fornece o agente.

parseAccountString

public static HashMap parseAccountString(final String parseString)

Analisa uma cadeia de conexão e retorna seus valores como um mapa de hash de pares chave/valor.

Parameters:

parseString - Um String que representa a cadeia de conexão a ser analisada.

Returns:

Um java.util.HashMap objeto que representa o mapa de hash dos pares chave/valor analisados da cadeia de conexão.

parseDate

public static Date parseDate(String dateString)

Dado um String que representa uma data em uma forma do padrão ISO8601, gera uma Data representando-a com precisão de até milissegundos.

Parameters:

dateString - o String a ser interpretado como um Date

Returns:

o objeto correspondente Date

parseDate

public static Date parseDate(String dateString, boolean dateBackwardCompatibility)

Dado um String que representa uma data em uma forma do padrão ISO8601, gera uma Data representando-a com precisão de até milissegundos. Use parseDate(String dateString) em vez disso, a menos que seja necessário.

Veja aqui para obter mais detalhes.

Parameters:

dateString - o String a ser interpretado como um Date
dateBackwardCompatibility -

true para corrigir valores de Data que podem ter sido gravados usando versões desta biblioteca anteriores à 2.0.0; Caso contrário false

Returns:

o objeto correspondente Date

parseRFC1123DateFromStringInGMT

public static Date parseRFC1123DateFromStringInGMT(final String value)

Retorna uma data GMT para a cadeia de caracteres especificada no padrão RFC1123.

Parameters:

value - Um String que representa a cadeia de caracteres a ser analisada.

Returns:

Um Date objeto que representa a data GMT no padrão RFC1123.

Throws:

ParseException - Se a cadeia de caracteres especificada for inválida.

safeDecode

public static String safeDecode(final String stringToDecode)

Executa a decodificação segura da cadeia de caracteres especificada, tendo o cuidado de preservar cada caractere, em vez de substituí-lo por um caractere de espaço.

Parameters:

stringToDecode - Um String que representa a cadeia de caracteres a ser decodificada.

Returns:

Um String que representa a cadeia de caracteres decodificada.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

safeEncode

public static String safeEncode(final String stringToEncode)

Executa a codificação segura da cadeia de caracteres especificada, tendo o cuidado de inserir para cada caractere de espaço, em vez de inserir o caractere.

Parameters:

stringToEncode - Um String que representa a cadeia de caracteres a ser codificada.

Returns:

Um String que representa a cadeia de caracteres codificada.

Throws:

StorageException - Se ocorreu um erro de serviço de armazenamento.

safeRelativize

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

Determina a diferença relativa entre os dois URIs especificados.

Parameters:

baseURI - Um java.net.URI objeto que representa o URI base para o qual toUri será feito relativo.
toUri - Um java.net.URI objeto que representa o URI a ser usado em relação a baseURI.

Returns:

Um String que representa o URI relativo de toUri para baseURIou o URI de toUri si mesmo, dependendo se o nome do host e o esquema são idênticos para toUri e baseURI. Se o nome do host e o esquema de baseURI e toUri forem idênticos, esse método retornará um URI relativo não codificado de modo que, se acrescentado a baseURI, ele produzirá toUri. Se o nome do host ou o esquema de baseURI e toUri não forem idênticos, esse método retornará um URI completo não codificado especificado por toUri.

Throws:

URISyntaxException - Se baseURI ou toUri for inválido.

splitOnPattern

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

Parameters:

array
pattern

stringJoin

public static String stringJoin(CharSequence delimiter, final String... strings)

Equivalente a String.join() no Java 8.

Parameters:

delimiter - Caracteres com os qual unir cadeias de caracteres.
strings - Cadeias de caracteres a serem unidas.

Returns:

A cadeia de caracteres unida.

stringJoin

public static String stringJoin(CharSequence delimiter, Iterable strings)

Equivalente a String.join() no Java 8.

Parameters:

delimiter - Caracteres com os qual unir cadeias de caracteres.
strings - Cadeias de caracteres a serem unidas.

Returns:

A cadeia de caracteres unida.

trimEnd

protected static String trimEnd(final String value, final char trimChar)

Corta o caractere especificado do final de uma cadeia de caracteres.

Parameters:

value - Um String que representa a cadeia de caracteres a ser aparada.
trimChar - O caractere a ser cortado do final da cadeia de caracteres.

Returns:

A cadeia de caracteres com o caractere especificado cortado do final.

trimStart

public static String trimStart(final String value)

Corta o espaço em branco desde o início de uma cadeia de caracteres.

Parameters:

value - Um String que representa a cadeia de caracteres a ser aparada.

Returns:

A cadeia de caracteres com espaço em branco cortado desde o início.

validateMaxExecutionTimeout

public static boolean validateMaxExecutionTimeout(Long operationExpiryTimeInMs)

Retorna um valor que representa se o tempo máximo de execução seria ultrapassado.

Parameters:

operationExpiryTimeInMs - a hora em que a solicitação expira

Returns:

true se o tempo máximo de execução for ultrapassado; caso contrário, false.

validateMaxExecutionTimeout

public static boolean validateMaxExecutionTimeout(Long operationExpiryTimeInMs, long additionalInterval)

Retorna um valor que representa se o tempo máximo de execução seria ultrapassado.

Parameters:

operationExpiryTimeInMs - a hora em que a solicitação expira
additionalInterval - qualquer tempo adicional necessário a partir de agora

Returns:

true se o tempo máximo de execução for ultrapassado; caso contrário, false.

writeToOutputStream

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

Lê dados de um fluxo de entrada e os grava em um fluxo de saída, calcula o comprimento dos dados gravados e, opcionalmente, calcula o hash MD5 para os dados.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de entrada a ser usado como a origem.
outStream - Um OutputStream objeto que representa o fluxo de saída a ser usado como o destino.
writeLength - O número de bytes a serem lidos do fluxo.
rewindSourceStream -

true se o fluxo de entrada deve ser relançado antes de ser lido; Caso contrário false

calculateMD5 -

true se um hash MD5 for calculado; caso contrário, false.

opContext - 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.
options - Um RequestOptions objeto que especifica as opções adicionais para a solicitação. Ou seja, o tempo máximo de execução.

Returns:

Um StreamMd5AndLength objeto que contém o comprimento do fluxo de saída e, opcionalmente, o hash MD5.

Throws:

IOException - Se ocorrer um erro de E/S.
StorageException - Se ocorreu um erro de serviço de armazenamento.

writeToOutputStream

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

Lê dados de um fluxo de entrada e os grava em um fluxo de saída, calcula o comprimento dos dados gravados e, opcionalmente, calcula o hash MD5 para os dados.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de entrada a ser usado como a origem.
outStream - Um OutputStream objeto que representa o fluxo de saída a ser usado como o destino.
writeLength - O número de bytes a serem lidos do fluxo.
rewindSourceStream -

true se o fluxo de entrada deve ser relançado antes de ser lido; Caso contrário false

calculateMD5 -

true se um hash MD5 for calculado; caso contrário, false.

opContext - 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.
options - Um RequestOptions objeto que especifica as opções adicionais para a solicitação. Ou seja, o tempo máximo de execução.
shouldFlush

Returns:

Um StreamMd5AndLength objeto que contém o comprimento do fluxo de saída e, opcionalmente, o hash MD5.

Throws:

IOException - Se ocorrer um erro de E/S.
StorageException - Se ocorreu um erro de serviço de armazenamento.

writeToOutputStream

public static 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 request, StreamMd5AndLength descriptor)

Lê dados de um fluxo de entrada e os grava em um fluxo de saída, calcula o comprimento dos dados gravados e, opcionalmente, calcula o hash MD5 para os dados.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de entrada a ser usado como a origem.
outStream - Um OutputStream objeto que representa o fluxo de saída a ser usado como o destino.
writeLength - O número de bytes a serem lidos do fluxo.
rewindSourceStream -

true se o fluxo de entrada deve ser relançado antes de ser lido; Caso contrário false

calculateMD5 -

true se um hash MD5 for calculado; caso contrário, false.

opContext - 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.
options - Um RequestOptions objeto que especifica as opções adicionais para a solicitação. Ou seja, o tempo máximo de execução.
shouldFlush
request - Usado pelo currículo de download para definir currentRequestByteCount na solicitação. Caso contrário, nulo sempre será usado.
descriptor - Um StreamMd5AndLength objeto ao qual acrescentar no caso de ação de recuperação ou nulo se isso não for chamado de uma recuperação. Esse valor precisa ser passado para recuperação caso parte do corpo já tenha sido lida, a recuperação tentará baixar os bytes restantes, mas fará a validação MD5 no tamanho do intervalo originalmente solicitado.

Returns:

Um StreamMd5AndLength objeto que contém o comprimento do fluxo de saída e, opcionalmente, o hash MD5.

Throws:

IOException - Se ocorrer um erro de E/S.
StorageException - Se ocorreu um erro de serviço de armazenamento.

Aplica-se a