Interface CallbackHandler

  • All Known Implementing Classes:
    ExecutionContextImpl.NullCallbackHandler

    public interface CallbackHandler
    CallBack handlers receive notification of events on persistent objects. Handlers are responsible for invoking event listeners/callback methods on Callback or Listener implementations. When a validation handler is set, the prePersist, preStore and preDelete callbacks will be routed through to this validation handler.
    • Method Summary

      All Methods Instance Methods Abstract Methods Default Methods 
      Modifier and Type Method Description
      void addListener​(java.lang.Object listener, java.lang.Class[] classes)
      Adds a new listener to this handler.
      void close()
      Clear any objects to release resources.
      default void postAttach​(java.lang.Object pc, java.lang.Object detachedPC)
      Callback after the object is attached.
      default void postClear​(java.lang.Object pc)
      Callback after the fields of the object are cleared.
      default void postCreate​(java.lang.Object pc)
      Callback after the object has been created.
      default void postDelete​(java.lang.Object pc)
      Callback after the object is deleted.
      default void postDetach​(java.lang.Object pc, java.lang.Object detachedPC)
      Callback after the object is detached.
      default void postDirty​(java.lang.Object pc)
      Callback after the object is made dirty.
      default void postLoad​(java.lang.Object pc)
      Callback after the fields of the object are loaded.
      default void postRefresh​(java.lang.Object pc)
      Callback after the fields of the object are refreshed.
      default void postStore​(java.lang.Object pc)
      Callback after the object is stored.
      default void preAttach​(java.lang.Object detachedPC)
      Callback before the object is attached.
      default void preClear​(java.lang.Object pc)
      Callback before the fields of the object are cleared.
      default void preDelete​(java.lang.Object pc)
      Callback before the object is deleted.
      default void preDetach​(java.lang.Object pc)
      Callback before the object is detached.
      default void preDirty​(java.lang.Object pc)
      Callback before the object is made dirty.
      default void prePersist​(java.lang.Object pc)
      Callback before the object is persisted (just before the lifecycle state change).
      default void preStore​(java.lang.Object pc)
      Callback before the object is stored.
      void removeListener​(java.lang.Object listener)
      Remove a listener for this handler.
    • Method Detail

      • postCreate

        default void postCreate​(java.lang.Object pc)
        Callback after the object has been created.
        Parameters:
        pc - The Object
      • prePersist

        default void prePersist​(java.lang.Object pc)
        Callback before the object is persisted (just before the lifecycle state change).
        Parameters:
        pc - The Object
      • preStore

        default void preStore​(java.lang.Object pc)
        Callback before the object is stored.
        Parameters:
        pc - The Object
      • postStore

        default void postStore​(java.lang.Object pc)
        Callback after the object is stored.
        Parameters:
        pc - The Object
      • preClear

        default void preClear​(java.lang.Object pc)
        Callback before the fields of the object are cleared.
        Parameters:
        pc - The Object
      • postClear

        default void postClear​(java.lang.Object pc)
        Callback after the fields of the object are cleared.
        Parameters:
        pc - The Object
      • preDelete

        default void preDelete​(java.lang.Object pc)
        Callback before the object is deleted.
        Parameters:
        pc - The Object
      • postDelete

        default void postDelete​(java.lang.Object pc)
        Callback after the object is deleted.
        Parameters:
        pc - The Object
      • preDirty

        default void preDirty​(java.lang.Object pc)
        Callback before the object is made dirty.
        Parameters:
        pc - The Object
      • postDirty

        default void postDirty​(java.lang.Object pc)
        Callback after the object is made dirty.
        Parameters:
        pc - The Object
      • postLoad

        default void postLoad​(java.lang.Object pc)
        Callback after the fields of the object are loaded.
        Parameters:
        pc - The Object
      • postRefresh

        default void postRefresh​(java.lang.Object pc)
        Callback after the fields of the object are refreshed.
        Parameters:
        pc - The Object
      • preDetach

        default void preDetach​(java.lang.Object pc)
        Callback before the object is detached.
        Parameters:
        pc - The Object
      • postDetach

        default void postDetach​(java.lang.Object pc,
                                java.lang.Object detachedPC)
        Callback after the object is detached.
        Parameters:
        pc - The Object
        detachedPC - The detached object
      • preAttach

        default void preAttach​(java.lang.Object detachedPC)
        Callback before the object is attached.
        Parameters:
        detachedPC - The Object
      • postAttach

        default void postAttach​(java.lang.Object pc,
                                java.lang.Object detachedPC)
        Callback after the object is attached.
        Parameters:
        pc - The attached Object
        detachedPC - The detached object
      • addListener

        void addListener​(java.lang.Object listener,
                         java.lang.Class[] classes)
        Adds a new listener to this handler.
        Parameters:
        listener - the listener instance
        classes - the persistent classes which events are fired for the listener
      • removeListener

        void removeListener​(java.lang.Object listener)
        Remove a listener for this handler.
        Parameters:
        listener - the listener instance
      • close

        void close()
        Clear any objects to release resources.