com.microsoft.azure.storage.table

Classes

CloudTable	Representa uma tabela no serviço Tabela do Microsoft Azure.
CloudTableClient	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 de 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 de 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.
DynamicTableEntity	Um tipo TableEntity que permite que os chamadores acessem diretamente o mapa de propriedade da entidade. Essa classe se estende TableServiceEntity para eliminar o uso de reflexão para serialização e desserialização.
EntityProperty	Uma classe que representa um único valor de propriedade tipada em uma entidade de tabela. Um EntityProperty armazena o tipo de dados como um EdmType. O valor, que pode ser para tipos de objeto, mas não para tipos primitivos, é serializado e armazenado como um . EntityProperty fornece construtores sobrecarregados e sobrecargas do método para tipos de valor com suporte. Cada construtor ou método sobrecarregado define o EdmType e serializa o valor adequadamente com base no tipo de parâmetro. Use um dos métodos Type para desserializar um EntityProperty como o tipo Java apropriado. O método gerará um ParseException ou IllegalArgumentException se o EntityProperty não puder ser desserializado como o tipo Java.
QueryTableOperation	Uma classe que se estende TableOperation para implementar uma consulta para recuperar uma única entidade de tabela. Para executar uma QueryTableOperation instância, chame o método em uma CloudTableClient instância. Essa operação pode ser executada diretamente ou como parte de um TableBatchOperation. Se o QueryTableOperation retornar um resultado de entidade, ele será armazenado no correspondente TableResult retornado pelo método .
SharedAccessTablePolicy	Representa uma política de acesso compartilhado, que especifica a hora de início, a hora de expiração e as permissões para uma assinatura de acesso compartilhado.
TableBatchOperation	Uma classe que representa uma operação em lote. Uma operação em lote é uma coleção de operações de tabela executadas pela API REST do Serviço de Armazenamento como uma única operação atômica, invocando uma Transação de Grupo de Entidades. Uma operação em lote pode conter até 100 operações de tabela individual, com o requisito de que cada entidade de operação deve ter a mesma chave de partição. Um lote com uma operação de recuperação não pode conter outras operações. Observe que a carga total de uma operação em lote é limitada a 4MB.
TableEncryptionPolicy	Representa uma política de criptografia de tabela usada para executar criptografia/descriptografia de envelope de entidades de tabela do Azure.
TableOperation	Uma classe que representa uma única operação de tabela. Use os métodos de fábrica estáticos para construir TableOperation instâncias para operações em tabelas que inserem, atualizam, mesclam, excluem, substituam ou recuperam entidades de tabela. Para executar uma TableOperation instância, chame o método em uma CloudTableClient instância. Um TableOperation pode ser executado diretamente ou como parte de um TableBatchOperation. Se um TableOperation retornar um resultado de entidade, ele será armazenado no correspondente TableResult retornado pelo método .
TablePermissions	Representa as permissões para uma tabela.
TableQuery<T>	Uma classe que representa uma consulta em relação a uma tabela especificada. Uma TableQuery<T> instância agrega os parâmetros de consulta a serem usados quando a consulta é executada. Um dos métodos ou de CloudTableClient deve ser chamado para executar a consulta. Os parâmetros são codificados e passados para o servidor quando a consulta de tabela é executada. Para criar uma consulta de tabela com sintaxe fluente, o from(final Class<T> clazzType) método de fábrica estático e os where(final String filter)métodos de mutador , select(final String[] columns)e take(final Integer take) retornam uma referência ao objeto que pode ser encadeado em uma única expressão. Use o from(Class) método de fábrica de classe estática para criar uma instância executada na tabela nomeada com entidades do tipo de implementação especificado TableEntity . Use o where(final String filter) método para especificar uma expressão de filtro para as entidades retornadas. Use o select(final String[] columns) método para especificar as propriedades da entidade de tabela a serem retornadas. Use o take(final Integer take) método para limitar o número de entidades retornadas pela consulta. Observe que nada impede chamar esses métodos mais de uma vez em um , portanto, os valores salvos no serão os últimos encontrados na ordem de execução. Por exemplo, você pode construir uma consulta de tabela usando a sintaxe fluente: Este exemplo cria uma consulta na tabela "Products" para todas as entidades em que o valor PartitionKey é "ProductsMNO" e o valor RowKey é maior ou igual a "Napkin" e solicita as primeiras 25 entidades correspondentes, selecionando apenas as propriedades comuns e a propriedade chamada "InventoryCount" e as retorna como DynamicTableEntity objetos. Expressões de filtro para uso com o método ou setFilterString(final String filterString) método podem ser criadas usando a sintaxe fluente com os métodos e combineFilters(String filterA, String operator, String filterB) o método sobrecarregadosgenerateFilterCondition(String propertyName, String operation, final boolean value), usando os operadores de comparação definidos em QueryComparisons e os operadores lógicos definidos em Operators.where(final String filter) Observe que o primeiro operando em uma comparação de filtro deve ser um nome de propriedade e o segundo operando deve ser avaliado como uma constante. Os valores da propriedade PartitionKey e RowKey são tipos para fins de comparação. Os valores que podem ser usados em consultas de tabela são explicados mais detalhadamente no tópico MSDN Consultando Tabelas e Entidades, mas observe que os caracteres de espaço dentro de valores não precisam ser codificados em URL, pois isso será feito quando a consulta for executada. O TableQuery#TableQuery(Class) construtor e TableQuery#from(Class) os métodos de fábrica estáticos exigem um tipo de classe que implementa TableEntity e contém um construtor nullary. Se a consulta for executada usando um EntityResolver<T>, o chamador poderá especificar TableServiceEntity como o tipo de classe.
TableRequestOptions	Representa um conjunto de opções de política de tempo limite, de conteúdo e de repetição que podem ser especificadas para uma solicitação de operação de tabela.
TableResult	Uma classe que representa o resultado de uma operação de tabela. A TableResult classe encapsula a resposta HTTP e todos os resultados da entidade de tabela retornados pela operação da API REST do Serviço de Armazenamento chamada para um determinado TableOperation.
TableServiceEntity	A TableServiceEntity classe representa o tipo de objeto base para uma entidade de tabela no serviço De armazenamento. TableServiceEntity fornece uma implementação base para a TableEntity interface que fornece métodos e que, por padrão, serializam e desserializam todas as propriedades por meio de reflexão. Uma classe de entidade de tabela pode estender essa classe e substituir os métodos e para fornecer lógica de serialização personalizada ou mais de alto desempenho. O uso da reflexão permite que subclasses de TableServiceEntity sejam serializadas e desserializadas sem a necessidade de implementar o código de serialização por conta própria. Quando um método getter e um método setter são encontrados para um determinado nome de propriedade e tipo de dados, o método apropriado é invocado automaticamente para serializar ou desserializar os dados. Para aproveitar o código de serialização automática, suas classes de entidade de tabela devem fornecer métodos getter e setter para cada propriedade na entidade de tabela correspondente no armazenamento de tabelas do Microsoft Azure. O código de reflexão procura métodos getter e setter em pares do formulário e em que PropertyName é um nome de propriedade para a entidade de tabela e type é um tipo Java compatível com o tipo de dados EDM da propriedade. Consulte a tabela abaixo para obter um mapa de tipos de propriedade para seus equivalentes java. A StoreAs anotação pode ser aplicada com um atributo para especificar um nome de propriedade para reflexão nos métodos getter e setter que não seguem a convenção de nome da propriedade. Os nomes de método e o atributo de StoreAs anotações diferenciam maiúsculas de minúsculas para correspondência de nomes de propriedade com reflexão. Use a Ignore anotação para impedir que métodos sejam usados pela reflexão para serialização e desserialização automáticas. Observe que os nomes "PartitionKey", "RowKey", "Timestamp" e "Etag" são reservados e serão ignorados se definidos com a StoreAs anotação em uma subclasse. A tabela a seguir mostra os tipos de dados de propriedade com suporte no armazenamento do Microsoft Azure e os tipos Java correspondentes quando desserializados. Tipos de dados de propriedade com suporte no armazenamento do Microsoft Azure Consulte o tópico MSDN Noções básicas sobre o Modelo de Dados do Serviço de Tabela para obter uma visão geral de tabelas, entidades e propriedades, conforme usado no serviço Armazenamento do Microsoft Azure. Para obter uma visão geral dos tipos e nomes de dados primitivos do EDM disponíveis, consulte o Seção Tipos de Dados Primitivos da Visão Geral do Protocolo OData.
TableServiceException	Uma exceção que resulta quando uma operação de serviço de armazenamento de tabela não é concluída com êxito.
TableQuery.Operators	Uma classe estática que mapeia identificadores para filtrar operadores de expressão.
TableQuery.QueryComparisons	Uma classe estática que mapeia identificadores para filtrar operadores de comparação de propriedades.

