Package javax.sql

Interface ConnectionEventListener

  • All Superinterfaces:
    EventListener
    public interface ConnectionEventListener
extends EventListener
    An interface used to receive events generated by a PooledConnection.

    This interface would typically be implemented by a component which manages a connection pool (a connection pool manager). A connection triggers an event to a ConnectionEventListener either when the application closes a connection it has been using or when a significant error occurs while the connection is being used.

    The connection pool manager can return closed connections to the pool for later reuse. Connections experiencing an error should be discarded.

    • Method Detail

      • connectionClosed

        void connectionClosed​(ConnectionEvent theEvent)
        Notifies the ConnectionEventListener that an application has called the close method on a pooled connection.
        Parameters:
        theEvent - a ConnectionEvent containing details about the source of the event.

      • connectionErrorOccurred

        void connectionErrorOccurred​(ConnectionEvent theEvent)
        Notifies the ConnectionEventListener that an error has occurred on a PooledConnection. This notification is triggered before the SQLException, which is available through the event argument, is thrown.
        Parameters:
        theEvent - a ConnectionEvent containing details about the source of the event and the SQLException that has occurred.