Package oracle.ucp.jdbc.oracle

Class OracleXADataSourceConnectionFactoryAdapter

java.lang.Object

oracle.ucp.common.ConnectionFactoryAdapterBase

oracle.ucp.jdbc.JDBCConnectionFactoryAdapter

oracle.ucp.jdbc.XADataSourceConnectionFactoryAdapter

oracle.ucp.jdbc.oracle.OracleXADataSourceConnectionFactoryAdapter

All Implemented Interfaces:

ConnectionFactoryAdapter

public class OracleXADataSourceConnectionFactoryAdapter
extends XADataSourceConnectionFactoryAdapter

The connection factory adapter for Oracle's JDBC javax.sql.XADataSources implementation. The physical connections that this adapter creates and closes are instances of javax.sql.XAConnection. 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.XAConnection object is closed.

See Also:

XADataSourceConnectionFactoryAdapter

Field Summary

Fields inherited from class oracle.ucp.jdbc.JDBCConnectionFactoryAdapter

m_url

Fields inherited from class oracle.ucp.jdbc.XADataSourceConnectionFactoryAdapter

m_xaDataSource

Constructor Summary

Constructors

Constructor	Description
OracleXADataSourceConnectionFactoryAdapter(XADataSource xaDataSource)	Constructor.

Method Summary

Modifier and Type	Method	Description
Object	createConnection(ConnectionRetrievalInfo connectionRequestInfo)	Creates a javax.sql.XAConnection.
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.JDBCConnectionFactoryAdapter

getUrl

Methods inherited from class java.lang.Object

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

Methods inherited from class oracle.ucp.jdbc.XADataSourceConnectionFactoryAdapter

closeConnection, getXaDataSource

Constructor Detail

OracleXADataSourceConnectionFactoryAdapter

public OracleXADataSourceConnectionFactoryAdapter(XADataSource xaDataSource)
                                           throws UniversalConnectionPoolException

Constructor.

Parameters:

xaDataSource - The XA data source.

Throws:

UniversalConnectionPoolException - if an error occurs during construction.

Method Detail

createConnection

public Object createConnection(ConnectionRetrievalInfo connectionRequestInfo)
                        throws UniversalConnectionPoolException

Description copied from class: XADataSourceConnectionFactoryAdapter

Creates a javax.sql.XAConnection.

Specified by:

createConnection in interface ConnectionFactoryAdapter

Overrides:

createConnection in class XADataSourceConnectionFactoryAdapter

Parameters:

connectionRequestInfo - The information to use to create the connection.

Returns:

The javax.sql.XAConnection. 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.