Interfaces

Encrypt	Representa um atributo personalizado que pode ser usado para indicar se uma propriedade de entidade deve ser criptografada. Use essa anotação para especificar se os dados armazenados por um método setter devem ser criptografados ou descriptografar os dados recuperados por um método getter em uma classe que implementa TableEntity.
EntityResolver<T>	Uma interface para executar a projeção do lado do cliente em uma entidade recuperada. Uma EntityResolver<T> instância deve implementar um método projetando os dados de entidade representados pelos parâmetros passados como uma nova instância do tipo especificado pelo parâmetro de tipo. Essa interface é útil para converter diretamente de dados de entidade de tabela em um tipo de objeto cliente sem exigir um tipo de classe de entidade de tabela separado que desserializa cada propriedade individualmente. Por exemplo, um cliente pode executar uma projeção do lado do cliente de uma entidade Customer simplesmente retornando o para a propriedade CustomerName de cada entidade. O resultado dessa projeção será uma coleção de s que contém cada nome de cliente.
Ignore	Uma anotação definida em um método para impedir seu uso na serialização ou desserialização de uma propriedade por reflexão. Aplique a anotação a métodos em uma classe que implementa TableEntity para forçá-los a serem ignorados durante a serialização e desserialização baseadas em reflexão. Consulte a documentação para TableServiceEntity obter mais informações sobre como usar a serialização e desserialização baseadas em reflexão.
StoreAs	Uma anotação usada para substituir o nome de uma propriedade é serializada e desserializada com o uso de reflexão. Use essa anotação para especificar o nome da propriedade a ser associado aos dados armazenados por um método setter ou recuperados por um método getter em uma classe que implementa TableEntity que usa serialização baseada em reflexão e desserialização. Observe que os nomes "PartitionKey", "RowKey", "Timestamp" e "Etag" são reservados e serão ignorados se definidos com a anotação. Exemplo: Este exemplo mostra como os métodos que obteriam e definiriam uma propriedade de entidade chamada ObjectPropertyName no caso padrão podem ser anotados para obter e definir uma propriedade de entidade chamada EntityPropertyName. Consulte a documentação para TableServiceEntity obter mais informações sobre como usar a serialização e desserialização baseadas em reflexão.
TableEntity	Uma interface necessária para tipos de entidade de tabela. A TableEntity interface declara os métodos getter e setter para as propriedades comuns da entidade e os métodos para serialização e desserialização de todas as propriedades de entidade usando um mapa de propriedades. Crie classes implementando TableEntity para personalizar o armazenamento de propriedades, a recuperação, a serialização e a desserialização e para fornecer lógica personalizada adicional para uma entidade de tabela. A biblioteca de clientes de armazenamento inclui duas implementações que TableEntity fornecem acesso à propriedade simples e serialização: DynamicTableEntityTableEntity implementa e fornece um mapa de propriedades simples para armazenar e recuperar propriedades. Use um DynamicTableEntity para acesso simples às propriedades da entidade quando apenas um subconjunto de propriedades for retornado (por exemplo, por uma cláusula select em uma consulta) ou quando sua consulta puder retornar vários tipos de entidade com propriedades diferentes. Você também pode usar este tipo para executar atualizações da tabela em massa de entidades heterogêneas sem perder informações de propriedade. TableServiceEntity é uma implementação de TableEntity que usa o comportamento de serialização e desserialização baseados em reflexão em seus métodos e . TableServiceEntityClasses derivadas de com métodos que seguem uma convenção para tipos e nomenclatura são serializadas e desserializadas automaticamente. Qualquer classe que implementa TableEntity pode aproveitar o comportamento automático de serialização e desserialização baseado em reflexão em TableServiceEntity invocando os métodos estáticos em e em . A classe deve fornecer métodos que seguem o tipo e a convenção de nomenclatura a serem serializados e desserializados automaticamente. Quando um método getter e um método setter são encontrados para um determinado nome de propriedade e tipo de dados, o método apropriado é invocado automaticamente para serializar ou desserializar os dados. O código de reflexão procura métodos getter e setter em pares do formulário e em que PropertyName é um nome de propriedade para a entidade de tabela e type é um tipo Java compatível com o tipo de dados EDM da propriedade. Consulte a tabela na descrição da classe para obter TableServiceEntity um mapa de tipos de propriedade para seus equivalentes java. A StoreAs anotação pode ser aplicada com um atributo para especificar um nome de propriedade para reflexão sobre métodos getter e setter que não seguem a convenção de nome da propriedade. Os nomes de método e o atributo de StoreAs anotações diferenciam maiúsculas de minúsculas para nomes de propriedade correspondentes com reflexão. Use a Ignore anotação para impedir que métodos sejam usados pela reflexão para serialização e desserialização automáticas. Observe que os nomes "PartitionKey", "RowKey", "Timestamp" e "Etag" são reservados e serão ignorados se definidos com a StoreAs anotação em uma subclasse que usa os métodos de reflexão.
TableRequestOptions.EncryptionResolver	A interface cuja função é usada para obter o valor que indica se uma propriedade deve ser criptografada ou não dada a chave de partição, a chave de linha e o nome da propriedade.
TableRequestOptions.PropertyResolver	A interface cuja função é usada para obter o EdmType para uma propriedade de entidade, considerando a chave de partição, a linha, a chave e o nome da propriedade, se a interface for implementada

Enumerações

EdmType	Uma enumeração usada para representar os tipos primitivos do EDM (Modelo de Dados de Entidade) no Protocolo de Dados Abertos (OData). O EDM é o modelo de dados abstrato subjacente usado pelos serviços OData. A EdmType enumeração inclui um parse(final String value) método para converter nomes de tipo de dados EDM no tipo de enumeração e substitui o toString() método para produzir um nome de tipo de dados EDM. Para obter mais informações sobre o OData, consulte o site do Open Data Protocol . Para obter uma visão geral dos nomes e tipos de dados primitivos do EDM disponíveis, consulte a seção Tipos de Dados Primitivos da Visão Geral do Protocolo OData. O Sistema de Tipo Abstrato usado para definir os tipos primitivos compatíveis com o OData é definido em detalhes em [MC-CSDL] (seção 2.2.1).
SharedAccessTablePermissions	Especifica o conjunto de permissões possíveis para uma política de tabela de acesso compartilhado.
TablePayloadFormat	Descreve os formatos de carga com suporte para tabelas.