CloudTableClient Classe

Pacote:

com.microsoft.azure.storage.table

• java.lang.Object
• • ServiceClient
  • • com.microsoft.azure.storage.table.CloudTableClient

public class CloudTableClient extends ServiceClient

Fornece um cliente de serviço para acessar o serviço Tabela do Microsoft Azure.

A CloudTableClient classe encapsula o URI base para o ponto de extremidade de serviço Tabela e as credenciais para acessar a conta de armazenamento e fornece métodos para criar, excluir, listar e consultar tabelas, bem como métodos para executar operações e consultas em entidades de tabela. Esses métodos invocam operações da API REST do Serviço de Armazenamento para fazer as solicitações e obter os resultados retornados.

Um ponto de extremidade de serviço Tabela é o URI base para recursos do serviço Tabela, incluindo o nome DNS da conta de armazenamento:

Para obter mais informações, consulte o tópico MSDN Abordando recursos de serviço de tabela.

As credenciais podem ser uma combinação do nome da conta de armazenamento e uma chave ou uma assinatura de acesso compartilhado. Para obter mais informações, consulte o tópico MSDN Autenticando o acesso à sua conta de armazenamento.

Resumo do Construtor

Construtor	Description
CloudTableClient(final StorageUri baseUri, StorageCredentials credentials)	Inicializa uma instância da classe usando um ponto de extremidade de serviço tabela e credenciais de conta de armazenamento.
CloudTableClient(final URI baseUri, StorageCredentials credentials)	Inicializa uma instância da classe usando um ponto de extremidade de serviço tabela e credenciais de conta de armazenamento.

Resumo do método

Modificador e tipo	Método e descrição
final ServiceProperties	downloadServiceProperties() Recupera o atual ServiceProperties para o serviço de armazenamento especificado. Isso inclui configurações de Log, HourMetrics, MinuteMetrics e CORS.
final ServiceProperties	downloadServiceProperties(TableRequestOptions options, OperationContext opContext) Recupera o atual ServiceProperties para o serviço de armazenamento especificado. Isso inclui configurações de Log, HourMetrics, MinuteMetrics e CORS.
<T extends TableEntity, R> ResultSegment<?>	executeQuerySegmentedImpl(final TableQuery<T> queryToExecute, final EntityResolver<R> resolver, final ResultContinuation continuationToken, TableRequestOptions options, OperationContext opContext) Reservado para uso interno. Executa uma operação de consulta segmentada usando as políticas de repetição e tempo limite especificadas.
<T extends TableEntity, R> Iterable<?>	generateIteratorForQuery(final TableQuery<T> queryRef, final EntityResolver<R> resolver, TableRequestOptions options, OperationContext opContext) Reservado para uso interno. Gera um iterador para uma operação de consulta segmentada.
TableRequestOptions	getDefaultRequestOptions() Obtém o TableRequestOptions que é usado para solicitações associadas a este
ServiceStats	getServiceStats() Consulta o serviço para o ServiceStats.
ServiceStats	getServiceStats(TableRequestOptions options, OperationContext opContext) Consulta o serviço de armazenamento especificado para o ServiceStats.
CloudTable	getTableReference(final String tableName) Obtém um CloudTable objeto com o nome especificado.
final StorageUri	getTransformedEndPoint(final OperationContext opContext)
boolean	isUsePathStyleUris() Indica se os URIs de estilo de caminho são usados.
Iterable<String>	listTables() Lista os nomes de tabela na conta de armazenamento. Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
Iterable<String>	listTables(final String prefix) Lista os nomes de tabela na conta de armazenamento que correspondem ao prefixo especificado. Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela que correspondem ao prefixo, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
Iterable<String>	listTables(final String prefix, final TableRequestOptions options, final OperationContext opContext) Lista os nomes de tabela na conta de armazenamento que correspondem ao prefixo especificado, usando o especificado TableRequestOptions e OperationContext. Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela que correspondem ao prefixo, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
ResultSegment<String>	listTablesSegmented() Lista os nomes de tabela na conta de armazenamento no modo segmentado. Esse método permite que a listagem de tabelas seja retomada depois de retornar um conjunto parcial de resultados, usando informações retornadas pelo servidor no ResultSegment<T> objeto . Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
ResultSegment<String>	listTablesSegmented(final String prefix) Lista os nomes de tabela na conta de armazenamento que correspondem ao prefixo especificado no modo segmentado. Esse método permite que a listagem de tabelas seja retomada depois de retornar um conjunto parcial de resultados, usando informações retornadas pelo servidor no ResultSegment<T> objeto . Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela que correspondem ao prefixo, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.
ResultSegment<String>	listTablesSegmented(final String prefix, final Integer maxResults, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext) Lista até o máximo especificado dos nomes de tabela na conta de armazenamento que correspondem ao prefixo especificado em um modo retomável com o token de continuação especificado ResultContinuation , usando o especificado TableRequestOptions e OperationContext. Esse método permite que a listagem de tabelas seja retomada depois de retornar uma página de resultados, usando informações retornadas pelo servidor no ResultSegment<T> objeto . Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela que correspondem ao prefixo, usando o ponto de extremidade de serviço tabela e credenciais de conta de armazenamento dessa instância. Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.
void	setDefaultRequestOptions(TableRequestOptions defaultRequestOptions) Define o TableRequestOptions que é usado para qualquer tabela acessada com esse objeto .
void	uploadServiceProperties(final ServiceProperties properties) Carrega uma nova ServiceProperties configuração para o serviço de armazenamento especificado. Isso inclui configurações de Log, HourMetrics, MinuteMetrics e CORS.
void	uploadServiceProperties(final ServiceProperties properties, TableRequestOptions options, OperationContext opContext) Carrega uma nova ServiceProperties configuração para o serviço de armazenamento especificado. Isso inclui configurações de Log, HourMetrics, MinuteMetrics e CORS.

