com.google.appengine.api.datastore
Interface AsyncDatastoreService

public interface AsyncDatastoreService

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

java.util.concurrent.Future<java.lang.Void>	delete(java.lang.Iterable<Key> keys)
java.util.concurrent.Future<java.lang.Void>	delete(Key... keys)
java.util.concurrent.Future<java.lang.Void>	delete(Transaction txn, java.lang.Iterable<Key> keys)
java.util.concurrent.Future<java.lang.Void>	delete(Transaction txn, Key... keys)
java.util.concurrent.Future<java.util.Map<Key,Entity>>	get(java.lang.Iterable<Key> keys)
java.util.concurrent.Future<Entity>	get(Key key)
java.util.concurrent.Future<java.util.Map<Key,Entity>>	get(Transaction txn, java.lang.Iterable<Key> keys)
java.util.concurrent.Future<Entity>	get(Transaction txn, Key key)
java.util.concurrent.Future<Key>	put(Entity entity)
java.util.concurrent.Future<java.util.List<Key>>	put(java.lang.Iterable<Entity> entities)
java.util.concurrent.Future<Key>	put(Transaction txn, Entity entity)
java.util.concurrent.Future<java.util.List<Key>>	put(Transaction txn, java.lang.Iterable<Entity> entities)

Method Detail

get

java.util.concurrent.Future<Entity> get(Key key)

See Also:

DatastoreService.get(Key)

get

java.util.concurrent.Future<Entity> get(Transaction txn,
                                        Key key)

See Also:

DatastoreService.get(Transaction, Key)

get

java.util.concurrent.Future<java.util.Map<Key,Entity>> get(java.lang.Iterable<Key> keys)

See Also:

DatastoreService.get(Iterable)

get

java.util.concurrent.Future<java.util.Map<Key,Entity>> get(Transaction txn,
                                                           java.lang.Iterable<Key> keys)

See Also:

DatastoreService.get(Transaction, Iterable)

put

java.util.concurrent.Future<Key> put(Entity entity)

See Also:

DatastoreService.put(Entity)

put

java.util.concurrent.Future<Key> put(Transaction txn,
                                     Entity entity)

See Also:

DatastoreService.put(Transaction, Entity)

put

java.util.concurrent.Future<java.util.List<Key>> put(java.lang.Iterable<Entity> entities)

See Also:

DatastoreService.put(Iterable)

put

java.util.concurrent.Future<java.util.List<Key>> put(Transaction txn,
                                                     java.lang.Iterable<Entity> entities)

See Also:

DatastoreService.put(Transaction, Iterable)

delete

java.util.concurrent.Future<java.lang.Void> delete(Key... keys)

See Also:

DatastoreService.delete(Key...)

delete

java.util.concurrent.Future<java.lang.Void> delete(Transaction txn,
                                                   Key... keys)

See Also:

DatastoreService.delete(Transaction, Iterable)

delete

java.util.concurrent.Future<java.lang.Void> delete(java.lang.Iterable<Key> keys)

See Also:

DatastoreService.delete(Iterable)

delete

java.util.concurrent.Future<java.lang.Void> delete(Transaction txn,
                                                   java.lang.Iterable<Key> keys)

See Also:

DatastoreService.delete(Transaction, Iterable)