oracle.ucp.admin

Class UniversalConnectionPoolMBeanBase

java.lang.Object

oracle.ucp.admin.UniversalConnectionPoolMBeanBase

All Implemented Interfaces:

UniversalConnectionPoolMBean

Direct Known Subclasses:

JDBCUniversalConnectionPoolMBeanImpl

public class UniversalConnectionPoolMBeanBase
extends Object
implements UniversalConnectionPoolMBean

Field Summary

Fields

Modifier and Type	Field and Description
protected UniversalConnectionPool	connectionPool

Constructor Summary

Constructors

Constructor and Description
UniversalConnectionPoolMBeanBase(UniversalConnectionPool connectionPool) Constructor for UniversalConnectionPoolMBeanBase.

Method Summary

Modifier and Type	Method and Description
int	getAbandonedConnectionsCount() Gets the number of abandoned connections that have been reclaimed.
int	getAbandonedConnectionTimeout() Gets the abandonedConnectionTimeout for UniversalConnectionPool.
int	getAvailableConnectionsCount() Gets the availableConnectionsCount for UniversalConnectionPool.
int	getAverageBorrowedConnectionsCount() Gets the average number of connections that are borrowed and actively in use by clients.
long	getAverageConnectionWaitTime() Gets the average time (in milliseconds) a user thread has to wait before it could obtain a connection from the connection pool.
int	getBorrowedConnectionsCount() Gets the borrowedConnectionsCount for UniversalConnectionPool.
int	getConnectionHarvestMaxCount() Gets the connectionHarvestMaxCount for UniversalConnectionPool.
int	getConnectionHarvestTriggerCount() Gets the connectionHarvestTriggerCount for UniversalConnectionPool.
long	getConnectionRepurposeCount() Returns the number of connection repurposed in a shared pool for a mutitenant database, where connections can be reused across PDB's by switching their container and PDB service.
int	getConnectionsClosedCount() Gets the number of connections closed by this connection pool.
int	getConnectionsCreatedCount() Gets the number of connections created for this connection pool.
int	getConnectionWaitTimeout() Gets the connectionWaitTimeout for UniversalConnectionPool.
long	getCumulativeConnectionBorrowedCount() Gets the number of connections borrowed from the connection pool over the life of the pool.
long	getCumulativeConnectionReturnedCount() Gets the number of connections returned to the connection pool over the life of the pool.
long	getCumulativeConnectionUseTime() Gets the cumulative time (in milliseconds) of connections that were borrowed from the pool and remained in use.
long	getCumulativeConnectionWaitTime() Gets the cumulative time (in milliseconds) that connection requests have waited for connections over the life of the connection pool.
long	getCumulativeFailedConnectionWaitCount() Gets the number of connection requests that waited unsuccessfully to borrow a connection from the pool.
long	getCumulativeFailedConnectionWaitTime() Gets the cumulative time (in milliseconds) that connection requests waited but failed to borrow a connection from the pool.
long	getCumulativeSuccessfulConnectionWaitCount() Gets the number of connection requests that waited successfully and borrowed a connection from the pool.
long	getCumulativeSuccessfulConnectionWaitTime() Gets the cumulative time (in milliseconds) that connection requests waited successfully and borrowed a connection from the pool.
long	getFailedAffinityBasedBorrowCount() Gets the number of borrow requests that returned connections not matching the affinity contexts.
long	getFailedRCLBBasedBorrowCount() Gets the number of borrow requests failed using Runtime Connection Load-Balancing (RCLB) algorithms.
String	getFcfProcessingInfo() Gets the information of recent Fast Connection Failover (FCF) attempts, in the form of a String.
String	getFcfProcessingInfoProcessedOnly()
int	getInactiveConnectionTimeout() Gets the inactiveConnectionTimeout for UniversalConnectionPool.
int	getInitialPoolSize() Gets the initialPoolSize for UniversalConnectionPool.
int	getLabeledConnectionsCount() Gets the number of labeled connections in the connection pool.
String	getLifeCycleState() Gets the UniversalConnectionPoolLifeCycleState of UniversalConnectionPool.
int	getMaxConnectionReuseCount() Gets the maxConnectionReuseCount for UniversalConnectionPool.
long	getMaxConnectionReuseTime() Gets the maxConnectionReuseTime for UniversalConnectionPool.
int	getMaxPoolSize() Gets the maxPoolSize for UniversalConnectionPool.
ModelMBeanInfo	getMBeanInfo(ObjectName mbeanObjName, String mbeanDisplayName) Builds the MBeanInfo to define attributes, constructors, operations and notifications to expose to the remote users.
int	getMinPoolSize() Gets the minPoolSize for UniversalConnectionPool.
String	getName() Gets name of UniversalConnectionPool.
int	getPeakConnectionsCount() Gets the maximum number of connections that the connection pool has reached during the life of the pool.
long	getPeakConnectionWaitTime() Gets the longest wait (in milliseconds) a user request has to incur before obtaining a connection from the connection pool.
int	getPendingRequestsCount() Gets the number of clients that are currently waiting to obtain a connection from the pool.
int	getRemainingPoolCapacityCount() Gets the number of connections that may be added to the pool before it reaches maxPoolSize.
int	getSecondsToTrustIdleConnection() Gets the seconds To Trust Idle Connection value.
String	getStatistics() Gets the UniversalConnectionPoolStatistics for UniversalConnectionPool.
long	getSuccessfulAffinityBasedBorrowCount() Gets successful affinity borrow count
long	getSuccessfulRCLBBasedBorrowCount() Gets the number of borrow requests succeeded using Runtime Connection Load-Balancing (RCLB) algorithms.
int	getTimeoutCheckInterval() Gets the timeoutCheckInterval for UniversalConnectionPool.
int	getTimeToLiveConnectionTimeout() Gets the timeToLiveConnectionTimeout for UniversalConnectionPool.
int	getTotalConnectionsCount() Gets total connections count
ModelMBeanAttributeInfo[]	getUCPMBeanAttributes() Builds the Attribute information for UniversalConnectionPoolMBean.
ModelMBeanOperationInfo[]	getUCPMBeanOperations() Builds the operation information for UniversalConnectionPoolMBean.
boolean	getValidateConnectionOnBorrow() Gets the validateConnectionOnBorrow for UniversalConnectionPool.
void	purge() Purges the UniversalConnectionPool.
void	recycle() Recycles the UniversalConnectionPool.
void	refresh() Refreshes the UniversalConnectionPool.
void	setAbandonedConnectionTimeout(int abandonedConnectionTimeout) Sets the abandonedConnectionTimeout for UniversalConnectionPool.
void	setConnectionHarvestMaxCount(int connectionHarvestMaxCount) Sets the connectionHarvestMaxCount for UniversalConnectionPool.
void	setConnectionHarvestTriggerCount(int connectionHarvestTriggerCount) Sets the connectionHarvestTriggerCount for UniversalConnectionPool.
void	setConnectionWaitTimeout(int connectionWaitTimeout) Sets the connectionWaitTimeout for UniversalConnectionPool.
void	setInactiveConnectionTimeout(int inactiveConnectionTimeout) Sets the inactiveConnectionTimeout for UniversalConnectionPool.
void	setInitialPoolSize(int initialPoolSize) Sets the initialPoolSize for UniversalConnectionPool.
void	setMaxConnectionReuseCount(int maxConnectionReuseCount) Sets the maxConnectionReuseCount for UniversalConnectionPool.
void	setMaxConnectionReuseTime(long maxConnectionReuseTime) Sets the maxConnectionReuseTime for UniversalConnectionPool.
void	setMaxPoolSize(int maxPoolSize) Sets the maxPoolSize for UniversalConnectionPool.
void	setMinPoolSize(int minPoolSize) Sets the initialPoolSize for UniversalConnectionPool.
void	setName(String name) Sets the name of the UniversalConnectionPool.
void	setSecondsToTrustIdleConnection(int secondsToTrustIdleConnection) Sets the time in seconds to trust an idle connection to skip a validation test.
void	setTimeoutCheckInterval(int timeoutCheckInterval) Sets the timeoutCheckInterval for UniversalConnectionPool.
void	setTimeToLiveConnectionTimeout(int timeToLiveConnectionTimeout) Sets the timeToLiveConnectionTimeout for UniversalConnectionPool.
void	setValidateConnectionOnBorrow(boolean validateConnectionOnBorrow) Sets the validateConnectionOnBorrow for UniversalConnectionPool.
void	start() Starts the UniversalConnectionPool.
void	stop() Stops the UniversalConnectionPool.
void	useStrictWebSessionAffinity(boolean strict) The knob for switching strict web session affinity
void	useStrictXAAffinity(boolean strict)

