oracle.jdbc.pool
Class OracleConnectionEventListener

oracle.jdbc.pool.OracleConnectionEventListener

public class OracleConnectionEventListener

implements java.io.Serializable

A ConnectionEventListener is an object that registers to receive events generated by a PooledConnection.

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 ConnectionEventListener is notified by a JDBC driver when an application is finished using its Connection object. This event occurs after the application calls close on its representation of the PooledConnection. 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.

OracleConnectionEventListener implements ConnectionEventListener

See Also:

Serialized Form

Constructor Summary

OracleConnectionEventListener()
Default constructor

OracleConnectionEventListener(javax.sql.DataSource ds)
Construct an OracleConnectionEventListener with the DataSource as it's argument.

Method Summary

void	connectionClosed(oracle.jdbc.pool.ConnectionEvent ce) Invoked when the application calls close() on its representation of the connection.
void	connectionErrorOccurred(oracle.jdbc.pool.ConnectionEvent ce) Invoked when a fatal connection error occurs, just before an SQLException is thrown to the application.
void	setDataSource(javax.sql.DataSource ds) Set the DataSource corresponding to this listener.

Constructor Detail

OracleConnectionEventListener

public OracleConnectionEventListener()

Default constructor

OracleConnectionEventListener

public OracleConnectionEventListener(javax.sql.DataSource ds)

Construct an OracleConnectionEventListener with the DataSource as it's argument.

Parameters:

DataSource - corresponding to this listener

Method Detail

setDataSource

public void setDataSource(javax.sql.DataSource ds)

Set the DataSource corresponding to this listener.

Parameters:

DataSource - corresponding to this listener

connectionClosed

public void connectionClosed(oracle.jdbc.pool.ConnectionEvent ce)

Invoked when the application calls close() on its representation of the connection.

Parameters:

event - an event object describing the source of the event

connectionErrorOccurred

public void connectionErrorOccurred(oracle.jdbc.pool.ConnectionEvent ce)

Invoked when a fatal connection error occurs, just before an SQLException is thrown to the application.

Parameters:

event - an event object describing the source of the event