Package oracle.jdbc.xa.client

Class OracleXADataSource

java.lang.Object

oracle.jdbc.pool.OracleDataSource

oracle.jdbc.pool.OracleConnectionPoolDataSource

oracle.jdbc.xa.OracleXADataSource

oracle.jdbc.xa.client.OracleXADataSource

All Implemented Interfaces:

Serializable, Wrapper, Referenceable, CommonDataSource, ConnectionPoolDataSource, DataSource, XADataSource, OracleCommonDataSource, OracleConnectionPoolDataSource, OracleDataSource, OracleXADataSource

public class OracleXADataSource
extends OracleXADataSource

A factory for XAConnection objects. An object that implements the XADataSource interface is typically registered with a JNDI service provider.

For optimization purposes, we implemented 2 versions of OracleXADataSource: one for client, and one for server when used in Java Stored Procedures and in EJB. The server-version is only available in 8.1.6 and post-8.1.6 backends. This one is the implementation of OracleXADataSource for client-side usage and works for both pre- and post-8.1.6 RMs.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field	Description
static boolean	TRACE

Fields inherited from class oracle.jdbc.pool.OracleDataSource

cacheManager, connCacheName, connCacheProperties, connCachingEnabled, connectionProperties, databaseName, dataSourceName, DEFAULT_SERVICE_NAME, description, driver, driverType, ENABLE_AC_SUPPORT_PROPERTY, explicitCachingEnabled, explicitCachingEnabledSet, fastConnFailover, implicitCachingEnabled, implicitCachingEnabledSet, isOracleDataSource, loginTimeout, logWriter, maxStatements, maxStatementsSet, networkProtocol, odsCache, onsConfigStr, password, portNumber, serverName, serviceName, tnsEntry, url, user

Fields inherited from class oracle.jdbc.xa.OracleXADataSource

useNativeXA

Constructor Summary

Constructors

Constructor	Description
OracleXADataSource()	Create an OracleXADataSource instance.

Method Summary

Modifier and Type	Method	Description
OracleXAConnectionBuilderImpl	createXAConnectionBuilder()	Creates a new Oracle XA ConnectionBuilder instance
protected void	debug(Logger logger, Level level, Executable method, String msg)
XAConnection	getXAConnection()	Attempt to establish a database connection.
XAConnection	getXAConnection(String userName, String passwd)	Attempt to establish a database connection.
XAConnection	getXAConnection(OracleXAConnectionBuilderImpl builder)

Methods inherited from interface javax.sql.CommonDataSource

getParentLogger

Methods inherited from interface javax.sql.ConnectionPoolDataSource

getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

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.OracleCommonDataSource

createShardingKeyBuilder, getConnectionProperties, getDatabaseName, getDataSourceName, getDescription, getExplicitCachingEnabled, getImplicitCachingEnabled, getMaxStatements, getNetworkProtocol, getPortNumber, getRoleName, getServerName, getURL, getUser, setConnectionProperties, setDatabaseName, setDataSourceName, setDescription, setExplicitCachingEnabled, setImplicitCachingEnabled, setMaxStatements, setNetworkProtocol, setPassword, setPortNumber, setRoleName, setServerName, setSSLContext, setUser

Methods inherited from class oracle.jdbc.pool.OracleConnectionPoolDataSource

createPooledConnectionBuilder, getPhysicalConnection, getPhysicalConnection, getPhysicalConnection, getPooledConnection, getPooledConnection

Methods inherited from class oracle.jdbc.pool.OracleDataSource

addRefProperties, close, createConnectionBuilder, getConnection, getConnection, getConnection, getConnection, getConnection, getConnectionCacheName, getConnectionCacheProperties, getConnectionCachingEnabled, getConnectionProperties, getConnectionProperty, getDatabaseName, getDataSourceName, getDescription, getDriverType, getExplicitCachingEnabled, getFastConnectionFailoverEnabled, getImplicitCachingEnabled, getLoginTimeout, getLogWriter, getMaxStatements, getNetworkProtocol, getONSConfiguration, getParentLogger, getPassword, getPhysicalConnection, getPortNumber, getReference, getRoleName, getServerName, getServiceName, getTNSEntryName, getURL, getUser, isWrapperFor, setConnectionCacheName, setConnectionCacheProperties, setConnectionCachingEnabled, setConnectionProperties, setConnectionProperty, setDatabaseName, setDataSourceName, setDescription, setDriverType, setExplicitCachingEnabled, setFastConnectionFailoverEnabled, setImplicitCachingEnabled, setLoginTimeout, setLogWriter, setMaxStatements, setNetworkProtocol, setONSConfiguration, setPassword, setPortNumber, setRoleName, setServerName, setServiceName, setSSLContext, setTNSEntryName, setUser, trace, unwrap

Methods inherited from class oracle.jdbc.xa.OracleXADataSource

copy, getConnectionDuringExceptionHandling, setURL

Methods inherited from interface javax.sql.XADataSource

getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Field Detail

TRACE

public static final boolean TRACE

See Also:

Constant Field Values

Constructor Detail

OracleXADataSource

public OracleXADataSource()
                   throws SQLException

Create an OracleXADataSource instance.

Throws:

SQLException - if error occurs while creating an object

Method Detail

getXAConnection

public XAConnection getXAConnection()
                             throws SQLException

Attempt to establish a database connection.

Specified by:

getXAConnection in interface XADataSource

Specified by:

getXAConnection in class OracleXADataSource

Returns:

an Connection to the database

Throws:

SQLException - if a database-access error occurs.

getXAConnection

public XAConnection getXAConnection(String userName,
                                    String passwd)
                             throws SQLException

Attempt to establish a database connection.

Specified by:

getXAConnection in interface XADataSource

Specified by:

getXAConnection in class OracleXADataSource

Parameters:

userName - the database user on whose behalf the Connection is made

passwd - the user's password

Returns:

an XAConnection encapsulating a connection to the database

Throws:

SQLException - if a database-access error occurs.

getXAConnection

public XAConnection getXAConnection(OracleXAConnectionBuilderImpl builder)
                             throws SQLException

Throws:

SQLException

createXAConnectionBuilder

public OracleXAConnectionBuilderImpl createXAConnectionBuilder()

Creates a new Oracle XA ConnectionBuilder instance

Specified by:

createXAConnectionBuilder in interface OracleXADataSource

Specified by:

createXAConnectionBuilder in interface XADataSource

Overrides:

createXAConnectionBuilder in class OracleXADataSource

Returns:

The XA ConnectionBuilder instance that was created

debug

protected void debug(Logger logger,
                     Level level,
                     Executable method,
                     String msg)

Overrides:

debug in class OracleDataSource