Methods inherited from class java.lang.Object

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

Field Detail

connectionPool

protected final UniversalConnectionPool connectionPool

Constructor Detail

UniversalConnectionPoolMBeanBase

public UniversalConnectionPoolMBeanBase(UniversalConnectionPool connectionPool)
                                 throws UniversalConnectionPoolException

Constructor for UniversalConnectionPoolMBeanBase.

Throws:

UniversalConnectionPoolException - If an error occurs constructing UniversalConnectionPoolMBeanBase.

Method Detail

refresh

public void refresh()
             throws UniversalConnectionPoolException

Refreshes the UniversalConnectionPool.

Specified by:

refresh in interface UniversalConnectionPoolMBean

Throws:

UniversalConnectionPoolException - If an error occurs while refreshing the UniversalConnectionPool.

recycle

public void recycle()
             throws UniversalConnectionPoolException

Recycles the UniversalConnectionPool.

Specified by:

recycle in interface UniversalConnectionPoolMBean

Throws:

UniversalConnectionPoolException - If an error occurs while recycling the UniversalConnectionPool.

purge

public void purge()
           throws UniversalConnectionPoolException

Purges the UniversalConnectionPool.

Specified by:

purge in interface UniversalConnectionPoolMBean

Throws:

UniversalConnectionPoolException - If an error occurs while recycling the UniversalConnectionPool.

