oracle.jdbc.xa

Class OracleXAConnection

java.lang.Object

oracle.jdbc.pool.OraclePooledConnection

oracle.jdbc.xa.OracleXAConnection

All Implemented Interfaces:

Serializable, PooledConnection, XAConnection, OraclePooledConnection, OracleXAConnection

Direct Known Subclasses:

OracleXAConnection

public abstract class OracleXAConnection
extends OraclePooledConnection
implements OracleXAConnection

An XAConnection object provides support for distributed transactions. An XAConnection may be enlisted in a distributed transaction by means of an XAResource object.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected XAResource	xaResource

Fields inherited from class oracle.jdbc.pool.OraclePooledConnection

autoCommit, cachedConnectionAttributes, close_callback_string, closeOption, connect_auto_commit_string, connection_properties_string, connectionMarkedDown, dataSourceDbUniqNameKey, dataSourceHostNameKey, dataSourceInstanceNameKey, event_listener_string, explicit_caching_enabled, ExplicitStatementCachingEnabled, implicit_caching_enabled, ImplicitStatementCachingEnabled, isClearMetaData, logicalHandle, LoginTimeout, needToAbort, NO_IMPLICIT_BEGIN_REQUEST_PROPERTY, object_type_map, oracleDriver, physicalConn, pool_auto_commit_string, private_data, replayConn, sql_exception_string, statement_cache_size, transaction_isolation, unMatchedCachedConnAttr, url_string

Constructor Summary

Constructors

Constructor and Description
OracleXAConnection() Create an OracleXAConnection object.
OracleXAConnection(Connection pc) Create an OracleXAConnection object.

Method Summary

Modifier and Type	Method and Description
Connection	getConnection() Create an object handle for this physical connection.
abstract XAResource	getXAResource() Return an XA resource to the caller.

Methods inherited from class oracle.jdbc.pool.OraclePooledConnection

addConnectionEventListener, addStatementEventListener, close, debug, getCallWithKey, getConnectionDuringExceptionHandling, getExplicitCachingEnabled, getImplicitCachingEnabled, getLastAccessedTime, getLogicalHandle, getPhysicalHandle, getStatementCacheSize, getStatementWithKey, getStmtCacheSize, isStatementCacheInitialized, purgeExplicitCache, purgeImplicitCache, registerImplicitCacheConnectionEventListener, removeConnectionEventListener, removeStatementEventListener, setConnection, setExplicitCachingEnabled, setImplicitCachingEnabled, setLastAccessedTime, setProperties, setShardingKey, setShardingKeyIfValid, setStatementCacheSize, setStmtCacheSize, setStmtCacheSize

Methods inherited from class java.lang.Object

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

Methods inherited from interface oracle.jdbc.datasource.OraclePooledConnection

getCallWithKey, getExplicitCachingEnabled, getImplicitCachingEnabled, getLastAccessedTime, getLogicalHandle, getStatementCacheSize, getStatementWithKey, purgeExplicitCache, purgeImplicitCache, registerCloseCallback, registerImplicitCacheConnectionEventListener, setExplicitCachingEnabled, setImplicitCachingEnabled, setLastAccessedTime, setShardingKey, setShardingKeyIfValid, setStatementCacheSize

Methods inherited from interface javax.sql.PooledConnection

addConnectionEventListener, addStatementEventListener, close, removeConnectionEventListener, removeStatementEventListener

Field Detail

xaResource

protected XAResource xaResource

Constructor Detail

OracleXAConnection

public OracleXAConnection()
                   throws XAException

Create an OracleXAConnection object.

Throws:

XAException

OracleXAConnection

public OracleXAConnection(Connection pc)
                   throws XAException

Create an OracleXAConnection object.

Parameters:

pc - A physical connection object.

Throws:

XAException

Method Detail

getXAResource

public abstract XAResource getXAResource()
                                  throws SQLException

Return an XA resource to the caller.

Specified by:

getXAResource in interface XAConnection

Specified by:

getXAResource in interface OraclePooledConnection

Overrides:

getXAResource in class OraclePooledConnection

Returns:

the XAResource

Throws:

SQLException - if a database-access error occurs

getConnection

public Connection getConnection()
                         throws 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.

Specified by:

getConnection in interface PooledConnection

Overrides:

getConnection in class OraclePooledConnection

Returns:

a Connection object

Throws:

SQLException - if a database-access error occurs.