你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CloudAppendBlob 类

包:

com.microsoft.azure.storage.blob

• java.lang.Object
• • ListBlobItem
  • • CloudBlob
    • • com.microsoft.azure.storage.blob.CloudAppendBlob

public class CloudAppendBlob extends CloudBlob

表示 Microsoft Azure 追加 Blob。

构造函数摘要

构造函数	说明
CloudAppendBlob(final CloudAppendBlob otherBlob)	通过从另一个追加 Blob 复制值来创建 类的实例。
CloudAppendBlob(final StorageUri blobAbsoluteUri)	使用指定的绝对 URI 和存储服务客户端创建 类的实例。
CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)	使用指定的绝对 StorageUri 和凭据创建 类的实例。
CloudAppendBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)	使用指定的绝对 StorageUri、快照 ID 和凭据创建 类的实例。
CloudAppendBlob(final URI blobAbsoluteUri)	使用指定的绝对 URI 和存储服务客户端创建 类的实例。
CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)	使用指定的绝对 URI 和凭据创建 类的实例。
CloudAppendBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)	使用指定的绝对 URI、快照 ID 和凭据创建 类的实例。
CloudAppendBlob(String blobName, String snapshotID, CloudBlobContainer container)	使用指定的类型、名称、快照 ID 和容器创建 类的实例。

方法摘要