start

public void start()
           throws UniversalConnectionPoolException

Starts the UniversalConnectionPool.

Specified by:

start in interface UniversalConnectionPoolMBean

Throws:

UniversalConnectionPoolException - If an error occurs while starting the UniversalConnectionPool.

stop

public void stop()
          throws UniversalConnectionPoolException

Stops the UniversalConnectionPool.

Specified by:

stop in interface UniversalConnectionPoolMBean

Throws:

UniversalConnectionPoolException - If an error occurs while stopping the UniversalConnectionPool.

getName

public String getName()

Gets name of UniversalConnectionPool.

Specified by:

getName in interface UniversalConnectionPoolMBean

Returns:

String Returns the name of the UniversalConnectionPool.

setName

public void setName(String name)
             throws UniversalConnectionPoolException

Sets the name of the UniversalConnectionPool.

Specified by:

setName in interface UniversalConnectionPoolMBean

Parameters:

name - A new name for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the name of UniversalConnectionPool.

getInitialPoolSize

public int getInitialPoolSize()

Gets the initialPoolSize for UniversalConnectionPool.

Specified by:

getInitialPoolSize in interface UniversalConnectionPoolMBean

Returns:

int Returns initialPoolSize of the UniversalConnectionPool.

setInitialPoolSize

public void setInitialPoolSize(int initialPoolSize)
                        throws UniversalConnectionPoolException

Sets the initialPoolSize for UniversalConnectionPool.

Specified by:

setInitialPoolSize in interface UniversalConnectionPoolMBean

Parameters:

initialPoolSize - New initialPoolSize for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the initialPoolSize of UniversalConnectionPool.

getMinPoolSize

public int getMinPoolSize()

Gets the minPoolSize for UniversalConnectionPool.

Specified by:

getMinPoolSize in interface UniversalConnectionPoolMBean

Returns:

int Returns minPoolSize of the UniversalConnectionPool.

setMinPoolSize

public void setMinPoolSize(int minPoolSize)
                    throws UniversalConnectionPoolException

Sets the initialPoolSize for UniversalConnectionPool.

Specified by:

setMinPoolSize in interface UniversalConnectionPoolMBean

Parameters:

minPoolSize - New minPoolSize for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the minPoolSize of UniversalConnectionPool.

getMaxPoolSize

public int getMaxPoolSize()

Gets the maxPoolSize for UniversalConnectionPool.

Specified by:

getMaxPoolSize in interface UniversalConnectionPoolMBean

Returns:

int Returns maxPoolSize of the UniversalConnectionPool.

setMaxPoolSize

public void setMaxPoolSize(int maxPoolSize)
                    throws UniversalConnectionPoolException

Sets the maxPoolSize for UniversalConnectionPool.

Specified by:

setMaxPoolSize in interface UniversalConnectionPoolMBean

Parameters:

maxPoolSize - New maxPoolSize for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the maxPoolSize of UniversalConnectionPool.

getInactiveConnectionTimeout

