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

CloudBlobDirectory 类

包:

com.microsoft.azure.storage.blob

• java.lang.Object
• • ListBlobItem
  • • com.microsoft.azure.storage.blob.CloudBlobDirectory

public class CloudBlobDirectory implements ListBlobItem

表示由分隔符指定的 Blob 虚拟目录。

容器，封装为 CloudBlobContainer 对象，其中包含目录，目录中包含块 Blob 和页 Blob。 目录还可以包含子目录。

构造函数摘要

构造函数	说明
CloudBlobDirectory(final StorageUri uri, final String prefix, final CloudBlobClient client, final CloudBlobContainer container)	使用指定的地址、目录父级和客户端创建 类的实例。
CloudBlobDirectory(final StorageUri uri, final String prefix, final CloudBlobClient client, final CloudBlobContainer container, final CloudBlobDirectory parent)	使用指定的地址、目录父级和客户端创建 类的实例。

方法摘要

修饰符和类型	方法和描述
CloudAppendBlob	getAppendBlobReference(final String blobName) 返回对 CloudAppendBlob 对象的引用，该对象表示目录中的追加 Blob。
CloudAppendBlob	getAppendBlobReference(final String blobName, final String snapshotID) 使用指定的快照 ID 返回对 CloudAppendBlob 表示目录中追加 blob 的 对象的引用。
CloudBlockBlob	getBlockBlobReference(final String blobName) 返回对 CloudBlockBlob 对象的引用，该对象表示此目录中的块 Blob。
CloudBlockBlob	getBlockBlobReference(final String blobName, final String snapshotID) 使用指定的快照 ID 返回对CloudBlockBlob表示此目录中的块 Blob 的 对象的引用。
CloudBlobContainer	getContainer() 返回此目录的容器。
CloudBlobDirectory	getDirectoryReference(String directoryName) 返回对此目录下的虚拟 Blob 目录的引用。
CloudPageBlob	getPageBlobReference(final String blobName) 返回对 CloudPageBlob 对象的引用，该对象表示目录中的页 Blob。
CloudPageBlob	getPageBlobReference(final String blobName, final String snapshotID) 使用指定的快照 ID 返回对 CloudPageBlob 表示目录中页 Blob 的 对象的引用。
CloudBlobDirectory	getParent() 返回此目录的父目录。
String	getPrefix() 返回此目录的前缀。
CloudBlobClient	getServiceClient() 返回与此目录关联的 Blob 服务客户端。
final StorageUri	getStorageUri() 返回所有位置的 URI 列表。
URI	getUri() 返回此目录的 URI。
Iterable<ListBlobItem>	listBlobs() 返回目录的 Blob 项的可枚举集合。
Iterable<ListBlobItem>	listBlobs(String prefix) 返回 Blob 项的可枚举集合，其名称以目录的指定前缀开头。
Iterable<ListBlobItem>	listBlobs(String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, final BlobRequestOptions options, final OperationContext opContext) 使用指定的平面或分层选项、列出详细信息选项、请求选项和操作上下文，返回其名称以指定前缀开头的 Blob 项的可枚举集合。
ResultSegment<ListBlobItem>	listBlobsSegmented() 返回目录中 Blob 项的可枚举集合的结果段。
ResultSegment<ListBlobItem>	listBlobsSegmented(String prefix) 返回一个结果段，其中包含其名称以指定前缀开头的 Blob 项的集合。
ResultSegment<ListBlobItem>	listBlobsSegmented(String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext) 返回一个结果段，其中包含名称以指定前缀开头、使用指定的平面或分层选项、列出详细信息选项、请求选项和操作上下文的 Blob 项集合。

构造函数详细信息

CloudBlobDirectory

protected CloudBlobDirectory(final StorageUri uri, final String prefix, final CloudBlobClient client, final CloudBlobContainer container)

使用指定的地址、目录父级和客户端创建 类的实例。

Parameters:

uri - 一个 StorageUri ，它表示 Blob 目录的地址。

prefix - 一个 String ，它表示 Blob 目录的前缀。

client - 表示 CloudBlobClient 关联的服务客户端的 对象。

container

CloudBlobDirectory

protected CloudBlobDirectory(final StorageUri uri, final String prefix, final CloudBlobClient client, final CloudBlobContainer container, final CloudBlobDirectory parent)

使用指定的地址、目录父级和客户端创建 类的实例。

Parameters:

uri - 一个 StorageUri ，它表示 Blob 目录的地址。

prefix - 一个 String ，它表示 Blob 目录的前缀。

client - 表示 CloudBlobClient 关联的服务客户端的 对象。

container

parent - 一个 CloudBlobDirectory 表示父目录（如果适用）的 对象。

方法详细信息

getAppendBlobReference

public CloudAppendBlob getAppendBlobReference(final String blobName)

返回对 CloudAppendBlob 对象的引用，该对象表示目录中的追加 Blob。

Parameters:

blobName - 一个 String ，表示 Blob 的名称。

Returns:

一个 CloudAppendBlob 对象，表示对指定追加 blob 的引用。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getAppendBlobReference

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

使用指定的快照 ID 返回对 CloudAppendBlob 表示目录中追加 blob 的 对象的引用。

Parameters:

blobName - 一个 String ，表示 Blob 的名称。

snapshotID - 一个 String ，表示 blob 的快照 ID。

Returns:

一个 CloudAppendBlob 对象，表示对指定追加 blob 的引用。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getBlockBlobReference

public CloudBlockBlob getBlockBlobReference(final String blobName)

返回对 CloudBlockBlob 对象的引用，该对象表示此目录中的块 Blob。

Parameters:

blobName - 一个 String ，表示 Blob 的名称。

Returns:

一个 CloudBlockBlob 对象，表示对指定块 Blob 的引用。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getBlockBlobReference

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

