Compartilhar via

CloudAppendBlob Classe

  • Referência
Pacote:
com.microsoft.azure.storage.blob

public class CloudAppendBlob extends CloudBlob

Representa um Blob de Acréscimo do Microsoft Azure.

Resumo do Construtor

Construtor Description
CloudAppendBlob(final CloudAppendBlob otherBlob)

Cria uma instância da classe copiando valores de outro blob de acréscimo.
CloudAppendBlob(final StorageUri blobAbsoluteUri)

Cria uma instância da classe usando o URI absoluto especificado e o cliente de serviço de armazenamento.
CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

Cria uma instância da classe usando o StorageUri absoluto e as credenciais especificados.
CloudAppendBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Cria uma instância da classe usando o StorageUri absoluto especificado, instantâneo ID e credenciais.
CloudAppendBlob(final URI blobAbsoluteUri)

Cria uma instância da classe usando o URI absoluto especificado e o cliente de serviço de armazenamento.
CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

Cria uma instância da classe usando o URI e as credenciais absolutas especificados.
CloudAppendBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Cria uma instância da classe usando o URI absoluto especificado, instantâneo ID e credenciais.
CloudAppendBlob(String blobName, String snapshotID, CloudBlobContainer container)

Cria uma instância da classe usando o tipo, o nome, a ID de instantâneo e o contêiner especificados.

Resumo do método

Modificador e tipo Método e descrição
void append(InputStream sourceStream, final long length)

