Package oracle.ucp.jdbc.oracle

Class OracleXAConnectionConnectionPool

java.lang.Object

oracle.ucp.common.UniversalConnectionPoolBase

oracle.ucp.common.UniversalConnectionPoolImpl

oracle.ucp.jdbc.JDBCConnectionPool

oracle.ucp.jdbc.oracle.OracleJDBCConnectionPool

oracle.ucp.jdbc.oracle.OraclePooledConnectionConnectionPool

oracle.ucp.jdbc.oracle.OracleXAConnectionConnectionPool

All Implemented Interfaces:

EventListener, ConnectionEventListener, oracle.ucp.common.Failoverable, RACCallback, RACManagerImpl.RACCallbackExtended, UniversalConnectionPool

public class OracleXAConnectionConnectionPool
extends OraclePooledConnectionConnectionPool

Oracle-specific JDBC pool that handles JDBC XA connections.

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
OracleXAConnectionConnectionPool(JDBCConnectionFactoryAdapter connectionFactoryAdapter)	Constructor.

Method Summary

Modifier and Type	Method	Description
boolean	closeXAConnection(XAConnection xaConnection)	Closes the javax.sql.XAConnection.
protected Object	getConnectionObjectForLabelingConfigure(UniversalPooledConnection upc)	Public and protected methods used in other packages.
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

getConnectionInitializationCallback, 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.oracle.OracleJDBCConnectionPool

borrowConnection, closePhysicalConnection, createOnePooledConnection, getAvailableConnections, getAvailableConnectionToInstance, getConnectionRepurposeCount, getDRCPPLSQLCallbackName, getFailedAffinityBasedBorrowCount, getFailedAffinityBasedBorrowCount, getFailedRCLBBasedBorrowCount, getFailedRCLBBasedBorrowCount, getFCFProcessingInfo, getFCFProcessingInfo, getFCFProcessingInfoProcessedOnly, getFCFProcessingInfoProcessedOnly, getPoolName, getRoomToGrowPool, getShardConnectionStats, getStatistics, getSuccessfulAffinityBasedBorrowCount, getSuccessfulAffinityBasedBorrowCount, getSuccessfulRCLBBasedBorrowCount, getSuccessfulRCLBBasedBorrowCount, getUrl, initiateDownEventProcessing, initiateUpEventProcessing, isDRCPEnabled, isDRCPMultiTagEnabled, isRuntimeLoadBalancingEnabled, isValid, lbaEventOccurred, onAddingConnectionToPool, onRemovingConnectionFromPool, openNewConnection, registerConnectionAffinityCallback, removeConnectionAffinityCallback, start, superClosePhysicalConnection, tearDownConnectionsForInstance, useStrictWebSessionAffinity, useStrictXAAffinity

Methods inherited from class oracle.ucp.jdbc.oracle.OraclePooledConnectionConnectionPool

closePooledConnection, connectionClosed, connectionErrorOccurred, getPooledConnection, returnPooledConnection

Methods inherited from interface oracle.ucp.jdbc.oracle.RACCallback

getMaxPoolSize, getMinPoolSize, getTotalConnectionsCount, getValidateConnectionOnBorrow

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, isShareable, reconfigure, registerConnectionLabelingCallback, 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, stop, validatePoolSizes

Methods inherited from class oracle.ucp.common.UniversalConnectionPoolImpl

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

Constructor Detail

OracleXAConnectionConnectionPool

public OracleXAConnectionConnectionPool(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.

Parameters:

connectionFactoryAdapter - the connection factory adapter.

Throws:

UniversalConnectionPoolException - If an error occurs.

getConnectionObjectForLabelingConfigure

protected Object getConnectionObjectForLabelingConfigure(UniversalPooledConnection upc)

Description copied from class: oracle.ucp.common.UniversalConnectionPoolImpl

Public and protected methods used in other packages.

Overrides:

getConnectionObjectForLabelingConfigure in class JDBCConnectionPool