CloudBlobDirectory Classe

Pacote:

com.microsoft.azure.storage.blob

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

public class CloudBlobDirectory implements ListBlobItem

Representa um diretório virtual de blobs, designado por um caractere delimitador.

Contêineres, que são encapsulados como objetos CloudBlobContainer, contêm diretórios. Os diretórios, por sua vez, contêm blobs de blocos e blobs de páginas. Os diretórios também podem conter subdiretórios.

Resumo do Construtor

Construtor	Description
CloudBlobDirectory(final StorageUri uri, final String prefix, final CloudBlobClient client, final CloudBlobContainer container)	Cria uma instância da classe usando o endereço, o pai do diretório e o cliente especificados.
CloudBlobDirectory(final StorageUri uri, final String prefix, final CloudBlobClient client, final CloudBlobContainer container, final CloudBlobDirectory parent)	Cria uma instância da classe usando o endereço, o pai do diretório e o cliente especificados.

Resumo do método

Modificador e tipo	Método e descrição
CloudAppendBlob	getAppendBlobReference(final String blobName) Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo no diretório.
CloudAppendBlob	getAppendBlobReference(final String blobName, final String snapshotID) Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo no diretório, usando a ID de instantâneo especificada.
CloudBlockBlob	getBlockBlobReference(final String blobName) Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste diretório.
CloudBlockBlob	getBlockBlobReference(final String blobName, final String snapshotID) Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste diretório, usando a ID de instantâneo especificada.
CloudBlobContainer	getContainer() Retorna o contêiner para esse diretório.
CloudBlobDirectory	getDirectoryReference(String directoryName) Retorna uma referência a um diretório de blob virtual abaixo desse diretório.
CloudPageBlob	getPageBlobReference(final String blobName) Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas no diretório.
CloudPageBlob	getPageBlobReference(final String blobName, final String snapshotID) Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas no diretório, usando a ID de instantâneo especificada.
CloudBlobDirectory	getParent() Retorna o diretório pai desse diretório.
String	getPrefix() Retorna o prefixo para esse diretório.
CloudBlobClient	getServiceClient() Retorna o cliente do serviço Blob associado a esse diretório.
final StorageUri	getStorageUri() Retorna a lista de URIs para todos os locais.
URI	getUri() Retorna o URI desse diretório.
Iterable<ListBlobItem>	listBlobs() Retorna uma coleção enumerável de itens de blob para o diretório.
Iterable<ListBlobItem>	listBlobs(String prefix) Retorna uma coleção enumerável de itens de blob cujos nomes começam com o prefixo especificado para o diretório.
Iterable<ListBlobItem>	listBlobs(String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, final BlobRequestOptions options, final OperationContext opContext) Retorna uma coleção enumerável de itens de blob cujos nomes começam com o prefixo especificado, usando a opção simples ou hierárquica especificada, listando opções de detalhes, opções de solicitação e contexto de operação.
ResultSegment<ListBlobItem>	listBlobsSegmented() Retorna um segmento de resultado de uma coleção enumerável de itens de blob no diretório .
ResultSegment<ListBlobItem>	listBlobsSegmented(String prefix) Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado.
ResultSegment<ListBlobItem>	listBlobsSegmented(String prefix, final boolean useFlatBlobListing, final EnumSet<BlobListingDetails> listingDetails, final Integer maxResults, final ResultContinuation continuationToken, final BlobRequestOptions options, final OperationContext opContext) Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado, usando a opção simples ou hierárquica especificada, listando opções de detalhes, opções de solicitação e contexto de operação.

Detalhes do construtor

CloudBlobDirectory

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

Cria uma instância da classe usando o endereço, o pai do diretório e o cliente especificados.

Parameters:

uri - Um StorageUri que representa o endereço do diretório de blob.

prefix - Um String que representa o prefixo do diretório de blob.

client - Um CloudBlobClient objeto que representa o cliente de serviço associado.

container

CloudBlobDirectory

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

Cria uma instância da classe usando o endereço, o pai do diretório e o cliente especificados.

Parameters:

uri - Um StorageUri que representa o endereço do diretório de blob.

prefix - Um String que representa o prefixo do diretório de blob.

client - Um CloudBlobClient objeto que representa o cliente de serviço associado.

container

parent - Um CloudBlobDirectory objeto que representa o diretório pai, se aplicável.

Detalhes do método

getAppendBlobReference

public CloudAppendBlob getAppendBlobReference(final String blobName)

Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo no diretório.

Parameters:

blobName - Um String que representa o nome do blob.

Returns:

Um CloudAppendBlob objeto que representa uma referência ao blob de acréscimo especificado.

Throws:

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

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

getAppendBlobReference

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

Retorna uma referência a um CloudAppendBlob objeto que representa um blob de acréscimo no diretório, usando a ID de instantâneo especificada.

Parameters:

blobName - Um String que representa o nome do blob.

snapshotID - Um String que representa a ID de instantâneo do blob.

Returns:

Um CloudAppendBlob objeto que representa uma referência ao blob de acréscimo especificado.

Throws:

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

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

getBlockBlobReference

public CloudBlockBlob getBlockBlobReference(final String blobName)

Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste diretório.

Parameters:

blobName - Um String que representa o nome do blob.

Returns:

Um CloudBlockBlob objeto que representa uma referência ao blob de bloco especificado.

Throws:

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

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

getBlockBlobReference

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

Retorna uma referência a um CloudBlockBlob objeto que representa um blob de blocos neste diretório, usando a ID de instantâneo especificada.

Parameters:

blobName - Um String que representa o nome do blob.

snapshotID - Um String que representa a ID de instantâneo do blob.