Acrescenta um fluxo a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void append(InputStream sourceStream, final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta um fluxo a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
Long appendBlock(final InputStream sourceStream, final long length)

Confirma um novo bloco de dados no final do blob.
Long appendBlock(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Confirma um novo bloco de dados no final do blob.
Long appendBlockFromURI(final URI copySource, final Long offset, final Long length)

Acrescenta um bloco, usando a URL de origem especificada.
Long appendBlockFromURI(final URI copySource, final Long offset, final Long length, String md5, final AccessCondition accessCondition, final AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta um bloco, usando a URL de origem especificada.
void appendFromByteArray(final byte[] buffer, final int offset, final int length)

Acrescenta o conteúdo de uma matriz de bytes a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void appendFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta o conteúdo de uma matriz de bytes a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void appendFromFile(final String path)

Acrescenta um arquivo a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void appendFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta um arquivo a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void appendText(final String content)

Acrescenta uma cadeia de caracteres de texto a um blob de acréscimo usando a codificação padrão da plataforma. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void appendText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta uma cadeia de caracteres de texto a um blob de acréscimo usando a codificação especificada. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional append-offset para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void createOrReplace()

Cria um blob de acréscimo vazio. Se o blob já existir, isso o substituirá.

Para evitar a substituição e, em vez disso, gerar um erro, use a createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) sobrecarga com o apropriado AccessCondition.
void createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Cria um blob de acréscimo usando as opções de solicitação e o contexto de operação especificados. Se o blob já existir, isso o substituirá.

Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().
BlobOutputStream openWriteExisting()

Abre um objeto de fluxo de saída para gravar dados no blob de acréscimo. O blob de acréscimo já deve existir e será acrescentado a.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um objeto de fluxo de saída para gravar dados no blob de acréscimo, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de acréscimo já deve existir e será acrescentado a.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
BlobOutputStream openWriteNew()

Abre um objeto de fluxo de saída para gravar dados no blob de acréscimo. O blob de acréscimo ainda não precisa existir. Se o blob já existir, isso o substituirá.

Para evitar a substituição e, em vez disso, gerar um erro, use a openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) sobrecarga com o apropriado AccessCondition.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
BlobOutputStream openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um objeto de fluxo de saída para gravar dados no blob de acréscimo, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de acréscimo ainda não precisa existir. Se o blob já existir, isso o substituirá.

Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

Define o número de bytes a serem armazenados em buffer ao gravar em um BlobOutputStream.
final String startCopy(final CloudAppendBlob sourceBlob)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um blob de acréscimo para um novo blob de acréscimo.
final String startCopy(final CloudAppendBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um blob de acréscimo para um novo blob de acréscimo, usando as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados.
void upload(final InputStream sourceStream, final long length)

Carrega os dados de fluxo de origem para o blob de acréscimo. Se o blob já existir no serviço, ele será substituído.

Se você quiser acrescentar dados a um blob já existente, consulte appendBlock(final InputStream sourceStream, final long length).

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.
void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega os dados do fluxo de origem para o blob de acréscimo usando a ID de concessão, as opções de solicitação e o contexto de operação especificados. Se o blob já existir no serviço, ele será substituído.

Se você quiser acrescentar dados a um blob já existente, consulte appendBlock(final InputStream sourceStream, final long length).

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Membros herdados

CloudBlob.abortCopy(final String copyId) CloudBlob.abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.acquireLease() CloudBlob.acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId) CloudBlob.acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.assertCorrectBlobType() CloudBlob.assertNoWriteOperationForSnapshot() CloudBlob.blobServiceClient CloudBlob.breakLease(final Integer breakPeriodInSeconds) CloudBlob.breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.changeLease(final String proposedLeaseId, final AccessCondition accessCondition) CloudBlob.changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container) CloudBlob.CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials) CloudBlob.CloudBlob(final CloudBlob otherBlob) CloudBlob.createSnapshot() CloudBlob.createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.delete() CloudBlob.delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.deleteIfExists() CloudBlob.deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.download(final OutputStream outStream) CloudBlob.download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadAccountInfo() CloudBlob.downloadAccountInfo(BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadAccountInformationImpl(final RequestOptions options) CloudBlob.downloadAttributes() CloudBlob.downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRange(final long offset, final Long length, final OutputStream outStream) CloudBlob.downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset) CloudBlob.downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadToByteArray(final byte[] buffer, final int bufferOffset) CloudBlob.downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.downloadToFile(final String path) CloudBlob.downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.exists() CloudBlob.exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols) CloudBlob.generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding) CloudBlob.generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy) CloudBlob.generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols) CloudBlob.getContainer() CloudBlob.getCopyState() CloudBlob.getMetadata() CloudBlob.getName() CloudBlob.getParent() CloudBlob.getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container) CloudBlob.getProperties() CloudBlob.getQualifiedStorageUri() CloudBlob.getQualifiedUri() CloudBlob.getServiceClient() CloudBlob.getSnapshotID() CloudBlob.getSnapshotQualifiedStorageUri() CloudBlob.getSnapshotQualifiedUri() CloudBlob.getStorageUri() CloudBlob.getStreamMinimumReadSizeInBytes() CloudBlob.getStreamWriteSizeInBytes() CloudBlob.getTransformedAddress(final OperationContext opContext) CloudBlob.getUri() CloudBlob.isSnapshot() CloudBlob.openInputStream() CloudBlob.openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.parent CloudBlob.releaseLease(final AccessCondition accessCondition) CloudBlob.releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.renewLease(final AccessCondition accessCondition) CloudBlob.renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.setContainer(final CloudBlobContainer container) CloudBlob.setMetadata(final HashMap<String, String> metadata) CloudBlob.setProperties(final BlobProperties properties) CloudBlob.setSnapshotID(final String snapshotID) CloudBlob.setStorageUri(final StorageUri storageUri) CloudBlob.setStreamMinimumReadSizeInBytes(final int minimumReadSize) CloudBlob.startCopy(final URI source) CloudBlob.startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options) CloudBlob.streamMinimumReadSizeInBytes CloudBlob.streamWriteSizeInBytes CloudBlob.undelete() CloudBlob.undelete(BlobRequestOptions options, OperationContext opContext) CloudBlob.updateEtagAndLastModifiedFromResponse(HttpURLConnection request) CloudBlob.updateLengthFromResponse(HttpURLConnection request) CloudBlob.uploadFromByteArray(final byte[] buffer, final int offset, final int length) CloudBlob.uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadFromFile(final String path) CloudBlob.uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadMetadata() CloudBlob.uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.uploadProperties() CloudBlob.uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) CloudBlob.validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload)

Detalhes do construtor

