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

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method 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)