public int getInactiveConnectionTimeout()

Gets the inactiveConnectionTimeout for UniversalConnectionPool.

Specified by:

getInactiveConnectionTimeout in interface UniversalConnectionPoolMBean

Returns:

int Returns inactiveConnectionTimeout of the UniversalConnectionPool.

setInactiveConnectionTimeout

public void setInactiveConnectionTimeout(int inactiveConnectionTimeout)
                                  throws UniversalConnectionPoolException

Sets the inactiveConnectionTimeout for UniversalConnectionPool.

Specified by:

setInactiveConnectionTimeout in interface UniversalConnectionPoolMBean

Parameters:

inactiveConnectionTimeout - New inactiveConnectionTimeout for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the inactiveConnectionTimeout of UniversalConnectionPool.

getAbandonedConnectionTimeout

public int getAbandonedConnectionTimeout()

Gets the abandonedConnectionTimeout for UniversalConnectionPool.

Specified by:

getAbandonedConnectionTimeout in interface UniversalConnectionPoolMBean

Returns:

int Returns abandonedConnectionTimeout of the UniversalConnectionPool.

setAbandonedConnectionTimeout

public void setAbandonedConnectionTimeout(int abandonedConnectionTimeout)
                                   throws UniversalConnectionPoolException

Sets the abandonedConnectionTimeout for UniversalConnectionPool.

Specified by:

setAbandonedConnectionTimeout in interface UniversalConnectionPoolMBean

Parameters:

abandonedConnectionTimeout - New abandonedConnectionTimeout for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the abandonedConnectionTimeout of UniversalConnectionPool.

getConnectionWaitTimeout

public int getConnectionWaitTimeout()

Gets the connectionWaitTimeout for UniversalConnectionPool.

Specified by:

getConnectionWaitTimeout in interface UniversalConnectionPoolMBean

Returns:

int Returns connectionWaitTimeout of the UniversalConnectionPool.

setConnectionWaitTimeout

public void setConnectionWaitTimeout(int connectionWaitTimeout)
                              throws UniversalConnectionPoolException

Sets the connectionWaitTimeout for UniversalConnectionPool.

Specified by:

setConnectionWaitTimeout in interface UniversalConnectionPoolMBean

Parameters:

connectionWaitTimeout - New connectionWaitTimeout for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the connectionWaitTimeout of UniversalConnectionPool.

getTimeToLiveConnectionTimeout

public int getTimeToLiveConnectionTimeout()

Gets the timeToLiveConnectionTimeout for UniversalConnectionPool.

Specified by:

getTimeToLiveConnectionTimeout in interface UniversalConnectionPoolMBean

Returns:

int Returns timeToLiveConnectionTimeout of the UniversalConnectionPool.

setTimeToLiveConnectionTimeout

public void setTimeToLiveConnectionTimeout(int timeToLiveConnectionTimeout)
                                    throws UniversalConnectionPoolException

Sets the timeToLiveConnectionTimeout for UniversalConnectionPool.

Specified by:

setTimeToLiveConnectionTimeout in interface UniversalConnectionPoolMBean

Parameters:

timeToLiveConnectionTimeout - New timeToLiveConnectionTimeout for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the timeToLiveConnectionTimeout of UniversalConnectionPool.

getTimeoutCheckInterval

public int getTimeoutCheckInterval()

Gets the timeoutCheckInterval for UniversalConnectionPool.

Specified by:

getTimeoutCheckInterval in interface UniversalConnectionPoolMBean

Returns:

int Returns timeoutCheckInterval of the UniversalConnectionPool.

setTimeoutCheckInterval

public void setTimeoutCheckInterval(int timeoutCheckInterval)
                             throws UniversalConnectionPoolException

Sets the timeoutCheckInterval for UniversalConnectionPool.

Specified by:

setTimeoutCheckInterval in interface UniversalConnectionPoolMBean

Parameters:

timeoutCheckInterval - New timeoutCheckInterval for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the timeoutCheckInterval of UniversalConnectionPool.

getValidateConnectionOnBorrow

public boolean getValidateConnectionOnBorrow()

Gets the validateConnectionOnBorrow for UniversalConnectionPool.

Specified by:

getValidateConnectionOnBorrow in interface UniversalConnectionPoolMBean

Returns:

boolean Returns validateConnectionOnBorrow of the UniversalConnectionPool.

setValidateConnectionOnBorrow