CloudAppendBlob

public CloudAppendBlob(final CloudAppendBlob otherBlob)

Cria uma instância da classe copiando valores de outro blob de acréscimo.

Parameters:

otherBlob - Um CloudAppendBlob objeto que representa o blob de acréscimo a ser copiado.

CloudAppendBlob

public CloudAppendBlob(final StorageUri blobAbsoluteUri)

Cria uma instância da classe usando o URI absoluto especificado e o cliente de serviço de armazenamento.

Parameters:

blobAbsoluteUri - Um StorageUri objeto que representa o URI absoluto para o blob.

Throws:

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

CloudAppendBlob

public CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

Cria uma instância da classe usando o StorageUri absoluto e as credenciais especificados.

Parameters:

blobAbsoluteUri - Um StorageUri objeto que representa o URI absoluto para o blob.
credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

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

CloudAppendBlob

public CloudAppendBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Cria uma instância da classe usando o StorageUri absoluto especificado, instantâneo ID e credenciais.

Parameters:

blobAbsoluteUri - Um StorageUri objeto que representa o URI absoluto para o blob.
snapshotID - Um String que representa a versão instantâneo, se aplicável.
credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

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

CloudAppendBlob

public CloudAppendBlob(final URI blobAbsoluteUri)

Cria uma instância da classe usando o URI absoluto especificado e o cliente de serviço de armazenamento.

Parameters:

blobAbsoluteUri - Um java.net.URI objeto que representa o URI absoluto para o blob.

Throws:

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

CloudAppendBlob

public CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

Cria uma instância da classe usando o URI e as credenciais absolutas especificados.

Parameters:

blobAbsoluteUri - Um java.net.URI objeto que representa o URI absoluto para o blob.
credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

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

CloudAppendBlob

public CloudAppendBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

Cria uma instância da classe usando o URI absoluto especificado, instantâneo ID e credenciais.

Parameters:

blobAbsoluteUri - Um java.net.URI objeto que representa o URI absoluto para o blob.
snapshotID - Um String que representa a versão instantâneo, se aplicável.
credentials - Um StorageCredentials objeto usado para autenticar o acesso.

Throws:

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

CloudAppendBlob

protected CloudAppendBlob(String blobName, String snapshotID, CloudBlobContainer container)

Cria uma instância da classe usando o tipo, o nome, a ID de instantâneo e o contêiner especificados.

Parameters:

blobName - O nome do blob.
snapshotID - Um String que representa a versão instantâneo, se aplicável.
container - A referência ao contêiner pai.

Throws:

URISyntaxException - Se o URI do recurso for inválido.

Detalhes do método

append

public void append(InputStream sourceStream, final long length)

Acrescenta um fluxo a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

sourceStream - Um InputStream objeto que fornece o conteúdo do blob a ser acrescentado.
length - Um long que representa o comprimento, em bytes, dos dados de fluxo ou -1, se desconhecido.

Throws:

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

append

