com.googlecode.objectify.cmd

Interface DeferredSaver

All Known Implementing Classes:

DeferredSaverImpl

public interface DeferredSaver

Element in the command chain for deferred saving of entities. Note that all methods return void; there is no way to force synchronous execution.

Author:

Jeff Schnitzer

Method Summary

Modifier and Type	Method and Description
void	entities(Iterable<?> entities) Save a batch of entities in the datastore at the end of the current unit-of-work.
void	entities(Object... entities) A convenience method for entities(Iterable)
void	entity(Object entity) Save a single entity in the datastore at the end of the current unit-of-work.

Method Detail

entity

void entity(Object entity)

Save a single entity in the datastore at the end of the current unit-of-work.

This method can be called multiple times on a single entity; that will produce a single save. If deferred saves and deletes are applied to an entity, the last one wins.

If the entity has a null Long id, the value will be autogenerated and populated on the entity object when the operation completes. Since this is a deferred operation, that will be past the end of your unit-of-work (transaction boundary).

Saves do not cascade.

Parameters:

entity - must be a registered entity type

entities

void entities(Iterable<?> entities)

Save a batch of entities in the datastore at the end of the current unit-of-work.

This method can be called multiple times on a single entity; that will produce a single save. If deferred saves and deletes are applied to an entity, the last one wins.

If any entities have null Long ids, the values will be autogenerated and populated on the entity objects when the operation completes. Since this is a deferred operation, that will be past the end of your unit-of-work (transaction boundary).

Saves do not cascade.

Parameters:

entities - must be registered entity types

entities

void entities(Object... entities)

A convenience method for entities(Iterable)