修饰符和类型	方法和描述
void	append(InputStream sourceStream, final long length) 将流追加到追加 Blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	append(InputStream sourceStream, final long length, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 将流追加到追加 Blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
Long	appendBlock(final InputStream sourceStream, final long length) 将新的数据块提交到 Blob 的末尾。
Long	appendBlock(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 将新的数据块提交到 Blob 的末尾。
Long	appendBlockFromURI(final URI copySource, final Long offset, final Long length) 使用指定的源 URL 追加块。
Long	appendBlockFromURI(final URI copySource, final Long offset, final Long length, String md5, final AccessCondition accessCondition, final AccessCondition sourceAccessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的源 URL 追加块。
void	appendFromByteArray(final byte[] buffer, final int offset, final int length) 将字节数组的内容追加到追加 Blob。应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	appendFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 将字节数组的内容追加到追加 Blob。应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	appendFromFile(final String path) 将文件追加到追加 Blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	appendFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 将文件追加到追加 Blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	appendText(final String content) 使用平台的默认编码将文本字符串追加到追加 blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	appendText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的编码将文本字符串追加到追加 blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	createOrReplace() 创建空追加 Blob。 如果 Blob 已存在，这将替换它。 若要避免覆盖并引发错误，请将重载与相应的 AccessCondition结合使用createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。
void	createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的请求选项和操作上下文创建追加 Blob。 如果 Blob 已存在，这将替换它。 若要避免覆盖并引发错误，请使用 传入 AccessCondition 生成的 generateIfNotExistsCondition()。
BlobOutputStream	openWriteExisting() 打开输出流对象以将数据写入追加 blob。 追加 blob 必须已存在，并将追加到 。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
BlobOutputStream	openWriteExisting(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入追加 blob。 追加 blob 必须已存在，并将追加到 。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
BlobOutputStream	openWriteNew() 打开输出流对象以将数据写入追加 blob。 追加 Blob 尚不需要存在。 如果 Blob 已存在，这将替换它。 若要避免覆盖并引发错误，请将重载与相应的 AccessCondition结合使用openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
BlobOutputStream	openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入追加 blob。 追加 Blob 尚不需要存在。 如果 Blob 已存在，这将替换它。 若要避免覆盖并引发错误，请使用 传入 AccessCondition 生成的 generateIfNotExistsCondition()。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	setStreamWriteSizeInBytes(final int streamWriteSizeInBytes) 设置写入 到 BlobOutputStream时要缓冲的字节数。
final String	startCopy(final CloudAppendBlob sourceBlob) 请求服务开始将追加 Blob 的内容、属性和元数据复制到新的追加 Blob。
final String	startCopy(final CloudAppendBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext) 请求服务使用指定的访问条件、租约 ID、请求选项和操作上下文开始将追加 Blob 的内容、属性和元数据复制到新的追加 Blob。
void	upload(final InputStream sourceStream, final long length) 将源流数据上传到追加 Blob。 如果服务上已存在 Blob，则会覆盖该 Blob。 如果要将数据追加到现有 Blob，请参阅 appendBlock(final InputStream sourceStream, final long length)。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。
void	upload(final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext) 使用指定的租约 ID、请求选项和操作上下文将源流数据上传到追加 Blob。 如果服务上已存在 Blob，则会覆盖该 Blob。 如果要将数据追加到现有 Blob，请参阅 appendBlock(final InputStream sourceStream, final long length)。 如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

继承成员

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)

构造函数详细信息

CloudAppendBlob

public CloudAppendBlob(final CloudAppendBlob otherBlob)

通过从另一个追加 Blob 复制值来创建 类的实例。

Parameters:

otherBlob - 一个 CloudAppendBlob 对象，表示要复制的追加 Blob。

CloudAppendBlob

public CloudAppendBlob(final StorageUri blobAbsoluteUri)

使用指定的绝对 URI 和存储服务客户端创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 StorageUri 对象，表示 Blob 的绝对 URI。

Throws:

StorageException - 如果发生存储服务错误。

CloudAppendBlob

public CloudAppendBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

使用指定的绝对 StorageUri 和凭据创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 StorageUri 对象，表示 Blob 的绝对 URI。

credentials - StorageCredentials用于对访问进行身份验证的对象。

Throws:

StorageException - 如果发生存储服务错误。

CloudAppendBlob

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

使用指定的绝对 StorageUri、快照 ID 和凭据创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 StorageUri 对象，表示 Blob 的绝对 URI。

snapshotID - 一个 String ，表示快照版本（如果适用）。

credentials - StorageCredentials用于对访问进行身份验证的对象。

Throws:

StorageException - 如果发生存储服务错误。

CloudAppendBlob

public CloudAppendBlob(final URI blobAbsoluteUri)

使用指定的绝对 URI 和存储服务客户端创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 java.net.URI 对象，表示 Blob 的绝对 URI。

Throws:

StorageException - 如果发生存储服务错误。

CloudAppendBlob

public CloudAppendBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

使用指定的绝对 URI 和凭据创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 java.net.URI 对象，表示 Blob 的绝对 URI。

credentials - StorageCredentials用于对访问进行身份验证的对象。

Throws:

StorageException - 如果发生存储服务错误。

CloudAppendBlob

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

使用指定的绝对 URI、快照 ID 和凭据创建 类的实例。

Parameters:

blobAbsoluteUri - 一个 java.net.URI 对象，表示 Blob 的绝对 URI。

snapshotID - 一个 String ，表示快照版本（如果适用）。

credentials - StorageCredentials用于对访问进行身份验证的对象。

Throws:

StorageException - 如果发生存储服务错误。

CloudAppendBlob

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

使用指定的类型、名称、快照 ID 和容器创建 类的实例。

Parameters:

blobName - blob 的名称。

snapshotID - 一个 String ，表示快照版本（如果适用）。

container - 对父容器的引用。

Throws:

URISyntaxException - 如果资源 URI 无效。

方法详细信息

append

public void append(InputStream sourceStream, final long length)

将流追加到追加 Blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

sourceStream - 提供 InputStream 要追加的 Blob 内容的 对象。

length - ， long 表示流数据的长度（以字节为单位），如果未知，则为 -1。

Throws:

StorageException - 如果发生存储服务错误。

IOException - 如果发生 I/O 异常。

append

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

将流追加到追加 Blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

sourceStream - 提供 InputStream 要追加的 Blob 内容的 对象。

length - ， long 表示流数据的长度（以字节为单位），如果未知，则为 -1。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

IOException - 如果发生 I/O 异常。

appendBlock

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

将新的数据块提交到 Blob 的末尾。

Parameters:

sourceStream - 一个 InputStream 对象，表示要写入追加 blob 的输入流。

length - ， long 表示流数据的长度（以字节为单位），如果未知，则为 -1。

Returns:

块的追加偏移量。

Throws:

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。

appendBlock

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

将新的数据块提交到 Blob 的末尾。

Parameters:

sourceStream - 一个 InputStream 对象，表示要写入追加 blob 的输入流。

length - ， long 表示流数据的长度（以字节为单位），如果未知，则为 -1。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

块的追加偏移量。

Throws:

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。

appendBlockFromURI

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

使用指定的源 URL 追加块。

Parameters:

copySource - URI源数据的 。 它可以指向任何公共的 Azure Blob 或文件，或者 URL 可以包含共享访问签名。

offset - 一个 ， long 表示用作源起点的偏移量。

length - 一个 ， Long 表示要复制或 null 复制到 Blob 结束的字节数。

Returns:

块的追加偏移量。

Throws:

StorageException - 如果发生存储服务错误。

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)

使用指定的源 URL 追加块。

Parameters:

copySource - URI源数据的 。 它可以指向任何公共的 Azure Blob 或文件，或者 URL 可以包含共享访问签名。

offset - 一个 ， long 表示用作源起点的偏移量。

length - 一个 ， Long 表示要复制或 null 复制到 Blob 结束的字节数。

md5 - 一个 ， String 它表示源字节范围的 MD5 日历。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

sourceAccessCondition - 一个 AccessCondition 对象，表示源 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

块的追加偏移量。

Throws:

StorageException - 如果发生存储服务错误。

appendFromByteArray

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

将字节数组的内容追加到追加 Blob。应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

buffer - 一个 byte 数组，表示要追加到 Blob 的数据。

offset - 一个 ， int 它表示从中开始上传数据的字节数组的偏移量。

length - 一个 int ，表示要从输入缓冲区上传的字节数。

Throws:

StorageException - 如果发生存储服务错误。

IOException - 如果发生 I/O 异常。

appendFromByteArray

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

将字节数组的内容追加到追加 Blob。应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

buffer - 一个 byte 数组，表示要追加到 Blob 的数据。

offset - 一个 ， int 它表示从中开始上传数据的字节数组的偏移量。

length - 一个 int ，表示要从输入缓冲区上传的字节数。

accessCondition - 一个表示 Blob 访问条件的 AccessCondition 对象。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

IOException - 如果发生 I/O 异常。

appendFromFile

public void appendFromFile(final String path)

将文件追加到追加 Blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

path - ， String 它表示要追加的文件的路径。

Throws:

StorageException - 如果发生存储服务错误。

IOException - 如果发生 I/O 异常。

appendFromFile

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

将文件追加到追加 Blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

path - ， String 它表示要追加的文件的路径。

accessCondition - 一个表示 Blob 访问条件的 AccessCondition 对象。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

IOException - 如果发生 I/O 异常。

appendText

public void appendText(final String content)

使用平台的默认编码将文本字符串追加到追加 blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

content - 一个 String ，表示将追加到 Blob 的内容。

Throws:

StorageException - 如果发生存储服务错误。

IOException - 如果发生 I/O 异常。

appendText

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

使用指定的编码将文本字符串追加到追加 blob。 应在单个编写器方案中严格使用此 API，因为 API 在内部使用 append-offset 条件标头，以避免在多编写器方案中不起作用的重复块。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

content - 一个 String ，表示将追加到 Blob 的内容。

charsetName - 一个 ， String 表示用于对内容进行编码的字符集的名称。 如果为 null，则使用平台的默认编码。

accessCondition - 一个表示 Blob 访问条件的 AccessCondition 对象。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

IOException - 如果发生 I/O 异常。

createOrReplace

public void createOrReplace()

创建空追加 Blob。 如果 Blob 已存在，这将替换它。

若要避免覆盖并引发错误，请将重载与相应的 AccessCondition结合使用createOrReplace(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。

Throws:

StorageException - 如果发生存储服务错误。

createOrReplace

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

使用指定的请求选项和操作上下文创建追加 Blob。 如果 Blob 已存在，这将替换它。

若要避免覆盖并引发错误，请使用 传入 AccessCondition 生成的 generateIfNotExistsCondition()。

Parameters:

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

StorageException - 如果发生存储服务错误。

openWriteExisting

public BlobOutputStream openWriteExisting()

打开输出流对象以将数据写入追加 blob。 追加 blob 必须已存在，并将追加到 。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

openWriteExisting

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

使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入追加 blob。 追加 blob 必须已存在，并将追加到 。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

openWriteNew

public BlobOutputStream openWriteNew()

打开输出流对象以将数据写入追加 blob。 追加 Blob 尚不需要存在。 如果 Blob 已存在，这将替换它。

若要避免覆盖并引发错误，请将重载与相应的 AccessCondition结合使用openWriteNew(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

openWriteNew

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

使用指定的租约 ID、请求选项和操作上下文打开输出流对象以将数据写入追加 blob。 追加 Blob 尚不需要存在。 如果 Blob 已存在，这将替换它。

若要避免覆盖并引发错误，请使用 传入 AccessCondition 生成的 generateIfNotExistsCondition()。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

BlobOutputStream用于将数据写入 Blob 的 对象。

Throws:

StorageException - 如果发生存储服务错误。

setStreamWriteSizeInBytes

public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

设置写入 到 BlobOutputStream时要缓冲的字节数。

Parameters:

streamWriteSizeInBytes - ， int 表示在使用 BlobOutputStream 对象时写入追加 blob 的最大块大小（以字节为单位），范围为 16 KB 到 4 MB（含）。

Throws:

IllegalArgumentException - 如果 streamWriteSizeInBytes 小于 16 KB 或大于 4 MB。

startCopy

public final String startCopy(final CloudAppendBlob sourceBlob)

请求服务开始将追加 Blob 的内容、属性和元数据复制到新的追加 Blob。

Parameters:

sourceBlob - 一个 CloudAppendBlob 对象，表示要复制的源 Blob。

Returns:

一个 String ，表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

startCopy

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

请求服务使用指定的访问条件、租约 ID、请求选项和操作上下文开始将追加 Blob 的内容、属性和元数据复制到新的追加 Blob。

Parameters:

sourceBlob - 一个 CloudAppendBlob 对象，表示要复制的源 Blob。

sourceAccessCondition - 一个 AccessCondition 对象，表示源 Blob 的访问条件。

destinationAccessCondition - 一个 AccessCondition 对象，表示目标 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Returns:

一个 String ，表示与复制操作关联的复制 ID。

Throws:

StorageException - 如果发生存储服务错误。

URISyntaxException

upload

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

将源流数据上传到追加 Blob。 如果服务上已存在 Blob，则会覆盖该 Blob。

如果要将数据追加到现有 Blob，请参阅 appendBlock(final InputStream sourceStream, final long length)。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

sourceStream - 要 InputStream 从中读取的对象。

length - ， long 表示流数据的长度（以字节为单位），如果未知，则为 -1。

Throws:

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。

upload

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

使用指定的租约 ID、请求选项和操作上下文将源流数据上传到追加 Blob。 如果服务上已存在 Blob，则会覆盖该 Blob。

如果要将数据追加到现有 Blob，请参阅 appendBlock(final InputStream sourceStream, final long length)。

如果在单个编写器方案中执行写入，请查看 setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) 并查看将此标志设置为 是否可接受。

Parameters:

sourceStream - 要 InputStream 从中读取的对象。

length - ， long 表示流数据的长度（以字节为单位），如果未知，则为 -1。

accessCondition - 一个 AccessCondition 对象，表示 Blob 的访问条件。

options - 一个 BlobRequestOptions 对象，该对象指定请求的任何其他选项。 指定 null 将使用关联服务客户端 ( CloudBlobClient) 的默认请求选项。

opContext - 一个 OperationContext 对象，表示当前操作的上下文。 此对象用于跟踪对存储服务的请求并提供有关操作的其他运行时信息。

Throws:

IOException - 如果发生 I/O 异常。

StorageException - 如果发生存储服务错误。