public void setValidateConnectionOnBorrow(boolean validateConnectionOnBorrow)

Sets the validateConnectionOnBorrow for UniversalConnectionPool.

Specified by:

setValidateConnectionOnBorrow in interface UniversalConnectionPoolMBean

Parameters:

validateConnectionOnBorrow - New validateConnectionOnBorrow for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the validateConnectionOnBorrow of UniversalConnectionPool.

getConnectionHarvestTriggerCount

public int getConnectionHarvestTriggerCount()

Gets the connectionHarvestTriggerCount for UniversalConnectionPool.

Specified by:

getConnectionHarvestTriggerCount in interface UniversalConnectionPoolMBean

Returns:

int Returns connectionHarvestTriggerCount of the UniversalConnectionPool.

setConnectionHarvestTriggerCount

public void setConnectionHarvestTriggerCount(int connectionHarvestTriggerCount)
                                      throws UniversalConnectionPoolException

Sets the connectionHarvestTriggerCount for UniversalConnectionPool.

Specified by:

setConnectionHarvestTriggerCount in interface UniversalConnectionPoolMBean

Parameters:

connectionHarvestTriggerCount - New connectionHarvestTriggerCount for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the connectionHarvestTriggerCount of UniversalConnectionPool.

getConnectionHarvestMaxCount

public int getConnectionHarvestMaxCount()

Gets the connectionHarvestMaxCount for UniversalConnectionPool.

Specified by:

getConnectionHarvestMaxCount in interface UniversalConnectionPoolMBean

Returns:

int Returns connectionHarvestMaxCount of the UniversalConnectionPool.

setConnectionHarvestMaxCount

public void setConnectionHarvestMaxCount(int connectionHarvestMaxCount)
                                  throws UniversalConnectionPoolException

Sets the connectionHarvestMaxCount for UniversalConnectionPool.

Specified by:

setConnectionHarvestMaxCount in interface UniversalConnectionPoolMBean

Parameters:

connectionHarvestMaxCount - New connectionHarvestMaxCount for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the connectionHarvestMaxCount of UniversalConnectionPool.

getMaxConnectionReuseTime

public long getMaxConnectionReuseTime()

Gets the maxConnectionReuseTime for UniversalConnectionPool.

Specified by:

getMaxConnectionReuseTime in interface UniversalConnectionPoolMBean

Returns:

long Returns maxConnectionReuseTime of the UniversalConnectionPool.

setMaxConnectionReuseTime

public void setMaxConnectionReuseTime(long maxConnectionReuseTime)
                               throws UniversalConnectionPoolException

Sets the maxConnectionReuseTime for UniversalConnectionPool.

Specified by:

setMaxConnectionReuseTime in interface UniversalConnectionPoolMBean

Parameters:

maxConnectionReuseTime - New maxConnectionReuseTime (in seconds) for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the maxConnectionReuseTime of UniversalConnectionPool.

getMaxConnectionReuseCount

public int getMaxConnectionReuseCount()

Gets the maxConnectionReuseCount for UniversalConnectionPool.

Specified by:

getMaxConnectionReuseCount in interface UniversalConnectionPoolMBean

Returns:

int Returns maxConnectionReuseCount of the UniversalConnectionPool.

setMaxConnectionReuseCount

public void setMaxConnectionReuseCount(int maxConnectionReuseCount)
                                throws UniversalConnectionPoolException

Sets the maxConnectionReuseCount for UniversalConnectionPool.

Specified by:

setMaxConnectionReuseCount in interface UniversalConnectionPoolMBean

Parameters:

maxConnectionReuseCount - New maxConnectionReuseCount for the UniversalConnectionPool.

Throws:

UniversalConnectionPoolException - If an error occurs while changing the maxConnectionReuseCount of UniversalConnectionPool.

getAvailableConnectionsCount

public int getAvailableConnectionsCount()

Gets the availableConnectionsCount for UniversalConnectionPool.

Specified by:

getAvailableConnectionsCount in interface UniversalConnectionPoolMBean

Returns:

int Returns availableConnectionsCount of the UniversalConnectionPool.

getBorrowedConnectionsCount

public int getBorrowedConnectionsCount()

Gets the borrowedConnectionsCount for UniversalConnectionPool.

Specified by:

getBorrowedConnectionsCount in interface UniversalConnectionPoolMBean

Returns:

