Azure系列2.1.13 —— CloudBlockBlob

（小弟自学Azure，文中有不正确之处，请路过各位大神指正。）

网上azure的资料较少，尤其是API，全是英文的，中文资料更是少之又少。这次由于公司项目需要使用Azure，所以对Azure的一些学习心得做下笔记，文中不正确地方请大家指正。

Azure Blob 存储是用于存储大量非结构化对象数据（例如文本或二进制数据）的服务，这些数据可通过 HTTP 或 HTTPS 从世界各地进行访问。 可以使用 Blob 存储向外公开数据，或者私下存储应用程序数据。

Blob 存储的常见用途包括：

• 直接向浏览器提供图像或文档
• 存储文件以供分布式访问
• 对视频和音频进行流式处理
• 存储数据以用于备份和还原、灾难恢复及存档
• 存储数据以供本地或 Azure 托管服务执行分析

Package

com.microsoft.azure.storage.blob

Mean

block blob。

Inherited 

java.lang.Object ——> ListBlobItem ——> CloudBlob ——> CloudBlockBlob

Constructors 

1、CloudBlockBlob(final CloudBlockBlob otherBlob)

2、CloudBlockBlob(final StorageUri blobAbsoluteUri)

3、CloudBlockBlob(final StorageUri blobAbsoluteUri, final StorageCredentials credentials)

4、CloudBlockBlob(final StorageUri blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

5、CloudBlockBlob(final URI blobAbsoluteUri)

6、CloudBlockBlob(final URI blobAbsoluteUri, final StorageCredentials credentials)

7、CloudBlockBlob(final URI blobAbsoluteUri, final String snapshotID, final StorageCredentials credentials)

8、CloudBlockBlob(String blobName, String snapshotID, CloudBlobContainer container)

Method

1.public void commitBlockList(final Iterable<BlockEntry> blockList)

2.public void commitBlockList(final Iterable<BlockEntry> blockList, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的租赁ID、请求选项和操作上下文将块列表提交给存储服务。为了作为blob的一部分写入，必须在之前的uploadBlock操作中成功地将块写入服务器。

3.public ArrayList<BlockEntry> downloadBlockList()

4.public ArrayList<BlockEntry> downloadBlockList(final BlockListingFilter blockListingFilter, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

从块blob下载提交的块列表。提交块列表包含已成功提交到块blob的块的列表。提交块的列表以它们提交给blob的顺序返回。在提交的块列表中，没有任何块可能出现不止一次。

5.public String downloadText()

6.public String downloadText(final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用平台的默认编码将blob下载到字符串。

7.public boolean isStreamWriteSizeModified()

获取指示是否修改了默认streamWriteSize的标志。

8.public BlobOutputStream openOutputStream()

创建并打开输出流，将数据写入块blob。如果blob已经存在于服务上，那么它将被覆盖。为了避免重写并抛出错误，请使用openOutputStream(AccessCondition, BlobRequestOptions, OperationContext)重载带有适当的AccessCondition。

9.public BlobOutputStream openOutputStream(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

创建并打开一个输出流，使用指定的请求选项和操作上下文将数据写入块blob。如果blob已经存在于服务上，那么它将被覆盖。为了避免重写并抛出错误，请传入使用AccessCondition#generateIfNotExistsCondition()生成的AccessCondition。

10.public void setStreamWriteSizeInBytes(final int streamWriteSizeInBytes)

在写入BlobOutputStream时设置缓冲区的字节数。

11.public final String startCopy(final CloudBlockBlob sourceBlob)

12.public final String startCopy(final CloudBlockBlob sourceBlob, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

13.public final String startCopy(final CloudFile sourceFile)

14.public final String startCopy(final CloudFile sourceFile, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

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

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

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

将源流数据上传到块blob。如果blob已经存在于服务上，那么它将被覆盖。

17.public void uploadBlock(final String blockId, final InputStream sourceStream, final long length)

18.public void uploadBlock(final String blockId, final InputStream sourceStream, final long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的块ID将提交的块作为块blob的一部分进行上产。

19.protected final void uploadFullBlob(final InputStream sourceStream, final long length, final AccessCondition accessCondition, final BlobRequestOptions options, final OperationContext opContext)

在一个操作中上传一个blob。

20.public void uploadStandardBlobTier(final StandardBlobTier standardBlobTier)

21.public void uploadStandardBlobTier(final StandardBlobTier standardBlobTier, BlobRequestOptions options, OperationContext opContext)

在标准存储帐户上的块blob上设置blob层。

22.public void uploadText(final String content)

23.public void uploadText(final String content, final String charsetName, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用平台的默认编码从字符串上传blob。如果blob已经存在于服务上，那么它将被覆盖。