Membros herdados

ServiceClient.credentials ServiceClient.downloadServicePropertiesImpl(final RequestOptions options, final boolean signAsTable) ServiceClient.getCredentials() ServiceClient.getEndpoint() ServiceClient.getServiceStatsImpl(final RequestOptions options, final boolean signAsTable) ServiceClient.getStorageUri() ServiceClient.ServiceClient(final StorageUri storageUri, final StorageCredentials credentials) ServiceClient.setCredentials(final StorageCredentials credentials) ServiceClient.setStorageUri(final StorageUri storageUri) ServiceClient.uploadServicePropertiesImpl(final ServiceProperties properties, final RequestOptions options, final OperationContext opContext, final boolean signAsTable)

Detalhes do construtor

CloudTableClient

public CloudTableClient(final StorageUri baseUri, StorageCredentials credentials)

Inicializa uma instância da classe usando um ponto de extremidade de serviço tabela e credenciais de conta de armazenamento.

Parameters:

baseUri - Um StorageUri objeto que representa o ponto de extremidade de serviço Tabela usado para inicializar o cliente.

credentials - Um StorageCredentials objeto que representa as credenciais da conta de armazenamento para acesso.

CloudTableClient

public CloudTableClient(final URI baseUri, StorageCredentials credentials)

Inicializa uma instância da classe usando um ponto de extremidade de serviço tabela e credenciais de conta de armazenamento.

Parameters:

baseUri - Um java.net.URI objeto que representa o ponto de extremidade de serviço Tabela usado para inicializar o cliente.

credentials - Um StorageCredentials objeto que representa as credenciais da conta de armazenamento para acesso.

Detalhes do método

downloadServiceProperties

public final ServiceProperties downloadServiceProperties()

Recupera o atual ServiceProperties para o serviço de armazenamento especificado. Isso inclui configurações de Log, HourMetrics, MinuteMetrics e CORS.

Returns:

o ServiceProperties objeto que representa a configuração atual do serviço.

Throws:

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

downloadServiceProperties

public final ServiceProperties downloadServiceProperties(TableRequestOptions options, OperationContext opContext)

Recupera o atual ServiceProperties para o serviço de armazenamento especificado. Isso inclui configurações de Log, HourMetrics, MinuteMetrics e CORS.

Parameters:

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação 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:

o ServiceProperties objeto que representa a configuração atual do serviço.

Throws:

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

executeQuerySegmentedImpl

protected ResultSegment executeQuerySegmentedImpl(final TableQuery queryToExecute, final EntityResolver resolver, final ResultContinuation continuationToken, TableRequestOptions options, OperationContext opContext)

Reservado para uso interno. Executa uma operação de consulta segmentada usando as políticas de repetição e tempo limite especificadas.