int Returns borrowedConnectionsCount of the UniversalConnectionPool.

getStatistics

public String getStatistics()

Gets the UniversalConnectionPoolStatistics for UniversalConnectionPool.

Specified by:

getStatistics in interface UniversalConnectionPoolMBean

Returns:

statistics as a string

getLifeCycleState

public String getLifeCycleState()

Gets the UniversalConnectionPoolLifeCycleState of UniversalConnectionPool.

Specified by:

getLifeCycleState in interface UniversalConnectionPoolMBean

Returns:

lifecycle state as a string

useStrictWebSessionAffinity

public void useStrictWebSessionAffinity(boolean strict)

Description copied from interface: UniversalConnectionPoolMBean

The knob for switching strict web session affinity

Specified by:

useStrictWebSessionAffinity in interface UniversalConnectionPoolMBean

Parameters:

strict - if strict, otherwise nonstrict

useStrictXAAffinity

public void useStrictXAAffinity(boolean strict)

Specified by:

useStrictXAAffinity in interface UniversalConnectionPoolMBean

getSecondsToTrustIdleConnection

public int getSecondsToTrustIdleConnection()

Description copied from interface: UniversalConnectionPoolMBean

Gets the seconds To Trust Idle Connection value. See property description in setSecondsToTrustIdleConnection().

Specified by:

getSecondsToTrustIdleConnection in interface UniversalConnectionPoolMBean

Returns:

Seconds To Trust Idle Connection value.

setSecondsToTrustIdleConnection

public void setSecondsToTrustIdleConnection(int secondsToTrustIdleConnection)
                                     throws UniversalConnectionPoolException

Description copied from interface: UniversalConnectionPoolMBean

Sets the time in seconds to trust an idle connection to skip a validation test. It works in conjunction with setValidateConnectionOnBorrow(boolean). When set to any positive value, a connection validation during the checkout is skipped if the connection was successfully used and returned to the pool within the time specified for secondsToTrustIdleConnection. Default value is set to 0 seconds which means that the feature is disabled.

Specified by:

setSecondsToTrustIdleConnection in interface UniversalConnectionPoolMBean

Parameters:

secondsToTrustIdleConnection - The value of how long a connection can be trusted to skip connectionValidationOnBorrow

Throws:

UniversalConnectionPoolException

getTotalConnectionsCount

public int getTotalConnectionsCount()

Gets total connections count

Specified by:

getTotalConnectionsCount in interface UniversalConnectionPoolMBean

Returns:

total conns count

getAverageBorrowedConnectionsCount

public int getAverageBorrowedConnectionsCount()

Gets the average number of connections that are borrowed and actively in use by clients.

Specified by:

getAverageBorrowedConnectionsCount in interface UniversalConnectionPoolMBean

Returns:

The number of connections that are borrowed and actively in use by clients.

getPeakConnectionsCount

public int getPeakConnectionsCount()

Gets the maximum number of connections that the connection pool has reached during the life of the pool.

Specified by:

getPeakConnectionsCount in interface UniversalConnectionPoolMBean

Returns:

The maximum number of connections that the connection pool has reached during the life of the pool.

getRemainingPoolCapacityCount

public int getRemainingPoolCapacityCount()

Gets the number of connections that may be added to the pool before it reaches maxPoolSize.

Specified by:

getRemainingPoolCapacityCount in interface UniversalConnectionPoolMBean

Returns:

The number of connections that may be added to the pool before it reaches maxPoolSize.

getLabeledConnectionsCount

public int getLabeledConnectionsCount()

Gets the number of labeled connections in the connection pool.

Specified by:

getLabeledConnectionsCount in interface UniversalConnectionPoolMBean

Returns:

The number of labeled connections in the connection pool.

getConnectionsCreatedCount

public int getConnectionsCreatedCount()

Gets the number of connections created for this connection pool.

Specified by:

getConnectionsCreatedCount in interface UniversalConnectionPoolMBean

Returns:

The number of connections created for this connection pool.

getConnectionsClosedCount

public int getConnectionsClosedCount()

Gets the number of connections closed by this connection pool.

Specified by:

getConnectionsClosedCount in interface UniversalConnectionPoolMBean

Returns:

The number of connections closed by this connection pool.

getAverageConnectionWaitTime

public long getAverageConnectionWaitTime()

Gets the average time (in milliseconds) a user thread has to wait before it could obtain a connection from the connection pool.

Specified by:

