Package ubic.gemma.persistence.persister

Class AbstractPersister

  • All Implemented Interfaces:
    Persister
    Direct Known Subclasses:
    CommonPersister
    public abstract class AbstractPersister
extends Object
implements Persister
    Base class for Persister implementations.

    Important note: persisting is a somewhat complicated process, and for some reason we cannot afford to let Hibernate flush changes to the database until the whole operation is completed. This is why we use the FlushMode.MANUAL, manually flush, and we subsequently restore it to the default FlushMode.AUTO when done.

    Author:
    pavlidis

    • Field Detail

      • log

        protected static final org.apache.commons.logging.Log log
        Shared logger for all persisters.

      • REPORT_BATCH_SIZE

        protected static final int REPORT_BATCH_SIZE
        Size if batch to report when persisting multiple entities with doPersist(Collection, Caches).

        Implementations can use this to have a consistent batch size when reporting.

        See Also:
        Constant Field Values

    • Constructor Detail

      • AbstractPersister

        public AbstractPersister()

    • Method Detail

      • persist

        @Transactional
public Object persist​(Object entity)
        Description copied from interface: Persister
        Persist a single object. Non-nullable dependencies are checked and persisted first, if the reference is detached, or converted into a reference to a persistent object identified by the objects business key. If a matching object already exists, it will not be changed.
        Specified by:
        persist in interface Persister
        Parameters:
        entity - the object
        Returns:
        the persistent version of the object.

      • persistOrUpdate

        @Transactional
public Object persistOrUpdate​(Object entity)
        Description copied from interface: Persister
        Persist or update a single object. If the object already exists in the system, it will be replaced with the supplied instance. This means that any existing data may be lost. Otherwise a new persistent instance will be created from the supplied instance. Non-nullable dependencies will be replaced with existing persistent ones or created anew: Associated objects will not be updated if they already exist. Therefore this method has limited usefulness: when the provided object has new data but the associated objects are either new or already existing. If you want to update associated objects you must update them explicitly (perhaps with a call to persistOrUpdate on them).
        Specified by:
        persistOrUpdate in interface Persister
        Parameters:
        entity - the object
        Returns:
        the persistent version of the object.

      • persist

        @Transactional
public List<?> persist​(Collection<?> col)
        Description copied from interface: Persister
        Persist all the objects in a collection. Non-nullable dependencies are checked and persisted first, if the reference is detached, or converted into a reference to a persistent object identified by the objects business key. Matching instances are not changed.
        Specified by:
        persist in interface Persister
        Parameters:
        col - the collection of objects
        Returns:
        The persistent versions of the objects.