Package oracle.ucp.jdbc.oracle

Class OracleConnectionConnectionPool

java.lang.Object

oracle.ucp.common.UniversalConnectionPoolBase

oracle.ucp.common.UniversalConnectionPoolImpl

oracle.ucp.jdbc.JDBCConnectionPool

oracle.ucp.jdbc.oracle.OracleJDBCConnectionPool

oracle.ucp.jdbc.oracle.OracleConnectionConnectionPool

All Implemented Interfaces:

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

Direct Known Subclasses:

OracleReplayableConnectionConnectionPool

public class OracleConnectionConnectionPool
extends OracleJDBCConnectionPool

Oracle-specific JDBC pool that handles JDBC Connections.

Field Summary

Fields

Modifier and Type	Field	Description
protected AtomicBoolean	isFirstBorrow
protected boolean	useVanillaObjects

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

Method Summary

Modifier and Type	Method	Description
UniversalPooledConnection	borrowConnection(ConnectionRetrievalInfo connectionRetrievalInfo)	Gets a connection from the connection pool.
boolean	closeConnection(Connection connection)	Closes the java.sql.Connection.
Connection	getConnection(JDBCConnectionRetrievalInfo connectionRetrievalInfo)	Gets a java.sql.Connection from the connection pool.
protected String	getDRCPPLSQLCallbackName(UniversalPooledConnection pc)	Returns the PL/SQL Fix-up callback name if configured, otherwise returns Null.
protected boolean	isDRCPEnabled(UniversalPooledConnection pc)	DRCP feature is currently available only for OracleConnectionConnectionPool so returing false by default.
protected boolean	isDRCPMultiTagEnabled(UniversalPooledConnection pc)	Returns true if DRCP Multitag is enabled false otherwise.
protected boolean	needToConfigureConnection(UniversalPooledConnection pc, Properties requestedLabels)	While using DRCP the connection selection is done by DRCP machinery and UCP does not have any control over the selection.
boolean	returnConnection(Connection connection)	Returns a java.sql.Connection back into the connection pool.
void	returnConnection(UniversalPooledConnection upc)	Returns a connection back into the connection pool.

Methods inherited from class oracle.ucp.jdbc.JDBCConnectionPool

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

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

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, purge, recycle, refresh, returnUsedPhysicalConnection, setConnectionHarvestable, setNoWaitBorrow

Field Detail

useVanillaObjects

protected boolean useVanillaObjects

isFirstBorrow

protected AtomicBoolean isFirstBorrow

Constructor Detail

OracleConnectionConnectionPool

public OracleConnectionConnectionPool(JDBCConnectionFactoryAdapter connectionFactoryAdapter)
                               throws UniversalConnectionPoolException

Constructor.

Parameters:

connectionFactoryAdapter - The connection factory adapter.

Throws:

UniversalConnectionPoolException - If an error occurs constructing this.

Method Detail

getConnection

public Connection getConnection(JDBCConnectionRetrievalInfo connectionRetrievalInfo)
                         throws UniversalConnectionPoolException

Gets a java.sql.Connection from the connection pool.

Parameters:

connectionRetrievalInfo - Info to use to get the java.sql.Connection.

Returns:

A java.sql.Connection.

Throws:

UniversalConnectionPoolException - if an error occurs getting a java.sql.Connection.

NoAvailableConnectionsException - if all of the connections are in use.

borrowConnection

public UniversalPooledConnection borrowConnection(ConnectionRetrievalInfo connectionRetrievalInfo)
                                           throws UniversalConnectionPoolException

Gets a connection from the connection pool.

Specified by:

borrowConnection in interface UniversalConnectionPool

Overrides:

borrowConnection in class OracleJDBCConnectionPool

Parameters:

connectionRetrievalInfo - Info to use to get the connection.

Returns:

A UniversalPooledConnection for the specified connection retrieval info.

Throws:

UniversalConnectionPoolException - if an error occurs getting a connection.

NoAvailableConnectionsException - if all of the connections are in use.

returnConnection

public boolean returnConnection(Connection connection)
                         throws UniversalConnectionPoolException

Returns a java.sql.Connection back into the connection pool.

Parameters:

connection - The java.sql.Connection to return back into the pool.

Returns:

true if the java.sql.Connection is in use and was returned to the pool. false otherwise.

Throws:

UniversalConnectionPoolException - if an error occurs returning the java.sql.Connection.

returnConnection

public void returnConnection(UniversalPooledConnection upc)
                      throws UniversalConnectionPoolException

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

Returns a connection back into the connection pool. The pool can decide to close the underlying physical connection when necessary.

Specified by:

returnConnection in interface UniversalConnectionPool

Overrides:

returnConnection in class oracle.ucp.common.UniversalConnectionPoolImpl

Parameters:

upc - The connection to return back into the pool.

Throws:

UniversalConnectionPoolException

closeConnection

public boolean closeConnection(Connection connection)
                        throws UniversalConnectionPoolException

Closes the java.sql.Connection. Do not put it back into the pool.

Parameters:

connection - The java.sql.Connection to close.

Returns:

true if the java.sql.Connection is in use and was closed. false otherwise.

Throws:

UniversalConnectionPoolException - if an error occurs closing the java.sql.Connection.

needToConfigureConnection

protected boolean needToConfigureConnection(UniversalPooledConnection pc,
                                            Properties requestedLabels)
                                     throws UniversalConnectionPoolException

While using DRCP the connection selection is done by DRCP machinery and UCP does not have any control over the selection. UCP does not even know which labels are matched since tagging is a boolean operation in UCP. It is either a match or no match. So accomodate this behavior this method contains the decision making on the need to call configure. If PLSQL fix-up callback is configured then this method will return false.

Overrides:

needToConfigureConnection in class oracle.ucp.common.UniversalConnectionPoolImpl

Parameters:

UniversalPooledConnection -

requestedLabels - - Requested labels to configure on selected connection

Returns:

true - When there is a need to invoke configure method false - When there is no need to invoke configure method

Throws:

UniversalConnectionPoolException - - When there is a problem while deciding if the connection should be configured

isDRCPEnabled

protected boolean isDRCPEnabled(UniversalPooledConnection pc)
                         throws UniversalConnectionPoolException

Description copied from class: OracleJDBCConnectionPool

DRCP feature is currently available only for OracleConnectionConnectionPool so returing false by default.

Overrides:

isDRCPEnabled in class OracleJDBCConnectionPool

Returns:

false

Throws:

UniversalConnectionPoolException

isDRCPMultiTagEnabled

protected boolean isDRCPMultiTagEnabled(UniversalPooledConnection pc)
                                 throws UniversalConnectionPoolException

Returns true if DRCP Multitag is enabled false otherwise.

Overrides:

isDRCPMultiTagEnabled in class OracleJDBCConnectionPool

Parameters:

pc -

Returns:

DRCP Multitag enabled status

Throws:

UniversalConnectionPoolException

getDRCPPLSQLCallbackName

protected String getDRCPPLSQLCallbackName(UniversalPooledConnection pc)
                                   throws UniversalConnectionPoolException

Returns the PL/SQL Fix-up callback name if configured, otherwise returns Null.

Overrides:

getDRCPPLSQLCallbackName in class OracleJDBCConnectionPool

Returns:

Null

Throws:

UniversalConnectionPoolException