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 Summary

    Modifier and Type Method Description
    void connectionClosed​(ConnectionEvent theEvent)
    Notifies the ConnectionEventListener that an application has called the close method on a pooled connection.
    void connectionErrorOccurred​(ConnectionEvent theEvent)
    Notifies the ConnectionEventListener that an error has occurred on a PooledConnection.

  • Method Details

    • 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.