Package oracle.jdbc.xa

Class OracleXAConnection

java.lang.Object

oracle.jdbc.pool.OraclePooledConnection

oracle.jdbc.xa.OracleXAConnection

All Implemented Interfaces:

Serializable, PooledConnection, XAConnection, OraclePooledConnection, OracleXAConnection, oracle.jdbc.diagnostics.Diagnosable, oracle.jdbc.diagnostics.PropertyChangeListener, oracle.jdbc.internal.Monitor

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

Nested Class Summary

Nested classes/interfaces inherited from interface oracle.jdbc.internal.Monitor

oracle.jdbc.internal.Monitor.CloseableLock, oracle.jdbc.internal.Monitor.WaitableMonitor

Field Summary

Fields

Modifier and Type	Field	Description
protected XAResource	xaResource

Fields inherited from class oracle.jdbc.pool.OraclePooledConnection

autoCommit, close_callback_string, closeOption, connect_auto_commit_string, connection_properties_string, event_listener_string, explicit_caching_enabled, ExplicitStatementCachingEnabled, implicit_caching_enabled, ImplicitStatementCachingEnabled, isClearMetaData, logicalHandle, LoginTimeout, 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, url_string

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	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, getCallWithKey, getConnectionDuringExceptionHandling, getDiagnosable, getExplicitCachingEnabled, getImplicitCachingEnabled, getLastAccessedTime, getLogicalHandle, getMonitorLock, 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.diagnostics.Diagnosable

begin, beginCurrentSql, debug, debug, debug, debug, debug, debug, debug, debug, debug, debug, debugp, end, endCurrentSql, format, isDebugEnabled, isDiagnoseFirstFailureEnabled, isLoggable, isSensitiveEnabled, onClose, propertyChange, resumeLogging, secure, suspendLogging, trace, tracep

Methods inherited from interface oracle.jdbc.internal.Monitor

acquireCloseableLock, acquireLock, assertLockHeldByCurrentThread, isReentrantLock, releaseLock

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 Details

xaResource

protected XAResource xaResource

Constructor Details

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 Details

getXAResource

public abstract XAResource getXAResource()
                                  throws SQLException

Return an XA resource to the caller.

Specified by:

getXAResource in interface OraclePooledConnection

Specified by:

getXAResource in interface XAConnection

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.