javax.sql
Interface PooledConnection

All Known Subinterfaces:
XAConnection (src)
All Known Implementing Classes:
MockedXADataSource.MockedXAConnection (src)

public interface PooledConnection

A PooledConnection object is a connection object that provides hooks for connection pool management. A PooledConnection object represents a physical connection to a data source.


Method Summary
 void addConnectionEventListener(ConnectionEventListener (src)  connectionEventListener)
          Add an event listener.
 void close()
          Close the physical connection.
 java.sql.Connection getConnection()
          Create an object handle for this physical connection.
 void removeConnectionEventListener(ConnectionEventListener (src)  connectionEventListener)
          Remove an event listener.
 

Method Detail

addConnectionEventListener

public void addConnectionEventListener(ConnectionEventListener (src)  connectionEventListener)
Add an event listener.

Parameters:
connectionEventListener - - The listener

close

public void close()
           throws java.sql.SQLException
Close the physical connection.

Throws:
java.sql.SQLException - - if a database-access error occurs.

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException
Create an object handle for this physical connection. The object returned is a temporary handle used by application code to refer to a physical connection that is being pooled.

Returns:
a Connection object
Throws:
java.sql.SQLException - - if a database-access error occurs.

removeConnectionEventListener

public void removeConnectionEventListener(ConnectionEventListener (src)  connectionEventListener)
Remove an event listener.

Parameters:
connectionEventListener - - The listener