oracle.jdbc.xa

Class OracleXADataSource

java.lang.Object

oracle.jdbc.pool.OracleDataSource

oracle.jdbc.pool.OracleConnectionPoolDataSource

oracle.jdbc.xa.OracleXADataSource

All Implemented Interfaces:

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

Direct Known Subclasses:

OracleXADataSource

public abstract class OracleXADataSource
extends OracleConnectionPoolDataSource
implements OracleXADataSource

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

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	useNativeXA

Fields inherited from class oracle.jdbc.pool.OracleDataSource

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

Constructor Summary

Constructors

Constructor and Description
OracleXADataSource() Create an OracleXADataSource instance.

Method Summary

Modifier and Type	Method and Description
protected void	copy(OracleDataSource ds)
OracleXAConnectionBuilder	createXAConnectionBuilder() Creates a new Oracle XA ConnectionBuilder instance
protected oracle.jdbc.internal.OracleConnection	getConnectionDuringExceptionHandling()
abstract XAConnection	getXAConnection() Attempt to establish a database connection.
abstract XAConnection	getXAConnection(String user, String passwd) Attempt to establish a database connection.
void	setURL(String url) Set the URL from which connections have to be obtained.

Methods inherited from class oracle.jdbc.pool.OracleConnectionPoolDataSource

createPooledConnectionBuilder, getPhysicalConnection, getPhysicalConnection, getPhysicalConnection, getPooledConnection, getPooledConnection, getPooledConnection

Methods inherited from class oracle.jdbc.pool.OracleDataSource

addRefProperties, close, createConnectionBuilder, debug, getConnection, getConnection, getConnection, getConnection, getConnection, getConnectionCacheName, getConnectionCacheProperties, getConnectionCachingEnabled, getConnectionProperties, 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, setDatabaseName, setDataSourceName, setDescription, setDriverType, setExplicitCachingEnabled, setFastConnectionFailoverEnabled, setImplicitCachingEnabled, setLoginTimeout, setLogWriter, setMaxStatements, setNetworkProtocol, setONSConfiguration, setPassword, setPortNumber, setRoleName, setServerName, setServiceName, setTNSEntryName, setUser, trace, unwrap

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, setUser

Methods inherited from interface javax.sql.CommonDataSource

getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter

Field Detail

useNativeXA

protected boolean useNativeXA

Constructor Detail

OracleXADataSource

public OracleXADataSource()
                   throws SQLException

Create an OracleXADataSource instance.

Throws:

SQLException - if error occurs while creating an object

Method Detail

getXAConnection

public abstract XAConnection getXAConnection()
                                      throws SQLException

Attempt to establish a database connection.

Specified by:

getXAConnection in interface XADataSource

Returns:

a Connection to the database

Throws:

SQLException - if a database-access error occurs.

getXAConnection

public abstract XAConnection getXAConnection(String user,
                                             String passwd)
                                      throws SQLException

Attempt to establish a database connection.

Specified by:

getXAConnection in interface XADataSource

Parameters:

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

password - the user's password

Returns:

a Connection to the database

Throws:

SQLException - if a database-access error occurs.

setURL

public void setURL(String url)

Description copied from class: OracleDataSource

Set the URL from which connections have to be obtained. If URL is set all other properties like databasename, servername, portNumber, network protocol, tnsentry, and driver Type will be ignored.

Specified by:

setURL in interface OracleCommonDataSource

Overrides:

setURL in class OracleDataSource

Parameters:

url - URL to be set.

copy

protected void copy(OracleDataSource ds)
             throws SQLException

Overrides:

copy in class OracleDataSource

Throws:

SQLException

getConnectionDuringExceptionHandling

protected oracle.jdbc.internal.OracleConnection getConnectionDuringExceptionHandling()

Overrides:

getConnectionDuringExceptionHandling in class OracleDataSource

createXAConnectionBuilder

public OracleXAConnectionBuilder createXAConnectionBuilder()

Creates a new Oracle XA ConnectionBuilder instance

Specified by:

createXAConnectionBuilder in interface OracleXADataSource

Returns:

The XA ConnectionBuilder instance that was created