Package oracle.ucp.jdbc

Class XAConnectionConnectionPool

java.lang.Object

oracle.ucp.common.UniversalConnectionPoolBase

oracle.ucp.common.UniversalConnectionPoolImpl

oracle.ucp.jdbc.JDBCConnectionPool

oracle.ucp.jdbc.PooledConnectionConnectionPool

oracle.ucp.jdbc.XAConnectionConnectionPool

All Implemented Interfaces:

EventListener, ConnectionEventListener, oracle.ucp.common.Failoverable, UniversalConnectionPool

public class XAConnectionConnectionPool
extends PooledConnectionConnectionPool

A JDBC connection pool that pools javax.sql.XAConnection objects. This pool is a javax.sql.ConnectionEventListener and it gets registered as such on each javax.sql.XAConnection that gets created by this connection pool. If the client closes the javax.sql.XAConnection object manually (that is, they do not call closeConnection, this pool will be notified andwill remove the javax.sql.XAConnection from this connection pool. If a connectionError event is fired, then this pool will be notified and will also remove the javax.sql.XAConnection from this connection pool.

Field Summary

Fields inherited from class oracle.ucp.jdbc.JDBCConnectionPool

m_connectionInitializationCallback

Fields inherited from class oracle.ucp.common.UniversalConnectionPoolBase

borrowedAccumulator, borrowedConnectionsCount, borrowedSamples, core, DEFAULT_ABANDONED_CONNECTION_TIMEOUT, DEFAULT_CONNECTION_HARVEST_MAX_COUNT, DEFAULT_CONNECTION_HARVEST_TRIGGER_COUNT, DEFAULT_CONNECTION_VALIDATION_TIMEOUT, DEFAULT_CONNECTION_WAIT_TIMEOUT, DEFAULT_INACTIVE_CONNECTION_TIMEOUT, DEFAULT_INITIAL_POOL_SIZE, DEFAULT_MAX_CONNECTIONS_PER_SERVICE, DEFAULT_MAX_CONNECTIONS_PER_SHARD, DEFAULT_MAX_POOL_SIZE, DEFAULT_MIN_POOL_SIZE, DEFAULT_POOLNAME_PREFIX, DEFAULT_QUERY_TIMEOUT, DEFAULT_SECONDS_TO_TRUST_IDLE_CONNECTION, DEFAULT_TIME_TO_LIVE_CONNECTION_TIMEOUT, DEFAULT_TIMEOUT_CHECK_INTERVAL, DEFAULT_VALIDATE_BORROWED_CONNECTION, FRAMES, HISTOGRAM_STEP, HISTOGRAM_TIME_SPAN, labeledConnectionsCount, logWriter, m_connectionAffinityCallback, m_connectionLabelingCallback, m_lifeCycleState, THREAD_POOL_SIZE, totalConnectionsCount

Fields inherited from class oracle.ucp.common.UniversalConnectionPoolImpl

m_ucpInternal

Constructor Summary

Constructors

Constructor	Description
XAConnectionConnectionPool(JDBCConnectionFactoryAdapter connectionFactoryAdapter)	Constructor.

Method Summary

Modifier and Type	Method	Description
boolean	closeXAConnection(XAConnection xaConnection)	Closes the javax.sql.XAConnection.
XAConnection	getXAConnection(JDBCConnectionRetrievalInfo connectionRetrievalInfo)	Gets a javax.sql.XAConnection from the connection pool.
boolean	returnXAConnection(XAConnection xaConnection)	Returns a javax.sql.XAConnection back into the connection pool.
protected void	validateConstructor(JDBCConnectionFactoryAdapter connectionFactoryAdapter)	Makes sure the constructor is valid.

Methods inherited from class oracle.ucp.jdbc.JDBCConnectionPool

borrowConnection, getConnectionInitializationCallback, getConnectionObjectForLabelingConfigure, getMaxStatements, getProxyFactory, getSQLForValidateConnection, registerConnectionInitializationCallback, setConnectionFactory, setMaxStatements, setProxyFactory, setSQLForValidateConnection, unregisterConnectionInitializationCallback

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from class oracle.ucp.jdbc.PooledConnectionConnectionPool

closePooledConnection, connectionClosed, connectionErrorOccurred, getPooledConnection, returnPooledConnection

Methods inherited from class oracle.ucp.common.UniversalConnectionPoolBase

getAbandonedConnectionsCount, getAbandonedConnectionTimeout, getAbandonedConnectionTimer, getAvailableConnectionsCount, getAverageBorrowedConnectionsCount, getBorrowedConnectionsCount, getConnectionAffinityCallback, getConnectionFactoryAdapter, getConnectionHarvestMaxCount, getConnectionHarvestTriggerCount, getConnectionLabelingCallback, getConnectionLabelingHighCost, getConnectionRepurposeThreshold, getConnectionRetrievalInfo, getConnectionValidationTimeout, getConnectionWaitTimeout, getCumulativeConnectionBorrowedCount, getCumulativeConnectionReturnedCount, getCumulativeConnectionsCreated, getCumulativeConnectionUseTime, getCumulativeFailedConnectionWaitCount, getCumulativeFailedConnectionWaitTime, getCumulativeReturnedConnectionCount, getCumulativeSuccessfulConnectionWaitCount, getCumulativeSuccessfulConnectionWaitTime, getDatabaseTopologyInfo, getFailoverEventHandlerTask, getFailoverInfo, getHighCostConnectionReuseThreshold, getInactiveConnectionTimeout, getInactiveConnectionTimer, getInitialPoolSize, getLabeledConnectionsCount, getLifeCycleState, getLoginTimeout, getLogWriter, getMaxConnectionReuseCount, getMaxConnectionReuseTime, getMaxConnectionsPerService, getMaxConnectionsPerShard, getMaxPoolSize, getMinPoolSize, getName, getNeverUsedConnectionsCounter, getONSConfiguration, getPeakConnectionsCount, getPeakConnectionWaitTime, getPendingRequestsCount, getQueryTimeout, getSecondsToTrustIdleConnection, getServiceName, getShardedDatabaseInfo, getShardingMode, getShardRoutingCacheInfo, getTimeoutCheckInterval, getTimeToLiveConnectionTimeout, getTimeToLiveConnectionTimer, getTotalConnectionsCount, getValidateConnectionOnBorrow, handleFailoverEvent, ilogFine, ilogFinest, ilogThrowing, incrementConnectionsClosedCount, incrementConnectionsCreatedCount, insertToAvailableHistogram, insertToBorrowedHistogram, insertToCreatedHistogram, isFailoverEnabled, isFailoverExplicitlySet, isLifecycleFailed, isLifecycleRunning, isLifecycleStarting, isLifecycleStopped, isLifecycleStopping, isOraclePool, isRuntimeLoadBalancingEnabled, isShareable, reconfigure, registerConnectionAffinityCallback, registerConnectionLabelingCallback, removeConnectionAffinityCallback, removeConnectionLabelingCallback, resetAllPoolStatistics, resetNonCumulativePoolStatistics, setAbandonedConnectionTimeout, setConnectionHarvestMaxCount, setConnectionHarvestTriggerCount, setConnectionLabelingHighCost, setConnectionRepurposeThreshold, setConnectionRetrievalInfo, setConnectionValidationTimeout, setConnectionWaitTimeout, setFailoverEnabled, setFailoverInfo, setHighCostConnectionReuseThreshold, setInactiveConnectionTimeout, setInitialPoolSize, setLoginTimeout, setLogWriter, setMaxConnectionReuseCount, setMaxConnectionReuseTime, setMaxConnectionsPerService, setMaxConnectionsPerShard, setMaxPoolSize, setMinPoolSize, setName, setONSConfiguration, setOraclePool, setQueryTimeout, setRuntimeLoadBalancingEnabled, setSecondsToTrustIdleConnection, setShardingMode, setShareable, setTimeoutCheckInterval, setTimeToLiveConnectionTimeout, setValidateConnectionOnBorrow, start, stop, validatePoolSizes

Methods inherited from class oracle.ucp.common.UniversalConnectionPoolImpl

closeConnection, closePhysicalConnection, closePooledConnection, closeUsedPhysicalConnection, computeBorrowGiveUpTimestamp, createOnePooledConnection, createOnePooledConnection, discardUsedConnection, getAvailableConnection, getStatistics, getUsedConnection, incrementCumulativeConnectionsCreated, isAffinityStrict, isStillOkayToBorrow, needToConfigureConnection, purge, recycle, refresh, returnConnection, returnUsedPhysicalConnection, setConnectionHarvestable, setNoWaitBorrow

Constructor Detail

XAConnectionConnectionPool

public XAConnectionConnectionPool(JDBCConnectionFactoryAdapter connectionFactoryAdapter)
                           throws UniversalConnectionPoolException

Constructor.

Parameters:

connectionFactoryAdapter - The connection factory adapter.

Throws:

UniversalConnectionPoolException - If an error occurs constructing this.

Method Detail

getXAConnection

public XAConnection getXAConnection(JDBCConnectionRetrievalInfo connectionRetrievalInfo)
                             throws UniversalConnectionPoolException

Gets a javax.sql.XAConnection from the connection pool.

Parameters:

connectionRetrievalInfo - Info to use to get the javax.sql.XAConnection.

Returns:

A javax.sql.XAConnection.

Throws:

UniversalConnectionPoolException - if an error occurs getting a javax.sql.XAConnection.

NoAvailableConnectionsException - if all of the connections are in use.

returnXAConnection

public boolean returnXAConnection(XAConnection xaConnection)
                           throws UniversalConnectionPoolException

Returns a javax.sql.XAConnection back into the connection pool.

Parameters:

xaConnection - The javax.sql.XAConnection to return back into the pool.

Returns:

true if the javax.sql.XAConnection is in use and was returned to the pool; false otherwise.

Throws:

UniversalConnectionPoolException - if an error occurs returning the javax.sql.XAConnection.

closeXAConnection

public boolean closeXAConnection(XAConnection xaConnection)
                          throws UniversalConnectionPoolException

Closes the javax.sql.XAConnection. Do not put it back into the pool.

Parameters:

xaConnection - The javax.sql.XAConnection to close.

Returns:

true if the javax.sql.XAConnection is in use and was closed; false otherwise.

Throws:

UniversalConnectionPoolException - if an error occurs closing the javax.sql.XAConnection.

validateConstructor

protected void validateConstructor(JDBCConnectionFactoryAdapter connectionFactoryAdapter)
                            throws UniversalConnectionPoolException

Makes sure the constructor is valid.

Overrides:

validateConstructor in class PooledConnectionConnectionPool

Parameters:

connectionFactoryAdapter - the connection factory adapter.

Throws:

UniversalConnectionPoolException - If an error occurs.