Parameters:

queryToExecute - O TableQuery<T> a ser executado.

resolver - Uma instância EntityResolver<T> que cria uma projeção de entidades de resultado da consulta de tabela para o tipo R especificado. Passe null para retornar os resultados como o tipo de entidade de tabela.

continuationToken - O ResultContinuation a ser passado com a operação para retomar uma consulta, se houver. Passe null para uma consulta inicial.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Um ResultSegment<T> que contém uma coleção dos resultados da consulta especializados para o TableEntity tipo ou EntityResolver<T> retornado pela consulta.

Throws:

StorageException - se ocorrer um erro de serviço de armazenamento.

generateIteratorForQuery

protected Iterable generateIteratorForQuery(final TableQuery queryRef, final EntityResolver resolver, TableRequestOptions options, OperationContext opContext)

Reservado para uso interno. Gera um iterador para uma operação de consulta segmentada.

Parameters:

queryRef - O TableQuery<T> a ser executado.

resolver - Uma instância EntityResolver<T> que cria uma projeção de entidades de resultado da consulta de tabela para o tipo R especificado. Passe null para retornar os resultados como o tipo de entidade de tabela.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Uma instância de Iterable especializada para o TableEntity tipo ou EntityResolver<T> retornado pela consulta.

getDefaultRequestOptions

public TableRequestOptions getDefaultRequestOptions()

Obtém o TableRequestOptions que é usado para solicitações associadas a este

Returns:

O TableRequestOptions objeto que contém os valores usados por este CloudTableClient

getServiceStats

public ServiceStats getServiceStats()

Consulta o serviço para o ServiceStats.

Returns:

ServiceStats para o serviço de armazenamento especificado

Throws:

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

getServiceStats

public ServiceStats getServiceStats(TableRequestOptions options, OperationContext opContext)

Consulta o serviço de armazenamento especificado para o ServiceStats.

Parameters:

options - Um BlobRequestOptions objeto que especifica as opções adicionais para a solicitação. A especificação 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:

ServiceStats para o serviço de armazenamento especificado

Throws:

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

getTableReference

public CloudTable getTableReference(final String tableName)

Obtém um CloudTable objeto com o nome especificado.

Parameters:

tableName - Um String que representa o nome da tabela, que deve seguir as regras de nomenclatura de tabela. O nome da tabela não deve incluir nenhum caractere separador de caminho (/). Os nomes de tabela não diferenciam maiúsculas de minúsculas, devem ser exclusivos em uma conta e devem ter entre 3 a 63 caracteres. Os nomes de tabela devem começar com um não pode começar com um caractere numérico e podem conter apenas caracteres alfanuméricos. Alguns nomes de tabela são reservados, incluindo "table".

Returns:

Uma referência a um objeto CloudTable.

Throws:

URISyntaxException - Se o URI do recurso construído com base no tableName for inválido.

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

getTransformedEndPoint

protected final StorageUri getTransformedEndPoint(final OperationContext opContext)

Parameters:

opContext

isUsePathStyleUris

protected boolean isUsePathStyleUris()

Indica se os URIs de estilo de caminho são usados.

Returns:

true se URIs de estilo de caminho forem usados; caso contrário false, .

listTables

public Iterable listTables()

Lista os nomes de tabela na conta de armazenamento.

Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Returns:

Uma Iterable coleção dos nomes de tabela na conta de armazenamento recuperada de forma preguiçosa.

listTables

public Iterable listTables(final String prefix)

Lista os nomes de tabela na conta de armazenamento que correspondem ao prefixo especificado.

Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela que correspondem ao prefixo, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Parameters:

prefix - Um String que contém o prefixo a ser correspondido em nomes de tabela a serem retornados.

Returns:

Uma Iterable coleção dos nomes de tabela na conta de armazenamento recuperada de forma preguiçosa que correspondem ao prefixo especificado.

listTables

public Iterable listTables(final String prefix, final TableRequestOptions options, final OperationContext opContext)

Lista os nomes de tabela na conta de armazenamento que correspondem ao prefixo especificado, usando o especificado TableRequestOptions e OperationContext.

Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela que correspondem ao prefixo, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