Returns:

Um CloudBlockBlob objeto que representa uma referência ao blob de bloco especificado.

Throws:

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

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

getContainer

public CloudBlobContainer getContainer()

Retorna o contêiner para esse diretório.

Overrides:

CloudBlobDirectory.getContainer()

Returns:

Um CloudBlobContainer que representa o contêiner para esse diretório.

Throws:

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

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

getDirectoryReference

public CloudBlobDirectory getDirectoryReference(String directoryName)

Retorna uma referência a um diretório de blob virtual abaixo desse diretório.

Parameters:

directoryName - Um String que representa o nome do subdiretório virtual.

Returns:

Um CloudBlobDirectory objeto que representa um diretório de blob virtual abaixo desse diretório.

Throws:

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

getPageBlobReference

public CloudPageBlob getPageBlobReference(final String blobName)

Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas no diretório.

Parameters:

blobName - Um String que representa o nome do blob.

Returns:

Um CloudPageBlob objeto que representa uma referência ao blob de página especificado.

Throws:

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

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

getPageBlobReference

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

Retorna uma referência a um CloudPageBlob objeto que representa um blob de páginas no diretório, usando a ID de instantâneo especificada.

Parameters:

blobName - Um String que representa o nome do blob.

snapshotID - Um String que representa a ID de instantâneo do blob.

Returns:

Um CloudPageBlob objeto que representa uma referência ao blob de páginas especificado.

Throws:

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

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

getParent

public CloudBlobDirectory getParent()

Retorna o diretório pai desse diretório.

Overrides:

CloudBlobDirectory.getParent()

Returns:

Um CloudBlobDirectory objeto que representa o pai desse diretório.

Throws:

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

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

getPrefix

public String getPrefix()

Retorna o prefixo para esse diretório.

Returns:

Um String que representa o prefixo para esse diretório.

getServiceClient

public CloudBlobClient getServiceClient()

Retorna o cliente do serviço Blob associado a esse diretório.

Returns:

Um CloudBlobClient objeto que representa o cliente de serviço associado ao diretório.

getStorageUri

public final StorageUri getStorageUri()

Retorna a lista de URIs para todos os locais.

Overrides:

CloudBlobDirectory.getStorageUri()

Returns:

Um StorageUri que representa a lista de URIs para todos os locais..

getUri

public URI getUri()

Retorna o URI desse diretório.

Overrides:

CloudBlobDirectory.getUri()

Returns:

Um java.net.URI objeto que representa o URI para esse diretório.

listBlobs

public Iterable listBlobs()

Retorna uma coleção enumerável de itens de blob para o diretório.

Returns:

Uma coleção enumerável de ListBlobItem objetos que representam os itens de bloco neste contêiner.

Throws:

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

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

listBlobs

public Iterable listBlobs(String prefix)

Retorna uma coleção enumerável de itens de blob cujos nomes começam com o prefixo especificado para o diretório.

Parameters:

prefix - Um String que representa o prefixo do nome do blob.

Returns:

Uma coleção enumerável de ListBlobItem objetos que representam os itens de bloco cujos nomes começam com o prefixo especificado neste diretório.

Throws:

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

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

listBlobs

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

Retorna uma coleção enumerável de itens de blob cujos nomes começam com o prefixo especificado, usando a opção simples ou hierárquica especificada, listando opções de detalhes, opções de solicitação e contexto de operação.

Parameters:

prefix - Um String que representa o prefixo do nome do blob.

useFlatBlobListing -

true para indicar que a lista retornada será simples; false para indicar que a lista retornada será hierárquica.

listingDetails - Um java.util.EnumSet objeto que contém BlobListingDetails valores que indicam se instantâneos, metadados e/ou blocos não confirmados são retornados. Os blocos confirmados sempre são retornados.

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:

Uma coleção enumerável de ListBlobItem objetos que representam os itens de bloco cujos nomes começam com o prefixo especificado neste diretório.

Throws:

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

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

listBlobsSegmented

public ResultSegment listBlobsSegmented()

Retorna um segmento de resultado de uma coleção enumerável de itens de blob no diretório .

Returns:

Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de ListBlobItem objetos que representam os itens de blob no diretório.

Throws:

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

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

listBlobsSegmented

public ResultSegment listBlobsSegmented(String prefix)

Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado.

Parameters:

prefix - Um String que representa o prefixo do nome do blob.

Returns:

Um ResultSegment<T> objeto que contém um segmento da coleção enumerável de ListBlobItem objetos que representam os itens de blob cujos nomes começam com o prefixo especificado no diretório.

Throws:

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

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

listBlobsSegmented

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

Retorna um segmento de resultado que contém uma coleção de itens de blob cujos nomes começam com o prefixo especificado, usando a opção simples ou hierárquica especificada, listando opções de detalhes, opções de solicitação e contexto de operação.

Parameters:

prefix - Um String que representa o prefixo do nome do blob.

useFlatBlobListing -

true para indicar que a lista retornada será simples; false para indicar que a lista retornada será hierárquica.

listingDetails - Um java.util.EnumSet objeto que contém BlobListingDetails valores que indicam se instantâneos, metadados e/ou blocos não confirmados são retornados. Os blocos confirmados sempre são retornados.

maxResults - O número máximo de resultados a serem recuperados.

continuationToken - Um ResultContinuation objeto que representa um token de continuação retornado por uma operação de listagem anterior.

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 ResultSegment<T> objeto que contém um segmento da coleção enumerável de ListBlobItem objetos que representam os itens de bloco cujos nomes começam com o prefixo especificado no diretório.

Throws:

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

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