Package oracle.jdbc.xa.client
Class OracleXADataSource
- All Implemented Interfaces:
Serializable,Wrapper,Referenceable,CommonDataSource,ConnectionPoolDataSource,DataSource,XADataSource,OracleCommonDataSource,OracleConnectionPoolDataSource,OracleDataSource,OracleXADataSource,oracle.jdbc.diagnostics.Diagnosable,oracle.jdbc.diagnostics.PropertyChangeListener,oracle.jdbc.internal.Monitor,oracle.jdbc.replay.internal.OracleConnectionPoolDataSource,oracle.jdbc.replay.internal.OracleDataSource,oracle.jdbc.replay.internal.OracleXADataSource,OracleConnectionPoolDataSource,OracleDataSource,OracleXADataSource
- Direct Known Subclasses:
OracleXADataSourceImpl
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.
The following example illustrates the use of this data source to
create a JDBC XAConnection:
oracle.jdbc.xa.client.OracleXADataSource oxads =
new oracle.jdbc.xa.client.OracleXADataSource();
oxads.setURL("jdbc:oracle:thin:@//dbhost:dbport/dbservice");
oxads.setUser("User");
oxads.setPassword("Passwd");
oxads.setConnectionProperty("connProp1", "value1");
oxads.setConnectionProperty("connProp2", "value2");
javax.sql.XAConnection xaconn = oxads.getXAConnection();
- See Also:
-
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 inherited from class oracle.jdbc.xa.OracleXADataSource
useNativeXAFields inherited from class oracle.jdbc.datasource.impl.OracleDataSource
CHECKSUM_PROPERTY, clientChecksum11203x, clientChecksum12x, connectionProperties, databaseName, dataSourceName, DEFAULT_SERVICE_NAME, description, DMS_DEFAULT_DATASOURCE_NAME, DMS_ROOT_NAME, doneDumpOnMemoryPressure, driver, driverType, ENABLE_AC_SUPPORT_PROPERTY, ENABLE_SSS_CURSOR_SUPPORT_PROPERTY, explicitCachingEnabled, explicitCachingEnabledSet, FAILOVER_RESTORE_AUTO, FAILOVER_RESTORE_LEVEL1, FAILOVER_RESTORE_LEVEL2, FAILOVER_RESTORE_NONE, FAILOVER_RESTORE_PROPERTY, FAILOVER_TYPE_AUTO, FAILOVER_TYPE_ON_REMOTE, FAILOVER_TYPE_PROPERTY, FAILOVER_TYPE_TRANSACTION, IGNORE_AC_CONTEXT_PROPERTY, implicitCachingEnabled, implicitCachingEnabledSet, INITIATION_TIMEOUT_PROPERTY, isAutoACEnabled, isFirstConnection, isHybrid, isOracleDataSource, isReplayInDynamicMode, isSSSCursorEnabled, isStateRestorationAuto, isTransactionReplayEnabled, loginTimeout, logWriter, maxStatements, maxStatementsSet, networkProtocol, password, portNumber, RECONNECT_DELAY_PROPERTY, RECONNECT_RETRIES_PROPERTY, reconnectDelay, reconnectRetries, replayInitiationTimeout, REQUEST_SIZE_LIMIT_PROPERTY, serverName, serviceName, SESSION_STATE_CONSISTENCY_HYBRID, SESSION_STATE_CONSISTENCY_STATIC, SESSION_STATE_PROPERTY, stateRestorationType, tnsEntry, TRACE, trackerInitialized, unnamedInstanceCount, url, userFields inherited from interface oracle.jdbc.replay.OracleDataSource
CONNECTION_PROPERTIES, DATA_SOURCE_NAME, DATABASE_NAME, DESCRIPTION, EXPLICIT_CACHING_ENABLED, IMPLICIT_CACHING_ENABLED, MAX_STATEMENTS, NETWORK_PROTOCOL, PASSWORD, PORT_NUMBER, ROLE_NAME, SERVER_NAME, URL, USER -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionCreates a new Oracle XA ConnectionBuilder instanceAttempt to establish a database connection.getXAConnection(String userName, String passwd) Attempt to establish a database connection.Methods inherited from class oracle.jdbc.xa.OracleXADataSource
getConnectionDuringExceptionHandling, setURLMethods inherited from class oracle.jdbc.datasource.impl.OracleConnectionPoolDataSource
createPooledConnectionBuilder, getConnection, getConnection, getConnection, getPhysicalConnection, getPhysicalConnection, getPhysicalConnection, getPhysicalConnection, getPhysicalConnection, getPooledConnection, getPooledConnectionMethods inherited from class oracle.jdbc.datasource.impl.OracleDataSource
addRefProperties, cleanup, clearDoneDumpOnMemoryPressure, clearReplayStatistics, createConnectionBuilder, dms_data_source_type, enableACAndProxifyIfNecessary, finalize, getConnection, getConnection, getConnectionInitializationCallback, getConnectionNoProxy, getConnectionProperties, getConnectionProperty, getDatabaseName, getDataSourceName, getDescription, getDiagnosable, getDriverType, getExplicitCachingEnabled, getImplicitCachingEnabled, getLoginTimeout, getLogWriter, getMaxStatements, getMonitorLock, getNetworkProtocol, getParentLogger, getPassword, getPhysicalConnection, getPortNumber, getProxyFactory, getReference, getReplayStatistics, getReplayStatisticsString, getRequestSizeLimit, getRoleName, getServerName, getServiceName, getSSSCursorProperty, getSystemProperty, getTNSEntryName, getURL, getUser, isWrapperFor, makeURL, registerConnectionInitializationCallback, registerMBean, removeReplayStatistics, setConnectionProperties, setConnectionProperty, setDatabaseName, setDataSourceName, setDescription, setDriverType, setExplicitCachingEnabled, setHostnameResolver, setImplicitCachingEnabled, setLoginTimeout, setLogWriter, setMaxStatements, setNetworkProtocol, setPassword, setPortNumber, setRoleName, setServerName, setServiceName, setSingleShardTransactionSupport, setSSLContext, setTNSEntryName, setTokenSupplier, setupACSpecificProperties, setUser, unregisterConnectionInitializationCallback, unregisterMBean, unwrap, updateReplayStatisticsMethods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface javax.sql.CommonDataSource
getParentLoggerMethods inherited from interface javax.sql.ConnectionPoolDataSource
getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriterMethods inherited from interface javax.sql.DataSource
getConnection, getConnection, getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriterMethods 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, tracepMethods inherited from interface oracle.jdbc.internal.Monitor
acquireCloseableLock, acquireLock, assertLockHeldByCurrentThread, isReentrantLock, releaseLockMethods inherited from interface oracle.jdbc.datasource.OracleCommonDataSource
createShardingKeyBuilder, getConnectionProperties, getConnectionProperty, getDatabaseName, getDataSourceName, getDescription, getNetworkProtocol, getPortNumber, getServerName, getURL, getUser, setConnectionProperties, setConnectionProperty, setDatabaseName, setDataSourceName, setDescription, setHostnameResolver, setNetworkProtocol, setPassword, setPortNumber, setServerName, setSingleShardTransactionSupport, setSSLContext, setTokenSupplier, setUserMethods inherited from interface oracle.jdbc.datasource.OracleConnectionPoolDataSource
createPooledConnectionBuilderMethods inherited from interface oracle.jdbc.replay.OracleConnectionPoolDataSource
getPooledConnectionMethods inherited from interface oracle.jdbc.datasource.OracleDataSource
createConnectionBuilderMethods inherited from interface oracle.jdbc.replay.internal.OracleDataSource
clearDoneDumpOnMemoryPressure, getConnectionNoProxy, getProxyFactory, getReplayStatisticsString, getRequestSizeLimit, removeReplayStatistics, updateReplayStatisticsMethods inherited from interface oracle.jdbc.replay.OracleDataSource
clearReplayStatistics, getConnectionInitializationCallback, getExplicitCachingEnabled, getImplicitCachingEnabled, getMaxStatements, getReplayStatistics, getRoleName, registerConnectionInitializationCallback, setExplicitCachingEnabled, setImplicitCachingEnabled, setMaxStatements, setRoleName, unregisterConnectionInitializationCallbackMethods inherited from interface java.sql.Wrapper
isWrapperFor, unwrapMethods inherited from interface javax.sql.XADataSource
getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter
-
Constructor Details
-
OracleXADataSource
Create an OracleXADataSource instance.- Throws:
SQLException- if error occurs while creating an object
-
-
Method Details
-
getXAConnection
Attempt to establish a database connection.- Specified by:
getXAConnectionin interfaceOracleXADataSource- Specified by:
getXAConnectionin interfaceXADataSource- Specified by:
getXAConnectionin classOracleXADataSource- Returns:
- an Connection to the database
- Throws:
SQLException- if a database-access error occurs.
-
getXAConnection
Attempt to establish a database connection.- Specified by:
getXAConnectionin interfaceOracleXADataSource- Specified by:
getXAConnectionin interfaceXADataSource- Specified by:
getXAConnectionin classOracleXADataSource- Parameters:
userName- the database user on whose behalf the Connection is madepasswd- the user's password- Returns:
- an XAConnection encapsulating a connection to the database
- Throws:
SQLException- if a database-access error occurs.
-
getXAConnection
- Throws:
SQLException
-
createXAConnectionBuilder
Creates a new Oracle XA ConnectionBuilder instance- Specified by:
createXAConnectionBuilderin interfaceOracleXADataSource- Specified by:
createXAConnectionBuilderin interfaceXADataSource- Overrides:
createXAConnectionBuilderin classOracleXADataSource- Returns:
- The XA ConnectionBuilder instance that was created
-