oracle.ucp.jdbc

Class XADataSourceConnectionFactoryAdapter

java.lang.Object

oracle.ucp.common.ConnectionFactoryAdapterBase

oracle.ucp.jdbc.JDBCConnectionFactoryAdapter

oracle.ucp.jdbc.XADataSourceConnectionFactoryAdapter

All Implemented Interfaces:

ConnectionFactoryAdapter

Direct Known Subclasses:

OracleXADataSourceConnectionFactoryAdapter

public class XADataSourceConnectionFactoryAdapter
extends JDBCConnectionFactoryAdapter

The connection factory adapter for javax.sql.XADataSources. 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:

ConnectionFactoryAdapter

Field Summary

Fields

Modifier and Type	Field and Description
protected XADataSource	m_xaDataSource

Fields inherited from class oracle.ucp.jdbc.JDBCConnectionFactoryAdapter

m_url

Constructor Summary

Constructors

Constructor and Description
XADataSourceConnectionFactoryAdapter(XADataSource xaDataSource) Constructor.

Method Summary

Modifier and Type	Method and Description
void	closeConnection(Object connection) Closes the XA connection.
Object	createConnection(ConnectionRetrievalInfo connectionRequestInfo) Creates a javax.sql.XAConnection.
XADataSource	getXaDataSource() Gets the XA data source.

Methods inherited from class oracle.ucp.jdbc.JDBCConnectionFactoryAdapter

createPooledConnection, getUrl, initializeUrlFromConnectionFactory, setUrl

Methods inherited from class oracle.ucp.common.ConnectionFactoryAdapterBase

getUniversalConnectionPool, setUniversalConnectionPool

Methods inherited from class java.lang.Object

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

Field Detail

m_xaDataSource

protected XADataSource m_xaDataSource

Constructor Detail

XADataSourceConnectionFactoryAdapter

public XADataSourceConnectionFactoryAdapter(XADataSource xaDataSource)
                                     throws UniversalConnectionPoolException

Constructor.

Parameters:

xaDataSource - The XA data source.

Throws:

UniversalConnectionPoolException - if an error occurs during construction.

Method Detail

getXaDataSource

public XADataSource getXaDataSource()

Gets the XA data source.

Returns:

The XA data source. Never null.

createConnection

public Object createConnection(ConnectionRetrievalInfo connectionRequestInfo)
                        throws UniversalConnectionPoolException

Creates a javax.sql.XAConnection.

Specified by:

createConnection in interface ConnectionFactoryAdapter

Specified by:

createConnection in class oracle.ucp.common.ConnectionFactoryAdapterBase

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.

closeConnection

public void closeConnection(Object connection)
                     throws UniversalConnectionPoolException

Closes the XA connection.

Specified by:

closeConnection in interface ConnectionFactoryAdapter

Specified by:

closeConnection in class oracle.ucp.common.ConnectionFactoryAdapterBase

Parameters:

connection - The XA connection to close.

Throws:

UniversalConnectionPoolException - if an error occurs closing the XA connection.