getAverageConnectionWaitTime in interface UniversalConnectionPoolMBean

Returns:

The average time (in milliseconds) a user thread has to wait before it could obtain a connection from the connection pool.

getPeakConnectionWaitTime

public long getPeakConnectionWaitTime()

Gets the longest wait (in milliseconds) a user request has to incur before obtaining a connection from the connection pool. This includes threads that waited unsuccessfully for a connection.

Specified by:

getPeakConnectionWaitTime in interface UniversalConnectionPoolMBean

Returns:

The longest wait (in milliseconds) a user request has to incur before obtaining a connection from the connection pool.

getAbandonedConnectionsCount

public int getAbandonedConnectionsCount()

Gets the number of abandoned connections that have been reclaimed.

Specified by:

getAbandonedConnectionsCount in interface UniversalConnectionPoolMBean

Returns:

The number of abandoned connections that have been reclaimed.

getPendingRequestsCount

public int getPendingRequestsCount()

Gets the number of clients that are currently waiting to obtain a connection from the pool.

Specified by:

getPendingRequestsCount in interface UniversalConnectionPoolMBean

Returns:

The number of clients that are currently waiting to obtain a connection from the pool.

getCumulativeConnectionWaitTime

public long getCumulativeConnectionWaitTime()

Gets the cumulative time (in milliseconds) that connection requests have waited for connections over the life of the connection pool. This includes the time connections waited successfully and obtained a connection from the pool and those that failed waiting for a connection.

Specified by:

getCumulativeConnectionWaitTime in interface UniversalConnectionPoolMBean

Returns:

The cumulative time (in milliseconds) that connection requests have waited for connections over the life of the connection pool.

getCumulativeConnectionBorrowedCount

public long getCumulativeConnectionBorrowedCount()

Gets the number of connections borrowed from the connection pool over the life of the pool. This count is incremented each time a connection is borrowed.

Specified by:

getCumulativeConnectionBorrowedCount in interface UniversalConnectionPoolMBean

Returns:

The number of connections borrowed from the connection pool over the life of the pool.

getCumulativeConnectionUseTime

public long getCumulativeConnectionUseTime()

Gets the cumulative time (in milliseconds) of connections that were borrowed from the pool and remained in use.

Specified by:

getCumulativeConnectionUseTime in interface UniversalConnectionPoolMBean

Returns:

The cumulative time (in milliseconds) of connections that were borrowed from the pool and remained in use.

getCumulativeConnectionReturnedCount

public long getCumulativeConnectionReturnedCount()

Gets the number of connections returned to the connection pool over the life of the pool.

Specified by:

getCumulativeConnectionReturnedCount in interface UniversalConnectionPoolMBean

Returns:

The number of connections returned to the connection pool over the life of the pool.

getCumulativeSuccessfulConnectionWaitTime

public long getCumulativeSuccessfulConnectionWaitTime()

Gets the cumulative time (in milliseconds) that connection requests waited successfully and borrowed a connection from the pool.

Specified by:

getCumulativeSuccessfulConnectionWaitTime in interface UniversalConnectionPoolMBean

Returns:

The cumulative time (in milliseconds) that connection requests waited successfully and borrowed a connection from the pool.

getCumulativeSuccessfulConnectionWaitCount

public long getCumulativeSuccessfulConnectionWaitCount()

Gets the number of connection requests that waited successfully and borrowed a connection from the pool.

Specified by:

getCumulativeSuccessfulConnectionWaitCount in interface UniversalConnectionPoolMBean

Returns:

The number of connection requests that waited successfully and borrowed a connection from the pool.

getCumulativeFailedConnectionWaitTime

public long getCumulativeFailedConnectionWaitTime()

Gets the cumulative time (in milliseconds) that connection requests waited but failed to borrow a connection from the pool.

Specified by:

getCumulativeFailedConnectionWaitTime in interface UniversalConnectionPoolMBean

Returns:

The cumulative time (in milliseconds) that connection requests waited but failed to borrow a connection from the pool.

getCumulativeFailedConnectionWaitCount

public long getCumulativeFailedConnectionWaitCount()

Gets the number of connection requests that waited unsuccessfully to borrow a connection from the pool.

Specified by:

getCumulativeFailedConnectionWaitCount in interface UniversalConnectionPoolMBean

Returns:

The number of connection requests that waited unsuccessfully to borrow a connection from the pool.