prefix - Um String que contém o prefixo a ser correspondido em nomes de tabela a serem retornados.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Uma Iterable coleção dos nomes de tabela na conta de armazenamento recuperada de forma preguiçosa que correspondem ao prefixo especificado.

listTablesSegmented

public ResultSegment listTablesSegmented()

Lista os nomes de tabela na conta de armazenamento no modo segmentado. Esse método permite que a listagem de tabelas seja retomada depois de retornar um conjunto parcial de resultados, usando informações retornadas pelo servidor no ResultSegment<T> objeto .

Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Returns:

Um ResultSegment<T> dos String objetos que contêm nomes de tabela na conta de armazenamento.

Throws:

StorageException - se ocorreu um erro de serviço de armazenamento durante a operação.

listTablesSegmented

public ResultSegment listTablesSegmented(final String prefix)

Lista os nomes de tabela na conta de armazenamento que correspondem ao prefixo especificado no modo segmentado. Esse método permite que a listagem de tabelas seja retomada depois de retornar um conjunto parcial de resultados, usando informações retornadas pelo servidor no ResultSegment<T> objeto .

Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela que correspondem ao prefixo, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento dessa instância.

Parameters:

prefix - Um String que contém o prefixo a ser correspondido em nomes de tabela a serem retornados.

Returns:

Um ResultSegment<T> dos String objetos que contêm nomes de tabela que correspondem ao prefixo na conta de armazenamento.

Throws:

StorageException - se ocorreu um erro de serviço de armazenamento durante a operação.

listTablesSegmented

public ResultSegment listTablesSegmented(final String prefix, final Integer maxResults, final ResultContinuation continuationToken, final TableRequestOptions options, final OperationContext opContext)

Lista até o máximo especificado dos nomes de tabela na conta de armazenamento que correspondem ao prefixo especificado em um modo retomável com o token de continuação especificado ResultContinuation , usando o especificado TableRequestOptions e OperationContext. Esse método permite que a listagem de tabelas seja retomada depois de retornar uma página de resultados, usando informações retornadas pelo servidor no ResultSegment<T> objeto .

Esse método invoca a API REST tabelas de consulta para listar os nomes de tabela que correspondem ao prefixo, usando o ponto de extremidade de serviço tabela e credenciais de conta de armazenamento dessa instância.

Use o TableRequestOptions para substituir opções de execução, como o tempo limite ou a política de repetição para a operação.

Parameters:

prefix - Um String que contém o prefixo a ser correspondido em nomes de tabela a serem retornados.

maxResults - O número máximo de nomes de tabela a serem retornados no ResultSegment<T>. Se esse parâmetro for nulo, a consulta listará até o máximo de 1.000 resultados.

continuationToken - Um objeto ResultContinuation que representa um token de continuação do servidor quando a operação retorna um resultado parcial. Especifique null na chamada inicial. Chame o getContinuationToken() método no resultado para obter o ResultContinuation objeto a ser usado na próxima chamada para retomar a consulta.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação. Especifique null para usar as opções de solicitação especificadas no CloudTableClient.

opContext - Um objeto OperationContext para rastrear a operação atual. Especifique null para ignorar com segurança o contexto da operação.

Returns:

Um ResultSegment<T> dos String objetos que contêm nomes de tabela na conta de armazenamento.

Throws:

StorageException - se ocorreu um erro de serviço de armazenamento durante a operação.

setDefaultRequestOptions

public void setDefaultRequestOptions(TableRequestOptions defaultRequestOptions)

Define o TableRequestOptions que é usado para qualquer tabela acessada com esse objeto .

Parameters:

defaultRequestOptions - O TableRequestOptions a ser usado.

uploadServiceProperties

public void uploadServiceProperties(final ServiceProperties properties)

Carrega uma nova ServiceProperties configuração para o serviço de armazenamento especificado. Isso inclui configurações de Log, HourMetrics, MinuteMetrics e CORS.

Parameters:

properties - O ServiceProperties a ser carregado.

Throws:

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

uploadServiceProperties

public void uploadServiceProperties(final ServiceProperties properties, TableRequestOptions options, OperationContext opContext)

Carrega uma nova ServiceProperties configuração para o serviço de armazenamento especificado. Isso inclui configurações de Log, HourMetrics, MinuteMetrics e CORS.

Parameters:

properties - O ServiceProperties a ser carregado.

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.

Throws:

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