EventListener
public interface ConnectionEventListener extends EventListener
An object that registers to be notified of events generated by a PooledConnection
object.
The ConnectionEventListener
interface is implemented by a connection pooling component. A connection pooling component will usually be provided by a JDBC driver vendor or another system software vendor. A JDBC driver notifies a ConnectionEventListener
object when an application is finished using a pooled connection with which the listener has registered. The notification occurs after the application calls the method close
on its representation of a PooledConnection
object. A ConnectionEventListener
is also notified when a connection error occurs due to the fact that the PooledConnection
is unfit for future use---the server has crashed, for example. The listener is notified by the JDBC driver just before the driver throws an SQLException
to the application using the PooledConnection
object.
Modifier and Type | Method | Description |
---|---|---|
void |
connectionClosed |
Notifies this ConnectionEventListener that the application has called the method close on its representation of a pooled connection. |
void |
connectionErrorOccurred |
Notifies this ConnectionEventListener that a fatal error has occurred and the pooled connection can no longer be used. |
void connectionClosed(ConnectionEvent event)
ConnectionEventListener
that the application has called the method close
on its representation of a pooled connection.event
- an event object describing the source of the eventvoid connectionErrorOccurred(ConnectionEvent event)
ConnectionEventListener
that a fatal error has occurred and the pooled connection can no longer be used. The driver makes this notification just before it throws the application the SQLException
contained in the given ConnectionEvent
object.event
- an event object describing the source of the event and containing the SQLException
that the driver is about to throw
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.sql/javax/sql/ConnectionEventListener.html