Interface DatabaseEventListener

  • All Known Subinterfaces:
    DescriptorBasedDatabaseEventListener

    public interface DatabaseEventListener
    PUBLIC: Defines the API for integration with a database event notification service. This allows the EclipseLink cache to be invalidated by database change events. This is used to support Oracle DCN (Database Change event Notification), but could also be used by triggers or other services.
    See Also:
    DatabaseChangeNotificationType
    Author:
    James Sutherland
    Since:
    EclipseLink 2.4
    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void initialize​(ClassDescriptor descriptor, org.eclipse.persistence.internal.sessions.AbstractSession session)
      Initialize the descriptor to receive database change events.
      void register​(Session session)
      Register for database change events and invalidate the session's cache.
      void remove​(Session session)
      Remove registration from database change events.
    • Method Detail

      • register

        void register​(Session session)
        Register for database change events and invalidate the session's cache. This is called on session login.
      • remove

        void remove​(Session session)
        Remove registration from database change events. This is called on session logout.
      • initialize

        void initialize​(ClassDescriptor descriptor,
                        org.eclipse.persistence.internal.sessions.AbstractSession session)
        Initialize the descriptor to receive database change events. This is called when the descriptor is initialized.