Package com.sun.jdo.api.persistence.support

Interface InstanceCallbacks

public interface InstanceCallbacks
A PersistenceCapable class that provides callback methods for life cycle events implements this interface.

Classes which include derived fields (transient fields whose values depend on the values of persistent fields) require callbacks on specific JDO Instance life cycle events in order to correctly populate the values in these fields.

This interface defines the methods executed by the PersistenceManager for these life cycle events. If the class implements InstanceCallbacks, it must explicitly declare it in the class definition. The Reference Enhancer does not modify the declaration or any of the methods in the interface.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    jdoPostLoad()
    Called after the values are loaded from the data store into this instance.
    void
    jdoPreClear()
    Called before the values in the instance are cleared.
    void
    jdoPreStore()
    Called before the values are stored from this instance to the data store.

  • Method Details

    • jdoPostLoad

      void jdoPostLoad()
      Called after the values are loaded from the data store into this instance.

      Derived fields should be initialized in this method.

      This method is never modified by the Reference Enhancer.

    • jdoPreStore

      void jdoPreStore()
      Called before the values are stored from this instance to the data store.

      Database fields that might have been affected by modified derived fields should be updated in this method.

      This method is never modified by the Reference Enhancer.

    • jdoPreClear

      void jdoPreClear()
      Called before the values in the instance are cleared.

      Transient fields should be cleared in this method, as they will not be affected by the jdoClear method. Associations between this instance and others in the runtime environment should be cleared.

      This method is never modified by the Reference Enhancer.