Azure系列2.1.11 —— CloudBlobContainer

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

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

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

Blob 存储的常见用途包括：

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

Package

com.microsoft.azure.storage.blob

Mean

表示Microsoft Azure Blob服务中的一个容器。容器保存目录，这些目录封装为CloudBlobDirectory对象，目录保存块blobs和页面blobs。目录还可以包含子目录。

Inherited 

java.lang.Object ————> CloudBlobContainer

Constructors 

1、CloudBlobContainer(final StorageUri storageUri)

使用指定的URI创建类的实例。blob URI应该包含sa令牌，除非使用匿名访问。

2、CloudBlobContainer(final StorageUri storageUri, final StorageCredentials credentials)

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

3、CloudBlobContainer(final String containerName, final CloudBlobClient client)

使用指定的名称和客户端创建类的实例。

4、CloudBlobContainer(final URI uri)

使用指定的URI创建类的实例。blob URI应该包含sa令牌，除非使用匿名访问。

5、CloudBlobContainer(final URI uri, final StorageCredentials credentials)

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

Fields

metadata:容器的元数据。

Method

public final String acquireLease()

获得一个新的无限租赁的容器。

2.public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId)

在指定的租赁时间和建议的租赁ID下获得新的租赁。

3.public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

以指定的租赁时间、建议的租赁ID、请求选项和操作上下文获取容器的新租赁。

4.public final long breakLease(final Integer breakPeriodInSeconds)

终止租约，并确保另一个客户在当前租约期满之前不能获得新的租约。

5.public final long breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的请求选项和操作上下文终止现有租约，并确保另一个客户端在当前租约期满之前不能获得新的租约。

6.public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition)

将现有的租赁ID更改为建议的租赁ID。

7.public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的访问条件、请求选项和操作上下文将现有的租赁ID更改为建议的租赁ID。

8.public void create()

9.public void create(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext)

10.public void create(BlobRequestOptions options, OperationContext opContext)

11.public boolean createIfNotExists()

12.public boolean createIfNotExists(BlobContainerPublicAccessType accessType, BlobRequestOptions options, OperationContext opContext)

13.public boolean createIfNotExists(BlobRequestOptions options, OperationContext opContext)

14.public void delete()