getSuccessfulAffinityBasedBorrowCount

public long getSuccessfulAffinityBasedBorrowCount()

Gets successful affinity borrow count

Specified by:

getSuccessfulAffinityBasedBorrowCount in interface UniversalConnectionPoolMBean

Returns:

successful affinity count

getFailedAffinityBasedBorrowCount

public long getFailedAffinityBasedBorrowCount()

Gets the number of borrow requests that returned connections not matching the affinity contexts.

Specified by:

getFailedAffinityBasedBorrowCount in interface UniversalConnectionPoolMBean

Returns:

The number of borrow requests that returned connections not matching the affinity contexts.

getSuccessfulRCLBBasedBorrowCount

public long getSuccessfulRCLBBasedBorrowCount()

Gets the number of borrow requests succeeded using Runtime Connection Load-Balancing (RCLB) algorithms.

Specified by:

getSuccessfulRCLBBasedBorrowCount in interface UniversalConnectionPoolMBean

Returns:

The number of borrow requests succeeded using Runtime Connection Load-Balancing (RCLB) algorithms.

getFailedRCLBBasedBorrowCount

public long getFailedRCLBBasedBorrowCount()

Gets the number of borrow requests failed using Runtime Connection Load-Balancing (RCLB) algorithms.

Specified by:

getFailedRCLBBasedBorrowCount in interface UniversalConnectionPoolMBean

Returns:

The number of borrow requests failed using Runtime Connection Load-Balancing (RCLB) algorithms.

getFcfProcessingInfo

public String getFcfProcessingInfo()

Gets the information of recent Fast Connection Failover (FCF) attempts, in the form of a String. The information returned is to help diagnosing FCF problems, and includes the outcome of each FCF attempt (successful or failed), the relevant RAC instances, the number of connections cleaned up, the exception that triggered the FCF attempt failure, etc.

Specified by:

getFcfProcessingInfo in interface UniversalConnectionPoolMBean

Returns:

The information string for recent FCF attempts.

getFcfProcessingInfoProcessedOnly

public String getFcfProcessingInfoProcessedOnly()

Specified by:

getFcfProcessingInfoProcessedOnly in interface UniversalConnectionPoolMBean

getConnectionRepurposeCount

public long getConnectionRepurposeCount()

Returns the number of connection repurposed in a shared pool for a mutitenant database, where connections can be reused across PDB's by switching their container and PDB service.

Specified by:

getConnectionRepurposeCount in interface UniversalConnectionPoolMBean

getMBeanInfo

public ModelMBeanInfo getMBeanInfo(ObjectName mbeanObjName,
                                   String mbeanDisplayName)
                            throws UniversalConnectionPoolException

Builds the MBeanInfo to define attributes, constructors, operations and notifications to expose to the remote users.

Specified by:

getMBeanInfo in interface UniversalConnectionPoolMBean

Parameters:

mbeanObjName - Unique name for the UniversalConnectionPool MBean.

mbeanDisplayName - Display name for the UniversalConnection Pool MBean.

Returns:

ModelMBeanInfo for UniversalConnectionPoolMBean.

Throws:

UniversalConnectionPoolException - If an error occurs while getting the ModelMBeanInfo for UniversalConnectionPoolMBean.

getUCPMBeanAttributes

public ModelMBeanAttributeInfo[] getUCPMBeanAttributes()
                                                throws UniversalConnectionPoolException

Builds the Attribute information for UniversalConnectionPoolMBean.

Specified by:

getUCPMBeanAttributes in interface UniversalConnectionPoolMBean

Returns:

ModelMBeanAttributeInfo[] Returns AttributeInfo for UniversalConnectionPoolMBean.

Throws:

UniversalConnectionPoolException - If an error occurs while getting the ModelMBeanAttributeInfo[] for UniversalConnectionPoolMBean.

getUCPMBeanOperations

public ModelMBeanOperationInfo[] getUCPMBeanOperations()
                                                throws UniversalConnectionPoolException

Builds the operation information for UniversalConnectionPoolMBean.

Specified by:

getUCPMBeanOperations in interface UniversalConnectionPoolMBean

Returns:

ModelMBeanOperationInfo[] Returns OperationInfo for UniversalConnectionPoolMBean.

Throws:

UniversalConnectionPoolException - If an error occurs while getting the ModelMBeanOperationInfo[] for UniversalConnectionPoolMBean.