Pacote com.google.appengine.api.datastore

O armazenamento de dados fornece armazenamento persistente para os aplicativos do Google App Engine, usados diretamente ou por meio das interfaces JDO ou JPA fornecidas.

Consulte:
Descrição

Resumo da interface

DatastoreConfig	Propriedades do armazenamento de dados configuráveis pelo usuário.
DatastoreService	O DatastoreService oferece acesso a um sistema de armazenamento de dados sem esquema.
PreparedQuery	Contém métodos para obter e retornar entidades de uma Query.
Transaction	Descreve uma unidade lógica de trabalho a ser executada no armazenamento de dados.

Resumo da classe

Blob	Blob contém uma matriz de bytes de tamanho ilimitado.
DatastoreServiceFactory	Cria implementações de DatastoreService.
DataTypeTranslator	DataTypeTranslator é uma classe de utilitário para conversão entre os buffers de protocolo Property do armazenamento de dados e as classes voltadas ao usuário (String, User etc.).
DataTypeTranslator.ComparableByteArray	Um empacotador para um byte[] que implementa Comparable.
DataTypeUtils	DataTypeUtils apresenta uma interface mais simples que permite que o código de usuário determine quais Classes podem ser armazenadas com segurança como propriedades no armazenamento de dados.
Entity	Entity é a unidade fundamental do armazenamento de dados.
EntityTranslator	EntityTranslator contém a lógica para traduzir uma Entity para os buffers de protocolo que são usados para passá-la para a implementação da API.
FetchOptions	Descreve o limite, o deslocamento e o tamanho do bloco a serem aplicados ao executar uma PreparedQuery.
FetchOptions.Builder	Contém métodos de criação estáticos para FetchOptions.
Key	A chave principal de uma entidade do armazenamento de dados.
KeyFactory	Permite criar objetos Key arbitrários no grupo de entidades raiz (sem pai).
KeyFactory.Builder	Classe Helper que auxilia na construção de Keys com precedentes.
Link	Um Link é um URL de comprimento limitado.
Query	Query encapsula uma solicitação de zero ou mais objetos Entity do armazenamento de dados.
Query.FilterPredicate	FilterPredicate é um recipiente de dados que contém um predicado de filtro exclusivo.
Query.SortPredicate	SortPredicate é um recipiente de dados que contém um predicado de classificação exclusivo.
ShortBlob	ShortBlob contém uma matriz de bytes que não deve ultrapassar DataTypeUtils.MAX_SHORT_BLOB_PROPERTY_LENGTH
Text	Text se ajusta a uma string de tamanho ilimitado.

Resumo da enum

ImplicitTransactionManagementPolicy	Descreve as diversas políticas que o armazenamento de dados pode seguir para o gerenciamento de transação implícita.
Query.FilterOperator	FilterOperator especifica qual tipo de operação você deseja aplicar ao seu filtro.
Query.SortDirection	SortDirection controla a ordem de uma classificação.

Resumo da exceção

DatastoreFailureException	DatastoreFailureException é gerada quando ocorre algum erro desconhecido durante a comunicação com o armazenamento de dados.
DatastoreNeedIndexException	DatastoreNeedIndexException é gerada quando uma consulta que requer um índice não encontra um índice correspondente.
DatastoreTimeoutException	DatastoreTimeoutException é gerada quando uma operação do armazenamento de dados chega ao tempo limite.
EntityNotFoundException	EntityNotFoundException é gerada quando não é encontrada nenhuma Entity com a Key especificada.
PreparedQuery.TooManyResultsException	Indica que foram encontrados muitos resultados para PreparedQuery.asSingleEntity().

Pacote com.google.appengine.api.datastore Descrição

O armazenamento de dados fornece armazenamento persistente para os aplicativos do Google App Engine, usados diretamente ou por meio das interfaces JDO ou JPA fornecidas. Ele oferece armazenamento redundante para tolerância a falhas. Para obter mais informações, consulte a documentação on-line.

Este pacote contém uma API de nível inferior para o armazenamento de dados destinada principalmente aos autores de estruturas. Os autores de aplicativos devem considerar o uso das interfaces JDO ou JPA fornecidas para o armazenamento de dados. Ao usar diretamente a API de armazenamento de dados, um padrão comum de uso é:

 // Get a handle on the datastore itself
 DatastoreService datastore = DatastoreServiceFactory.getDatastoreService();

 // Lookup data by known key name
 Entity userEntity = datastore.get(KeyFactory.createKey("UserInfo", email));

 // Or perform a query
 Query query = new Query("Task", userEntity);
 query.addFilter("dueDate", Query.FilterOperator.LESS_THAN, today);
 for (Entity taskEntity : datastore.prepare(query).asIterable()) {
   if ("done".equals(taskEntity.getProperty("status"))) {
     datastore.delete(taskEntity);
   } else {
     taskEntity.setProperty("status", "overdue");
     datastore.put(taskEntity);
   }
 }
 

Isso ilustra vários pontos básicos:

• O armazenamento de dados real é acessado por meio de um objeto DatastoreService, produzido a partir de uma DatastoreServiceFactory.
• A unidade de armazenagem é o objeto Entity, que é de tipo nomeado ("UserInfo" e "Task" acima).
• As entidades possuem um valor Key, que pode ser criado por uma KeyFactory para recuperar uma determinada entidade conhecida. Se a chave não for determinada imediatamente, os objetos Query podem ser usados para recuperar uma Entity, múltipla como uma lista, Interable ou Iterator, ou para recuperar a contagem de entidades correspondentes.
• As entidades possuem propriedades nomeadas, cujos valores podem ser tipos básicos ou coleções de tipos básicos. Objetos mais complexos, obviamente, podem ser armazenados se forem serializados como matrizes de bytes, embora isso possa evitar que as propriedades realizem consultas eficazes.
• As entidades podem ser associadas em uma estrutura de árvore. A Query no snippet acima pesquisa somente entidades Task associadas a uma entidade UserInfo específica e, em seguida, filtra as Tasks que expiraram antes de hoje.

Durante a produção, não podem ser realizadas consultas complexas até que um ou mais índices sejam construídos para garantir o processamento eficiente das consultas individuais. Você pode especificar o conjunto de índices que o seu aplicativo exige em um arquivo WEB-INF/datastore-indexes.xml ou pode gerá-los automaticamente ao testar o seu aplicativo no servidor de desenvolvimento. Se uma consulta requerer um índice que não pode ser encontrado, será gerada uma DatastoreNeedIndexException na execução.

Embora o Google App Engine permita acesso a muitas versões do seu aplicativo, ele possui apenas um armazenamento de dados, que é compartilhado por todas as versões. Da mesma maneira, todas as versões do aplicativo compartilham o conjunto de índices.