public void append(InputStream sourceStream, final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta um fluxo a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

sourceStream - Um InputStream objeto que fornece o conteúdo do blob a ser acrescentado.
length - Um long que representa o comprimento, em bytes, dos dados de fluxo ou -1, se desconhecido.
accessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um OperationContext objeto 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.

Throws:

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

appendBlock

public Long appendBlock(final InputStream sourceStream, final long length)

Confirma um novo bloco de dados no final do blob.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de entrada a ser gravado no blob de acréscimo.
length - Um long que representa o comprimento, em bytes, dos dados de fluxo ou -1, se desconhecido.

Returns:

O deslocamento no qual o bloco foi acrescentado.

Throws:

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

appendBlock

public Long appendBlock(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Confirma um novo bloco de dados no final do blob.

Parameters:

sourceStream - Um InputStream objeto que representa o fluxo de entrada a ser gravado no blob append.
length - Um long que representa o comprimento, em bytes, dos dados de fluxo ou -1, se desconhecido.
accessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um OperationContext objeto 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.

Returns:

O deslocamento no qual o bloco foi acrescentado.

Throws:

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

appendBlockFromURI

public Long appendBlockFromURI(final URI copySource, final Long offset, final Long length)

Acrescenta um bloco, usando a URL de origem especificada.

Parameters:

copySource - O URI dos dados de origem. Ele pode apontar para qualquer Blob ou Arquivo do Azure público ou a URL pode incluir uma assinatura de acesso compartilhado.
offset - Um long que representa o deslocamento a ser usado como ponto de partida para a origem.
length - Um Long que representa o número de bytes a serem copiados ou null copiados até o final do blob.

Returns:

O deslocamento no qual o bloco foi acrescentado.

Throws:

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

appendBlockFromURI

public Long appendBlockFromURI(final URI copySource, final Long offset, final Long length, String md5, final AccessCondition accessCondition, final AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta um bloco, usando a URL de origem especificada.

Parameters:

copySource - O URI dos dados de origem. Ele pode apontar para qualquer Blob ou Arquivo do Azure público ou a URL pode incluir uma assinatura de acesso compartilhado.
offset - Um long que representa o deslocamento a ser usado como ponto de partida para a origem.
length - Um Long que representa o número de bytes a serem copiados ou null copiados até o final do blob.
md5 - Um String que representa o MD5 caluclated para o intervalo de bytes da origem.
accessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob.
sourceAccessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob de origem.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um OperationContext objeto 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.

Returns:

O deslocamento no qual o bloco foi acrescentado.

Throws:

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

appendFromByteArray

public void appendFromByteArray(final byte[] buffer, final int offset, final int length)

Acrescenta o conteúdo de uma matriz de bytes a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

buffer - Uma byte matriz que representa os dados a serem acrescentados ao blob.
offset - Um int que representa o deslocamento da matriz de bytes da qual iniciar o carregamento de dados.
length - Um int que representa o número de bytes a serem carregados do buffer de entrada.

Throws:

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

appendFromByteArray

public void appendFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta o conteúdo de uma matriz de bytes a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

buffer - Uma byte matriz que representa os dados a serem acrescentados ao blob.
offset - Um int que representa o deslocamento da matriz de bytes da qual iniciar o carregamento de dados.
length - Um int que representa o número de bytes a serem carregados do buffer de entrada.
accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
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.

Throws:

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

appendFromFile

public void appendFromFile(final String path)

Acrescenta um arquivo a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

path - Um String que representa o caminho para o arquivo a ser acrescentado.

Throws:

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

appendFromFile

public void appendFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta um arquivo a um blob de acréscimo. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

path - Um String que representa o caminho para o arquivo a ser acrescentado.
accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
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.

Throws:

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

appendText

public void appendText(final String content)

Acrescenta uma cadeia de caracteres de texto a um blob de acréscimo usando a codificação padrão da plataforma. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional de deslocamento de acréscimo para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

content - Um String que representa o conteúdo que será acrescentado ao blob.

Throws:

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

appendText

public void appendText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acrescenta uma cadeia de caracteres de texto a um blob de acréscimo usando a codificação especificada. Essa API deve ser usada estritamente em um único cenário de gravador porque a API usa internamente o cabeçalho condicional append-offset para evitar blocos duplicados que não funcionam em um cenário de gravador múltiplo.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

content - Um String que representa o conteúdo que será acrescentado ao blob.
charsetName - Um String que representa o nome do conjunto de caracteres a ser usado para codificar o conteúdo. Se for nulo, a codificação padrão da plataforma será usada.
accessCondition - Um objeto AccessCondition que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
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.

Throws:

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

createOrReplace

public void createOrReplace()

Cria um blob de acréscimo vazio. Se o blob já existir, isso o substituirá.

Para evitar a substituição e, em vez disso, gerar um erro, use a createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) sobrecarga com o apropriado AccessCondition.

Throws:

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

createOrReplace

public void createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Cria um blob de acréscimo usando as opções de solicitação e o contexto de operação especificados. Se o blob já existir, isso o substituirá.

Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().

Parameters:

accessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um OperationContext objeto 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.

Throws:

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

openWriteExisting

public BlobOutputStream openWriteExisting()

Abre um objeto de fluxo de saída para gravar dados no blob de acréscimo. O blob de acréscimo já deve existir e será acrescentado a.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Returns:

Um BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

openWriteExisting

public BlobOutputStream openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um objeto de fluxo de saída para gravar dados no blob de acréscimo, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de acréscimo já deve existir e será acrescentado a.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

accessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um OperationContext objeto 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.

Returns:

Um BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

openWriteNew

public BlobOutputStream openWriteNew()

Abre um objeto de fluxo de saída para gravar dados no blob de acréscimo. O blob de acréscimo ainda não precisa existir. Se o blob já existir, isso o substituirá.

Para evitar a substituição e, em vez disso, gerar um erro, use a openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) sobrecarga com o apropriado AccessCondition.

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Returns:

Um BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

openWriteNew

public BlobOutputStream openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Abre um objeto de fluxo de saída para gravar dados no blob de acréscimo, usando a ID de concessão especificada, as opções de solicitação e o contexto de operação. O blob de acréscimo ainda não precisa existir. Se o blob já existir, isso o substituirá.

Para evitar a substituição e, em vez disso, gerar um erro, passe um AccessCondition gerado usando generateIfNotExistsCondition().

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

accessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um OperationContext objeto 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.

Returns:

Um BlobOutputStream objeto usado para gravar dados no blob.

Throws:

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

setStreamWriteSizeInBytes

public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

Define o número de bytes a serem armazenados em buffer ao gravar em um BlobOutputStream.

Parameters:

streamWriteSizeInBytes - Um int que representa o tamanho máximo do bloco, em bytes, para gravação em um blob de acréscimo ao usar um BlobOutputStream objeto , variando de 16 KB a 4 MB, inclusive.

Throws:

IllegalArgumentException - Se streamWriteSizeInBytes for menor que 16 KB ou maior que 4 MB.

startCopy

public final String startCopy(final CloudAppendBlob sourceBlob)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um blob de acréscimo para um novo blob de acréscimo.

Parameters:

sourceBlob - Um CloudAppendBlob objeto que representa o blob de origem a ser copiado.

Returns:

Um String que representa a ID de cópia associada à operação de cópia.

Throws:

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

startCopy

public final String startCopy(final CloudAppendBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Solicita que o serviço comece a copiar o conteúdo, as propriedades e os metadados de um blob de acréscimo para um novo blob de acréscimo, usando as condições de acesso, a ID de concessão, as opções de solicitação e o contexto de operação especificados.

Parameters:

sourceBlob - Um CloudAppendBlob objeto que representa o blob de origem a ser copiado.
sourceAccessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob de origem.
destinationAccessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob de destino.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
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.

Returns:

Um String que representa a ID de cópia associada à operação de cópia.

Throws:

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

upload

public void upload(final InputStream sourceStream, final long length)

Carrega os dados de fluxo de origem para o blob de acréscimo. Se o blob já existir no serviço, ele será substituído.

Se você quiser acrescentar dados a um blob já existente, consulte appendBlock(final InputStream sourceStream, final long length).

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

sourceStream - Um InputStream objeto do qual ler.
length - Um long que representa o comprimento, em bytes, dos dados de fluxo ou -1, se desconhecido.

Throws:

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

upload

public void upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Carrega os dados do fluxo de origem para o blob de acréscimo usando a ID de concessão, as opções de solicitação e o contexto de operação especificados. Se o blob já existir no serviço, ele será substituído.

Se você quiser acrescentar dados a um blob já existente, consulte appendBlock(final InputStream sourceStream, final long length).

Se você estiver fazendo gravações em um único cenário de gravador, examine setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) e veja se definir esse sinalizador como é aceitável para você.

Parameters:

sourceStream - Um InputStream objeto do qual ler.
length - Um long que representa o comprimento, em bytes, dos dados de fluxo ou -1, se desconhecido.
accessCondition - Um AccessCondition objeto que representa as condições de acesso para o blob.
options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. Especificar null usará as opções de solicitação padrão do cliente de serviço associado ( CloudBlobClient).
opContext - Um OperationContext objeto 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.

Throws:

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

Aplica-se a