Package oracle.ucp.jdbc.oracle

Class OracleConnectionPoolDataSourceConnectionFactoryAdapter

java.lang.Object

oracle.ucp.common.ConnectionFactoryAdapterBase

oracle.ucp.jdbc.JDBCConnectionFactoryAdapter

oracle.ucp.jdbc.ConnectionPoolDataSourceConnectionFactoryAdapter

oracle.ucp.jdbc.oracle.OracleConnectionPoolDataSourceConnectionFactoryAdapter

All Implemented Interfaces:

ConnectionFactoryAdapter

public class OracleConnectionPoolDataSourceConnectionFactoryAdapter
extends ConnectionPoolDataSourceConnectionFactoryAdapter

The connection factory adapter for Oracle's JDBC implementation of javx.sql.ConnectionPoolDataSource. The physical connections that this adapter creates and closes are instances of javax.sql.PooledConnection. When the javax.sql.PooledConnection object is created, the connection pool that is associated with this adapter is registered as a javax.sql.ConnectionEventListener (assuming the connection pool is a javax.sql.ConnectionEventListener). The connection pool is deregistered when the javax.sql.PooledConnection object is closed.

See Also:

ConnectionPoolDataSourceConnectionFactoryAdapter

Field Summary

Fields inherited from class oracle.ucp.jdbc.ConnectionPoolDataSourceConnectionFactoryAdapter

m_connectionPoolDataSource

Fields inherited from class oracle.ucp.jdbc.JDBCConnectionFactoryAdapter

m_url

Constructor Summary

Constructors

Constructor	Description
OracleConnectionPoolDataSourceConnectionFactoryAdapter(ConnectionPoolDataSource connectionPoolDataSource)	Constructor.

Method Summary

Modifier and Type	Method	Description
Object	createConnection(ConnectionRetrievalInfo connectionRequestInfo)	Creates a javax.sql.PooledConnection.
UniversalPooledConnection	createPooledConnection(Object connection, ConnectionRetrievalInfo connectionRequestInfo)	Creates a UniversalPooledConnection object.
void	initializeUrlFromConnectionFactory()	Initializes the connection url with the one set on the connection factory.
void	setUrl(String url)	Sets the supplied connection url on the connection factory.

Methods inherited from class oracle.ucp.common.ConnectionFactoryAdapterBase

getUniversalConnectionPool, setUniversalConnectionPool

Methods inherited from class oracle.ucp.jdbc.ConnectionPoolDataSourceConnectionFactoryAdapter

closeConnection, getConnectionPoolDataSource

Methods inherited from class oracle.ucp.jdbc.JDBCConnectionFactoryAdapter

getUrl

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OracleConnectionPoolDataSourceConnectionFactoryAdapter

public OracleConnectionPoolDataSourceConnectionFactoryAdapter(ConnectionPoolDataSource connectionPoolDataSource)
                                                       throws UniversalConnectionPoolException

Constructor.

Parameters:

connectionPoolDataSource - The Connection Pool data source.

Throws:

UniversalConnectionPoolException - if an error occurs during construction.

Method Detail

createConnection

public Object createConnection(ConnectionRetrievalInfo connectionRequestInfo)
                        throws UniversalConnectionPoolException

Description copied from class: ConnectionPoolDataSourceConnectionFactoryAdapter

Creates a javax.sql.PooledConnection.

Specified by:

createConnection in interface ConnectionFactoryAdapter

Overrides:

createConnection in class ConnectionPoolDataSourceConnectionFactoryAdapter

Parameters:

connectionRequestInfo - The information to use to create the connection.

Returns:

The javax.sql.PooledConnection. null if a connection could not be created.

Throws:

UniversalConnectionPoolException - if an error occurs creating the connection.

createPooledConnection

public UniversalPooledConnection createPooledConnection(Object connection,
                                                        ConnectionRetrievalInfo connectionRequestInfo)
                                                 throws UniversalConnectionPoolException

Creates a UniversalPooledConnection object.

Specified by:

createPooledConnection in interface ConnectionFactoryAdapter

Overrides:

createPooledConnection in class JDBCConnectionFactoryAdapter

Parameters:

connection - The physical connection that this pooled connection decorates.

connectionRequestInfo - The connection retrieval info object used to create the decorated connection.

Returns:

The created JDBCUniversalPooledConnection object.

Throws:

UniversalConnectionPoolException - if an error occurs creating the UniversalPooledConnection object.

initializeUrlFromConnectionFactory

public void initializeUrlFromConnectionFactory()

Description copied from class: JDBCConnectionFactoryAdapter

Initializes the connection url with the one set on the connection factory.

Overrides:

initializeUrlFromConnectionFactory in class JDBCConnectionFactoryAdapter

setUrl

public void setUrl(String url)

Description copied from class: JDBCConnectionFactoryAdapter

Sets the supplied connection url on the connection factory.

Overrides:

setUrl in class JDBCConnectionFactoryAdapter

Parameters:

url - The connection url to set on the connection factory.