15.public void delete(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

16.public boolean deleteIfExists()

17.public boolean deleteIfExists(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

18.public void downloadAttributes()、public void downloadAttributes(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

下载容器的属性，其中包含元数据和属性。

19.public BlobContainerPermissions downloadPermissions()、public BlobContainerPermissions downloadPermissions(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

下载容器的权限设置。

20.public boolean exists()、public boolean exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

21.public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier)、public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

返回容器的共享访问签名。注意，这并不包含“?”。

22.public CloudAppendBlob getAppendBlobReference(final String blobName)

返回对CloudAppendBlob对象的引用，该对象表示容器中的append blob。

23.public CloudAppendBlob getAppendBlobReference(final String blobName, final String snapshotID)

返回对CloudAppendBlob对象的引用，该对象使用指定的快照ID表示容器中的append blob。

24.public final CloudBlob getBlobReferenceFromServer(final String blobName)、public final CloudBlob getBlobReferenceFromServer(final String blobName, final String snapshotID, AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

获取对容器中的blob的引用。blob必须已经存在于服务上。与其他的get*Reference方法不同，这个方法执行一个服务请求来检索blob的元数据和属性。返回的blob可以直接用作CloudBlob或使用instanceof或getProperties(). getblobtype()来确定其子类型。

25.public CloudBlockBlob getBlockBlobReference(final String blobName)

返回对表示该容器中的块blob的CloudBlockBlob对象的引用。

26.public CloudBlockBlob getBlockBlobReference(final String blobName, final String snapshotID)

使用指定的快照ID返回对表示该容器中的块blob的CloudBlockBlob对象的引用。

27.public CloudBlobDirectory getDirectoryReference(String directoryName)

返回对CloudBlobDirectory对象的引用，该对象表示容器中的虚拟blob目录。

28.public HashMap<String, String> getMetadata()、public void setMetadata(final HashMap<String, String> metadata)

容器的元数据。该值通过调用downloadAttributes来初始化队列中的元数据，并通过调用uploadMetadata设置在队列上。

29.public String getName()

30.public CloudPageBlob getPageBlobReference(final String blobName)

返回对表示该容器中的页团的CloudPageBlob对象的引用。

31.public CloudPageBlob getPageBlobReference(final String blobName, final String snapshotID)

使用指定的快照ID返回对表示容器中的页blob的CloudPageBlob对象的引用。

32.public BlobContainerProperties getProperties()、protected void setProperties(final BlobContainerProperties properties)

33.public CloudBlobClient getServiceClient()

34.public StorageUri getStorageUri()、protected void setStorageUri(final StorageUri storageUri)

所有位置的uri列表。

35.public URI getUri()

36.public Iterable<ListBlobItem> listBlobs()

返回容器的blob项的可枚举集合。

37.public Iterable<ListBlobItem> listBlobs(final String prefix)

返回名称以指定前缀开头的容器的blob项的可枚举集合。

38.public Iterable<ListBlobItem> listBlobs(final String prefix, final boolean useFlatBlobListing)

返回容器的可枚举blob项集合，该容器的名称以指定的前缀开头，使用指定的平面或层次结构选项。

39.public Iterable<ListBlobItem> listBlobs(final String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, BlobRequestOptions options, OperationContext opContext)

为容器返回一个可枚举集合，其名称以指定的前缀开头，使用指定的平面或分层选项，列出详细信息选项、请求选项和操作上下文。

40.public ResultSegment<ListBlobItem> listBlobsSegmented()

返回容器中可枚举的blob项集合的结果段。

41.public ResultSegment<ListBlobItem> listBlobsSegmented(final String prefix)

返回包含名称以指定前缀开头的blob项集合的结果段。

42.public ResultSegment<ListBlobItem> listBlobsSegmented(final String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, final Integer maxResults, final ResultContinuation continuationToken, BlobRequestOptions options, OperationContext opContext)

返回包含以指定前缀开头的blob项集合的结果段，使用指定的平面或层次结构选项、列出详细信息选项、请求选项和操作上下文。

43.public Iterable<CloudBlobContainer> listContainers()

返回与此容器关联的服务客户机的可枚举容器集合。

44.public Iterable<CloudBlobContainer> listContainers(final String prefix)

返回一个可枚举的容器集合，其名称以与此容器相关联的服务客户机的指定前缀开头。

45.public Iterable<CloudBlobContainer> listContainers(final String prefix, final ContainerListingDetails detailsIncluded, final BlobRequestOptions options, final OperationContext opContext)

返回一个可枚举的容器集合，其名称以与此容器关联的服务客户端指定的前缀开始，使用指定的详细信息设置、请求选项和操作上下文。

46.public ResultSegment<CloudBlobContainer> listContainersSegmented()

返回与此容器关联的服务客户机的可枚举容器集合的结果段。

47.public ResultSegment<CloudBlobContainer> listContainersSegmented(final String prefix)

返回一个可枚举容器集合的结果段，该集合的名称以与此容器相关联的服务客户机的指定前缀开头。

48.public ResultSegment<CloudBlobContainer> listContainersSegmented(final String prefix, final ContainerListingDetails detailsIncluded, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext)

返回一个包含容器集合的结果段，该容器的名称以与此容器关联的服务客户机的指定前缀开头，使用指定的清单细节选项、请求选项和操作上下文。

49.public final void releaseLease(final AccessCondition accessCondition)

释放container。

50.public final void releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的访问条件、请求选项和操作上下文释放container。

51.public final void renewLease(final AccessCondition accessCondition)

使用指定的访问条件更新现有租约。

52.public final void renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

使用指定的访问条件、请求选项和操作上下文更新现有租约。

53.public void uploadMetadata()

54.public void uploadMetadata(AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

55.public void uploadPermissions(final BlobContainerPermissions permissions)

56.public void uploadPermissions(final BlobContainerPermissions permissions, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)