Class JPACallbackHandler

java.lang.Object
org.castor.cpa.jpa.info.JPACallbackHandler
All Implemented Interfaces:
CallbackInterceptor

public class JPACallbackHandler extends Object implements CallbackInterceptor
Handles JPA annotation-driven callback hooks.
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    created(Object object)
    Called to indicate that an object has been created.
    void
    creating(Object object, Database db)
    Called to indicate that an object is to be created in persistent storage.
    loaded(Object object, AccessMode accessMode)
    Called to indicate that the object has been loaded from persistent storage.
    void
    modifying(Object object)
    Called to indicate that an object has been modified and is up to storing.
    void
    releasing(Object object, boolean committed)
    Called to indicate that an object has been made transient.
    void
    removed(Object object)
    Called to indicate that an object has been deleted.
    void
    removing(Object object)
    Called to indicate that an object is to be deleted.
    void
    storing(Object object, boolean modified)
    Called to indicate that an object is to be stored in persistent storage.
    void
    updated(Object object)
    Called to indicate that an object has been updated at the end of a "long" transaction.
    void
    using(Object object, Database db)
    Called to indicate that an object has been made persistent.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

    • JPACallbackHandler

      public JPACallbackHandler()
  • Method Details

    • loaded

      public Class<?> loaded(Object object, AccessMode accessMode) throws Exception
      Description copied from interface: CallbackInterceptor
      Called to indicate that the object has been loaded from persistent storage.
      Specified by:
      loaded in interface CallbackInterceptor
      Parameters:
      object - The object
      Returns:
      null or the extending Class. In the latter case Castor will reload the object of the given class with the same identity.
      Throws:
      Exception - An exception occured, the object cannot be loaded
    • modifying

      public void modifying(Object object) throws Exception
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object has been modified and is up to storing.
      Specified by:
      modifying in interface CallbackInterceptor
      Parameters:
      object - The object
      Throws:
      Exception - An exception occured, the object cannot be stored
    • storing

      public void storing(Object object, boolean modified) throws Exception
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object is to be stored in persistent storage.
      Specified by:
      storing in interface CallbackInterceptor
      Parameters:
      object - The object
      modified - Is the object modified?
      Throws:
      Exception - An exception occured, the object cannot be stored
    • creating

      public void creating(Object object, Database db) throws Exception
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object is to be created in persistent storage.
      Specified by:
      creating in interface CallbackInterceptor
      Parameters:
      object - The object
      db - The database in which this object will be created
      Throws:
      Exception
    • created

      public void created(Object object) throws Exception
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object has been created.
      Specified by:
      created in interface CallbackInterceptor
      Parameters:
      object - The object
      Throws:
      Exception
    • removing

      public void removing(Object object) throws Exception
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object is to be deleted.

      This method is made at commit time on objects deleted during the transaction before setting their fields to null.

      Specified by:
      removing in interface CallbackInterceptor
      Parameters:
      object - The object
      Throws:
      Exception
    • removed

      public void removed(Object object) throws Exception
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object has been deleted.

      This method is called during db.remove().

      Specified by:
      removed in interface CallbackInterceptor
      Parameters:
      object - The object
      Throws:
      Exception
    • releasing

      public void releasing(Object object, boolean committed)
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object has been made transient.

      This method is made at commit or rollback time on all objects that were presistent during the life time of the transaction.

      Specified by:
      releasing in interface CallbackInterceptor
      Parameters:
      object - The object
      committed - True if the object has been commited, false if rollback or otherwise cancelled
    • using

      public void using(Object object, Database db)
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object has been made persistent.
      Specified by:
      using in interface CallbackInterceptor
      Parameters:
      object - The object
      db - The database to which this object belongs
    • updated

      public void updated(Object object) throws Exception
      Description copied from interface: CallbackInterceptor
      Called to indicate that an object has been updated at the end of a "long" transaction.
      Specified by:
      updated in interface CallbackInterceptor
      Parameters:
      object - The object
      Throws:
      Exception