oracle.ucp.jdbc
Interface PoolXADataSource

All Superinterfaces:

javax.sql.CommonDataSource, javax.sql.DataSource, PoolDataSource, java.sql.Wrapper, javax.sql.XADataSource

All Known Implementing Classes:

PoolXADataSourceImpl

public interface PoolXADataSource
extends PoolDataSource, javax.sql.XADataSource

A Universal Connection Pool-enabled XA data source. See PoolDataSource for standard data source and connection pool properties that are supported.

See Also:

PoolDataSource, UniversalConnectionPool

Field Summary

Fields inherited from interface oracle.ucp.jdbc.PoolDataSource

UCP_ABANDONED_CONNECTION_TIMEOUT, UCP_CONNECTION_FACTORY_CLASS_NAME, UCP_CONNECTION_FACTORY_PROPERTIES, UCP_CONNECTION_HARVEST_MAX_COUNT, UCP_CONNECTION_HARVEST_TRIGGER_COUNT, UCP_CONNECTION_POOL_NAME, UCP_CONNECTION_PROPERTIES, UCP_CONNECTION_WAIT_TIMEOUT, UCP_DATA_SOURCE_NAME, UCP_DATABASE_NAME, UCP_DESCRIPTION, UCP_FAST_CONNECTION_FAILOVER_ENABLED, UCP_INACTIVE_CONNECTION_TIMEOUT, UCP_INITIAL_POOL_SIZE, UCP_MAX_CONNECTION_REUSE_COUNT, UCP_MAX_CONNECTION_REUSE_TIME, UCP_MAX_IDLE_TIME, UCP_MAX_POOL_SIZE, UCP_MAX_STATEMENTS, UCP_MIN_POOL_SIZE, UCP_NETWORK_PROTOCOL, UCP_NTH_RETURNED_CONNECTION_TO_VALIDATE, UCP_ONS_CONFIGURATION, UCP_PASSWORD, UCP_PORT_NUMBER, UCP_PROPERTY_CYCLE, UCP_ROLE_NAME, UCP_SERVER_NAME, UCP_SQL_FOR_VALIDATE_CONNECTION, UCP_TIME_TO_LIVE_CONNECTION_TIMEOUT, UCP_TIMEOUT_CHECK_INTERVAL, UCP_URL, UCP_USER, UCP_VALIDATE_CONNECTION_ON_BORROW

Method Summary

javax.sql.XAConnection	getXAConnection() Obtains an XA connection from the embedded Universal Connection Pool instance.
javax.sql.XAConnection	getXAConnection(java.util.Properties labels) Obtains an XA connection from the embedded Universal Connection Pool instance, using the given connection labels.
javax.sql.XAConnection	getXAConnection(java.lang.String user, java.lang.String password) Obtains an XA connection from the embedded Universal Connection Pool instance, using the given user name and password.
javax.sql.XAConnection	getXAConnection(java.lang.String username, java.lang.String password, java.util.Properties labels) Obtains an XA connection from the embedded Universal Connection Pool instance, using the given user name, password, and connection labels.

Methods inherited from interface oracle.ucp.jdbc.PoolDataSource

getAbandonedConnectionTimeout, getAvailableConnectionsCount, getBorrowedConnectionsCount, getConnection, getConnection, getConnectionFactoryClassName, getConnectionFactoryProperties, getConnectionFactoryProperty, getConnectionHarvestMaxCount, getConnectionHarvestTriggerCount, getConnectionPoolName, getConnectionProperties, getConnectionProperty, getConnectionWaitTimeout, getDatabaseName, getDataSourceName, getDescription, getFastConnectionFailoverEnabled, getInactiveConnectionTimeout, getInitialPoolSize, getMaxConnectionReuseCount, getMaxConnectionReuseTime, getMaxIdleTime, getMaxPoolSize, getMaxStatements, getMinPoolSize, getNetworkProtocol, getONSConfiguration, getPassword, getPortNumber, getPropertyCycle, getRoleName, getServerName, getSQLForValidateConnection, getStatistics, getTimeoutCheckInterval, getTimeToLiveConnectionTimeout, getURL, getUser, getValidateConnectionOnBorrow, registerConnectionAffinityCallback, registerConnectionLabelingCallback, removeConnectionAffinityCallback, removeConnectionLabelingCallback, setAbandonedConnectionTimeout, setConnectionFactoryClassName, setConnectionFactoryProperties, setConnectionFactoryProperty, setConnectionHarvestMaxCount, setConnectionHarvestTriggerCount, setConnectionPoolName, setConnectionProperties, setConnectionProperty, setConnectionWaitTimeout, setDatabaseName, setDataSourceName, setDescription, setFastConnectionFailoverEnabled, setInactiveConnectionTimeout, setInitialPoolSize, setMaxConnectionReuseCount, setMaxConnectionReuseTime, setMaxIdleTime, setMaxPoolSize, setMaxStatements, setMinPoolSize, setNetworkProtocol, setONSConfiguration, setPassword, setPortNumber, setPropertyCycle, setRoleName, setServerName, setSQLForValidateConnection, setTimeoutCheckInterval, setTimeToLiveConnectionTimeout, setURL, setUser, setValidateConnectionOnBorrow

Methods inherited from interface javax.sql.DataSource

getConnection, getConnection

Methods inherited from interface javax.sql.CommonDataSource

getLoginTimeout, getLogWriter, setLoginTimeout, setLogWriter

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Method Detail

getXAConnection

javax.sql.XAConnection getXAConnection()
                                       throws java.sql.SQLException

Obtains an XA connection from the embedded Universal Connection Pool instance. Each XAConnection object represents a physical database connection that can be used in a distributed transaction.

Specified by:

getXAConnection in interface javax.sql.XADataSource

Returns:

An XAConnection object that can be used in a distributed transaction.

Throws:

java.sql.SQLException - if a database access error occurs.

getXAConnection

javax.sql.XAConnection getXAConnection(java.lang.String user,
                                       java.lang.String password)
                                       throws java.sql.SQLException

Obtains an XA connection from the embedded Universal Connection Pool instance, using the given user name and password. Each XAConnection object represents a physical database connection that can be used in a distributed transaction.

Specified by:

getXAConnection in interface javax.sql.XADataSource

Parameters:

user - The database user on whose behalf the connection is being made.

password - The user's password.

Returns:

An XAConnection object that can be used in a distributed transaction.

Throws:

java.sql.SQLException - if a database access error occurs.

getXAConnection

javax.sql.XAConnection getXAConnection(java.util.Properties labels)
                                       throws java.sql.SQLException

Obtains an XA connection from the embedded Universal Connection Pool instance, using the given connection labels. Each XAConnection object represents a physical database connection that can be used in a distributed transaction.

Parameters:

labels - The requested connection labels.

Returns:

An XAConnection object, which represents a physical connection to a data source, that can be used in a distributed transaction.

Throws:

java.sql.SQLException - if a database access error occurs.

getXAConnection

javax.sql.XAConnection getXAConnection(java.lang.String username,
                                       java.lang.String password,
                                       java.util.Properties labels)
                                       throws java.sql.SQLException

Obtains an XA connection from the embedded Universal Connection Pool instance, using the given user name, password, and connection labels. Each XAConnection object represents a physical database connection that can be used in a distributed transaction.

Parameters:

username - The database user on whose behalf the connection is being made.

password - The user's password.

labels - The requested connection labels.

Returns:

An XAConnection object that can be used in a distributed transaction.

Throws:

java.sql.SQLException - if a database access error occurs.