com.google.cloud.datastore

Interface DatastoreWriter

All Known Subinterfaces:

Batch, Datastore, com.google.cloud.datastore.DatastoreBatchWriter, DatastoreReaderWriter, Transaction

public interface DatastoreWriter

An interface to represent Google Cloud Datastore write operations.

Method Summary

Methods

Modifier and Type	Method and Description
List<Entity>	add(FullEntity<?>... entity) Datastore add operation.
Entity	add(FullEntity<?> entity) Datastore add operation.
void	delete(Key... key) A datastore delete operation.
void	put(Entity... entity) A Datastore put (a.k.a upsert) operation.
void	update(Entity... entity) A Datastore update operation.

Method Detail

add

Entity add(FullEntity<?> entity)

Datastore add operation. This method will automatically allocate an id if necessary.

Parameters:

entity - the entity to add

Returns:

an Entity with the same properties and a key that is either newly allocated or the same one if key is already complete

Throws:

DatastoreException - upon failure

IllegalArgumentException - if the given entity is missing a key

add

List<Entity> add(FullEntity<?>... entity)

Datastore add operation. This method will automatically allocate id for any entity with an incomplete key.

Returns:

a list of Entity ordered by input with the same properties and a key that is either newly allocated or the same one if was already complete

Throws:

DatastoreException - upon failure

IllegalArgumentException - if any of the given entities is missing a key

See Also:

add(FullEntity)

update

void update(Entity... entity)

A Datastore update operation. The operation will fail if an entity with the same key does not already exist.

put

void put(Entity... entity)

A Datastore put (a.k.a upsert) operation. The operation will add or modify the entities.

delete

void delete(Key... key)

A datastore delete operation. It is OK request a deletion of a non-existing entity.