使用指定的快照 ID 返回对CloudBlockBlob表示此目录中的块 Blob 的 对象的引用。

Parameters:

blobName - 一个 String ，表示 Blob 的名称。

snapshotID - 一个 String ，表示 blob 的快照 ID。

Returns:

一个 CloudBlockBlob 对象，表示对指定块 Blob 的引用。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getContainer

public CloudBlobContainer getContainer()

返回此目录的容器。

Overrides:

CloudBlobDirectory.getContainer()

Returns:

一个 CloudBlobContainer ，表示此目录的容器。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getDirectoryReference

public CloudBlobDirectory getDirectoryReference(String directoryName)

返回对此目录下的虚拟 Blob 目录的引用。

Parameters:

directoryName - 一个 String ，它表示虚拟子目录的名称。

Returns:

一个 CloudBlobDirectory 对象，该对象表示此目录下的虚拟 Blob 目录。

Throws:

URISyntaxException - 如果资源 URI 无效。

getPageBlobReference

public CloudPageBlob getPageBlobReference(final String blobName)

返回对 CloudPageBlob 对象的引用，该对象表示目录中的页 Blob。

Parameters:

blobName - 一个 String ，表示 Blob 的名称。

Returns:

一个 CloudPageBlob 对象，表示对指定页 Blob 的引用。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getPageBlobReference

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

使用指定的快照 ID 返回对 CloudPageBlob 表示目录中页 Blob 的 对象的引用。

Parameters:

blobName - 一个 String ，表示 Blob 的名称。

snapshotID - 一个 String ，表示 blob 的快照 ID。

Returns:

一个 CloudPageBlob 对象，表示对指定页 Blob 的引用。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getParent

public CloudBlobDirectory getParent()

返回此目录的父目录。

Overrides:

CloudBlobDirectory.getParent()

Returns:

一个 CloudBlobDirectory 表示此目录的父目录的 对象。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

getPrefix

public String getPrefix()

返回此目录的前缀。

Returns:

一个 String ，表示此目录的前缀。

getServiceClient

public CloudBlobClient getServiceClient()

返回与此目录关联的 Blob 服务客户端。

Returns:

一个 CloudBlobClient 对象，表示与目录关联的服务客户端。

getStorageUri

public final StorageUri getStorageUri()

返回所有位置的 URI 列表。

Overrides:

CloudBlobDirectory.getStorageUri()

Returns:

一个 StorageUri ，它表示所有位置的 URI 列表。

getUri

public URI getUri()

返回此目录的 URI。

Overrides:

CloudBlobDirectory.getUri()

Returns:

一个 java.net.URI 对象，表示此目录的 URI。

listBlobs

public Iterable listBlobs()

返回目录的 Blob 项的可枚举集合。

Returns:

表示此容器中的块项的 ListBlobItem 对象的可枚举集合。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

listBlobs

public Iterable listBlobs(String prefix)

返回 Blob 项的可枚举集合，其名称以目录的指定前缀开头。

Parameters:

prefix - 表示 String Blob 名称前缀的 。

Returns:

对象的可枚举集合 ListBlobItem ，这些对象表示其名称以此目录中的指定前缀开头的块项。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

listBlobs

public Iterable listBlobs(String prefix, final boolean useFlatBlobListing, final EnumSet listingDetails, final BlobRequestOptions options, final OperationContext opContext)

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

Parameters:

prefix - 一个 String ，表示 Blob 名称的前缀。

useFlatBlobListing -

true 指示返回的列表将为平面; false 指示返回的列表将是分层的。

listingDetails - 一个 java.util.EnumSet 对象，其中包含 BlobListingDetails 指示是否返回快照、元数据和/或未提交的块的值。 始终返回提交的块。

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

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

Returns:

对象的可枚举集合 ListBlobItem ，这些对象表示其名称以此目录中的指定前缀开头的块项。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

listBlobsSegmented

public ResultSegment listBlobsSegmented()

返回目录中 Blob 项的可枚举集合的结果段。

Returns:

一个 ResultSegment<T> 对象，该对象包含表示目录中 Blob 项的 ListBlobItem 对象的可枚举集合的段。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

listBlobsSegmented

public ResultSegment listBlobsSegmented(String prefix)

返回一个结果段，其中包含其名称以指定前缀开头的 Blob 项的集合。

Parameters:

prefix - 一个 String ，表示 Blob 名称的前缀。

Returns:

一个 ResultSegment<T> 对象，该对象包含对象可枚举集合的 ListBlobItem 段，这些对象表示其名称以目录中的指定前缀开头的 Blob 项。

Throws:

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

URISyntaxException - 如果资源 URI 无效。

listBlobsSegmented

public ResultSegment listBlobsSegmented(String prefix, final boolean useFlatBlobListing, final EnumSet listingDetails, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext)

返回一个结果段，其中包含名称以指定前缀开头、使用指定的平面或分层选项、列出详细信息选项、请求选项和操作上下文的 Blob 项集合。

Parameters:

prefix - 一个 String ，表示 Blob 名称的前缀。

useFlatBlobListing -

true 指示返回的列表将为平面; false 指示返回的列表将是分层的。

listingDetails - 一个 java.util.EnumSet 对象，其中包含 BlobListingDetails 指示是否返回快照、元数据和/或未提交的块的值。 始终返回提交的块。

maxResults - 要检索的最大结果数。

continuationToken - 一个 ResultContinuation 对象，表示上一个列表操作返回的继续标记。

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

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

Returns:

一个 ResultSegment<T> 对象，该对象包含对象的可枚举集合的 ListBlobItem 段，这些对象表示其名称以目录中指定前缀开头的块项。

Throws:

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

URISyntaxException - 如果资源 URI 无效。