Package com.google.appengine.api.datastore

Interface AsyncDatastoreService

All Superinterfaces:

BaseDatastoreService

All Known Implementing Classes:

AdminDatastoreService

public interface AsyncDatastoreService
extends BaseDatastoreService

An asynchronous version of DatastoreService. All methods return immediately and provide Futures as their return values.

The key difference between implementations of AsyncDatastoreService and implementations of DatastoreService is that async implementations do not perform implicit transaction management. The reason is that implicit transaction management requires automatic commits of some transactions, and without some sort of callback mechanism there is no way to determine that a put/get/delete that has been implicitly enrolled in a transaction is complete and therefore ready to be committed. See ImplicitTransactionManagementPolicy for more information.

Method Summary

Modifier and Type	Method	Description
Future<KeyRange>	allocateIds(@Nullable Key parent, String kind, long num)	See DatastoreService.allocateIds(Key, String, long).
Future<KeyRange>	allocateIds(String kind, long num)	See DatastoreService.allocateIds(String, long).
Future<Transaction>	beginTransaction()	See DatastoreService.beginTransaction().
Future<Transaction>	beginTransaction(TransactionOptions options)	See DatastoreService.beginTransaction(TransactionOptions).
Future<Void>	delete(@Nullable Transaction txn, Key... keys)	See DatastoreService.delete(Transaction, Iterable).
Future<Void>	delete(@Nullable Transaction txn, Iterable<Key> keys)	See DatastoreService.delete(Transaction, Iterable).
Future<Void>	delete(Key... keys)	See DatastoreService.delete(Key...).
Future<Void>	delete(Iterable<Key> keys)	See DatastoreService.delete(Iterable).
Future<Entity>	get(@Nullable Transaction txn, Key key)	See DatastoreService.get(Transaction, Key).
Future<Map<Key,Entity>>	get(@Nullable Transaction txn, Iterable<Key> keys)	See DatastoreService.get(Transaction, Iterable).
Future<Entity>	get(Key key)	See DatastoreService.get(Key).
Future<Map<Key,Entity>>	get(Iterable<Key> keys)	See DatastoreService.get(Iterable).
Future<DatastoreAttributes>	getDatastoreAttributes()	See DatastoreService.getDatastoreAttributes().
Future<Map<Index,Index.IndexState>>	getIndexes()	See DatastoreService.getIndexes().
Future<Key>	put(@Nullable Transaction txn, Entity entity)	See DatastoreService.put(Transaction, Entity).
Future<List<Key>>	put(@Nullable Transaction txn, Iterable<Entity> entities)	See DatastoreService.put(Transaction, Iterable).
Future<Key>	put(Entity entity)	See DatastoreService.put(Entity).
Future<List<Key>>	put(Iterable<Entity> entities)	See DatastoreService.put(Iterable).

Methods inherited from interface com.google.appengine.api.datastore.BaseDatastoreService

getActiveTransactions, getCurrentTransaction, getCurrentTransaction, prepare, prepare

Method Detail

get

Future<Entity> get(Key key)

See DatastoreService.get(Key).

get

Future<Entity> get(@Nullable Transaction txn,
                   Key key)

See DatastoreService.get(Transaction, Key).

get

Future<Map<Key,Entity>> get(Iterable<Key> keys)

See DatastoreService.get(Iterable).

get

Future<Map<Key,Entity>> get(@Nullable Transaction txn,
                                  Iterable<Key> keys)

See DatastoreService.get(Transaction, Iterable).

put

Future<Key> put(Entity entity)

See DatastoreService.put(Entity).

put

Future<Key> put(@Nullable Transaction txn,
                Entity entity)

See DatastoreService.put(Transaction, Entity).

put

Future<List<Key>> put(Iterable<Entity> entities)

See DatastoreService.put(Iterable).

put

Future<List<Key>> put(@Nullable Transaction txn,
                      Iterable<Entity> entities)

See DatastoreService.put(Transaction, Iterable).

delete

Future<Void> delete(Key... keys)

See DatastoreService.delete(Key...).

delete

Future<Void> delete(@Nullable Transaction txn,
                    Key... keys)

See DatastoreService.delete(Transaction, Iterable).

delete

Future<Void> delete(Iterable<Key> keys)

See DatastoreService.delete(Iterable).

delete

Future<Void> delete(@Nullable Transaction txn,
                    Iterable<Key> keys)

See DatastoreService.delete(Transaction, Iterable).

beginTransaction

Future<Transaction> beginTransaction()

See DatastoreService.beginTransaction().

beginTransaction

Future<Transaction> beginTransaction(TransactionOptions options)

See DatastoreService.beginTransaction(TransactionOptions).

allocateIds

Future<KeyRange> allocateIds(String kind,
                             long num)

See DatastoreService.allocateIds(String, long).

allocateIds

Future<KeyRange> allocateIds(@Nullable Key parent,
                             String kind,
                             long num)

See DatastoreService.allocateIds(Key, String, long).

getDatastoreAttributes

Future<DatastoreAttributes> getDatastoreAttributes()

See DatastoreService.getDatastoreAttributes().

getIndexes

Future<Map<Index,Index.IndexState>> getIndexes()

See DatastoreService.getIndexes().