Package oracle.ucp.jdbc.oracle

Class RACManagerImpl

java.lang.Object

oracle.ucp.jdbc.oracle.RACManagerImpl

All Implemented Interfaces:

oracle.ucp.common.Failoverable, RACManager

public class RACManagerImpl
extends Object
implements RACManager, oracle.ucp.common.Failoverable

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	RACManagerImpl.RACCallbackExtended

Field Summary

Fields

Modifier and Type	Field	Description
protected boolean	calledStartONS
protected oracle.ons.ONS	currentONS
protected ConnectionAffinityCallback	m_connectionAffinityCallback
protected AtomicLong	m_failedAffinityBasedBorrowCount
protected AtomicLong	m_failedRCLBBasedBorrowCount
protected AtomicReference<String>	m_fcfProcessingInfo
protected AtomicReference<String>	m_fcfProcessingInfoProcessedOnly
protected AtomicLong	m_successfulAffinityBasedBorrowCount
protected AtomicLong	m_successfulRCLBBasedBorrowCount
oracle.ucp.jdbc.oracle.rlb.MetricsAccumulator	rlbMetricsAccumulator

Method Summary

Modifier and Type	Method	Description
void	cleanupConnectionsForDownEvent(FailoverablePooledConnection[] aconns, FailoverablePooledConnection[] bconns, OracleFailoverEvent failoverEvent)
protected void	cleanupRLBTasks()
void	connectionClosed(FailoverablePooledConnection fpc)
void	connectionOpened(FailoverablePooledConnection fpc)
RACAffinityContext	createRACAffinityContext(String service, String dbUniqName, String instance, String version, RACAffinityContext.AffinityType affinityType)
oracle.ucp.routing.oracle.ShardManager	createShardManager()
String	generateDatabaseInstanceKey(String instanceName, String dbName, String serviceName)
protected void	getAutoONSConfigurationFromServer()
ConnectionAffinityCallback	getConnectionAffinityCallback()
boolean	getConnectionAffinityValue(String instanceKey)
int	getDatabaseVersion()
long	getFailedAffinityBasedBorrowCount()
long	getFailedRCLBBasedBorrowCount()
Object	getFailoverInfo()	Gets information necessary for failover processing.
String	getFCFProcessingInfo()
String	getFCFProcessingInfoProcessedOnly()
RACInstance	getMostDesirableInstanceToGrow()
protected oracle.ons.ONS	getONS()
String	getONSConfiguration()
RACCallbackGuard	getRACCallback()
long	getSuccessfulAffinityBasedBorrowCount()
long	getSuccessfulRCLBBasedBorrowCount()
protected void	gravitatePool()
void	handleFailoverEvent(oracle.ucp.common.FailoverEvent event)	Handles a failover event.
protected void	incrementFailedAffinityBasedBorrowCount()
void	incrementFailedRCLBBasedBorrowCount()
void	incrementSuccessfulAffinityBasedBorrowCount()
void	incrementSuccessfulRCLBBasedBorrowCount()
protected void	initRuntimeLoadBalancing(String serviceName)
boolean	isRuntimeLoadBalancingEnabled()
void	markDownConnectionsForDownEvent(FailoverablePooledConnection[] aconns, FailoverablePooledConnection[] bconns, OracleFailoverEvent failoverEvent)
protected void	processDatabaseInstances()
int	processUpEvent(FailoverablePooledConnection[] aconns, FailoverablePooledConnection[] bconns, int initialPoolSize, int maxPoolSize, OracleFailoverEvent failoverEvent)
void	registerConnectionAffinityCallback(ConnectionAffinityCallback cbk)
void	registerRACCallback(RACCallback cbk)
protected FailoverablePooledConnection	selectConnectionPerDataBasedAffinity(ConnectionRetrievalInfo cri)
FailoverablePooledConnection	selectConnectionPerRCLB(ConnectionRetrievalInfo cri)
FailoverablePooledConnection	selectConnectionPerRCLBAndAffinity(ConnectionRetrievalInfo cri)
protected void	setFailoverEventHandlerTask(oracle.ucp.jdbc.oracle.ONSDatabaseEventHandlerTask failoverEventHandlerTask)
void	setFailoverInfo(Object info)	Sets information necessary for failover processing.
void	setONSConfiguration(String onsConfigStr)
void	setRuntimeLoadBalancingEnabled(boolean RLBEnabled)
protected void	setRuntimeLoadBalancingEventHandlerTask(oracle.ucp.jdbc.oracle.ONSRuntimeLBEventHandlerTask rlbEventHandlerTask)
void	start()
void	stop()
protected void	terminateRuntimeLoadBalancing()
void	unregisterConnectionAffinityCallback(ConnectionAffinityCallback cbk)
void	unregisterRACCallback(RACCallback cbk)

Methods inherited from class java.lang.Object

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

Field Detail

rlbMetricsAccumulator

public final oracle.ucp.jdbc.oracle.rlb.MetricsAccumulator rlbMetricsAccumulator

m_fcfProcessingInfo

protected final AtomicReference<String> m_fcfProcessingInfo

m_fcfProcessingInfoProcessedOnly

protected final AtomicReference<String> m_fcfProcessingInfoProcessedOnly

m_connectionAffinityCallback

protected ConnectionAffinityCallback m_connectionAffinityCallback

m_successfulAffinityBasedBorrowCount

protected final AtomicLong m_successfulAffinityBasedBorrowCount

m_failedAffinityBasedBorrowCount

protected final AtomicLong m_failedAffinityBasedBorrowCount

m_successfulRCLBBasedBorrowCount

protected final AtomicLong m_successfulRCLBBasedBorrowCount

m_failedRCLBBasedBorrowCount

protected final AtomicLong m_failedRCLBBasedBorrowCount

currentONS

protected oracle.ons.ONS currentONS

calledStartONS

protected boolean calledStartONS

Method Detail

handleFailoverEvent

public void handleFailoverEvent(oracle.ucp.common.FailoverEvent event)
                         throws UniversalConnectionPoolException

Description copied from interface: oracle.ucp.common.Failoverable

Handles a failover event.

Specified by:

handleFailoverEvent in interface oracle.ucp.common.Failoverable

Parameters:

event - The failover event.

Throws:

UniversalConnectionPoolException

processUpEvent

public int processUpEvent(FailoverablePooledConnection[] aconns,
                          FailoverablePooledConnection[] bconns,
                          int initialPoolSize,
                          int maxPoolSize,
                          OracleFailoverEvent failoverEvent)
                   throws UniversalConnectionPoolException

Specified by:

processUpEvent in interface RACManager

Throws:

UniversalConnectionPoolException

start

public void start()
           throws UniversalConnectionPoolException

Specified by:

start in interface RACManager

Throws:

UniversalConnectionPoolException

stop

public void stop()
          throws UniversalConnectionPoolException

Specified by:

stop in interface RACManager

Throws:

UniversalConnectionPoolException

setFailoverEventHandlerTask

protected void setFailoverEventHandlerTask(oracle.ucp.jdbc.oracle.ONSDatabaseEventHandlerTask failoverEventHandlerTask)

setFailoverInfo

public void setFailoverInfo(Object info)
                     throws UniversalConnectionPoolException

Description copied from interface: oracle.ucp.common.Failoverable

Sets information necessary for failover processing.

Specified by:

setFailoverInfo in interface oracle.ucp.common.Failoverable

Parameters:

info - Failover information object.

Throws:

UniversalConnectionPoolException - if error occurs when setting the failover information object.

getFailoverInfo

public Object getFailoverInfo()

Description copied from interface: oracle.ucp.common.Failoverable

Gets information necessary for failover processing.

Specified by:

getFailoverInfo in interface oracle.ucp.common.Failoverable

getONSConfiguration

public String getONSConfiguration()

Specified by:

getONSConfiguration in interface RACManager

setONSConfiguration

public void setONSConfiguration(String onsConfigStr)
                         throws UniversalConnectionPoolException

Specified by:

setONSConfiguration in interface RACManager

Throws:

UniversalConnectionPoolException

markDownConnectionsForDownEvent

public void markDownConnectionsForDownEvent(FailoverablePooledConnection[] aconns,
                                            FailoverablePooledConnection[] bconns,
                                            OracleFailoverEvent failoverEvent)

Specified by:

markDownConnectionsForDownEvent in interface RACManager

cleanupConnectionsForDownEvent

public void cleanupConnectionsForDownEvent(FailoverablePooledConnection[] aconns,
                                           FailoverablePooledConnection[] bconns,
                                           OracleFailoverEvent failoverEvent)

Specified by:

cleanupConnectionsForDownEvent in interface RACManager

registerRACCallback

public void registerRACCallback(RACCallback cbk)

Specified by:

registerRACCallback in interface RACManager

unregisterRACCallback

public void unregisterRACCallback(RACCallback cbk)

Specified by:

unregisterRACCallback in interface RACManager

getRACCallback

public RACCallbackGuard getRACCallback()

connectionOpened

public void connectionOpened(FailoverablePooledConnection fpc)
                      throws UniversalConnectionPoolException

Specified by:

connectionOpened in interface RACManager

Throws:

UniversalConnectionPoolException

connectionClosed

public void connectionClosed(FailoverablePooledConnection fpc)
                      throws UniversalConnectionPoolException

Specified by:

connectionClosed in interface RACManager

Throws:

UniversalConnectionPoolException

getFCFProcessingInfoProcessedOnly

public String getFCFProcessingInfoProcessedOnly()

Specified by:

getFCFProcessingInfoProcessedOnly in interface RACManager

getFCFProcessingInfo

public String getFCFProcessingInfo()

Specified by:

getFCFProcessingInfo in interface RACManager

isRuntimeLoadBalancingEnabled

public boolean isRuntimeLoadBalancingEnabled()

Specified by:

isRuntimeLoadBalancingEnabled in interface RACManager

setRuntimeLoadBalancingEnabled

public void setRuntimeLoadBalancingEnabled(boolean RLBEnabled)
                                    throws UniversalConnectionPoolException

Throws:

UniversalConnectionPoolException

initRuntimeLoadBalancing

protected void initRuntimeLoadBalancing(String serviceName)
                                 throws UniversalConnectionPoolException

Throws:

UniversalConnectionPoolException

terminateRuntimeLoadBalancing

protected void terminateRuntimeLoadBalancing()
                                      throws UniversalConnectionPoolException

Throws:

UniversalConnectionPoolException

setRuntimeLoadBalancingEventHandlerTask

protected void setRuntimeLoadBalancingEventHandlerTask(oracle.ucp.jdbc.oracle.ONSRuntimeLBEventHandlerTask rlbEventHandlerTask)

processDatabaseInstances

protected void processDatabaseInstances()

gravitatePool

protected void gravitatePool()

selectConnectionPerRCLBAndAffinity

public FailoverablePooledConnection selectConnectionPerRCLBAndAffinity(ConnectionRetrievalInfo cri)
                                                                throws UniversalConnectionPoolException

Specified by:

selectConnectionPerRCLBAndAffinity in interface RACManager

Throws:

UniversalConnectionPoolException

selectConnectionPerDataBasedAffinity

protected FailoverablePooledConnection selectConnectionPerDataBasedAffinity(ConnectionRetrievalInfo cri)
                                                                     throws UniversalConnectionPoolException

Throws:

UniversalConnectionPoolException

selectConnectionPerRCLB

public FailoverablePooledConnection selectConnectionPerRCLB(ConnectionRetrievalInfo cri)
                                                     throws UniversalConnectionPoolException

Specified by:

selectConnectionPerRCLB in interface RACManager

Throws:

UniversalConnectionPoolException

cleanupRLBTasks

protected void cleanupRLBTasks()

getSuccessfulAffinityBasedBorrowCount

public long getSuccessfulAffinityBasedBorrowCount()

Specified by:

getSuccessfulAffinityBasedBorrowCount in interface RACManager

getFailedAffinityBasedBorrowCount

public long getFailedAffinityBasedBorrowCount()

Specified by:

getFailedAffinityBasedBorrowCount in interface RACManager

getSuccessfulRCLBBasedBorrowCount

public long getSuccessfulRCLBBasedBorrowCount()

Specified by:

getSuccessfulRCLBBasedBorrowCount in interface RACManager

getFailedRCLBBasedBorrowCount

public long getFailedRCLBBasedBorrowCount()

Specified by:

getFailedRCLBBasedBorrowCount in interface RACManager

incrementSuccessfulAffinityBasedBorrowCount

public void incrementSuccessfulAffinityBasedBorrowCount()

incrementFailedAffinityBasedBorrowCount

protected void incrementFailedAffinityBasedBorrowCount()

incrementSuccessfulRCLBBasedBorrowCount

public void incrementSuccessfulRCLBBasedBorrowCount()

incrementFailedRCLBBasedBorrowCount

public void incrementFailedRCLBBasedBorrowCount()

getDatabaseVersion

public int getDatabaseVersion()

registerConnectionAffinityCallback

public void registerConnectionAffinityCallback(ConnectionAffinityCallback cbk)
                                        throws UniversalConnectionPoolException

Specified by:

registerConnectionAffinityCallback in interface RACManager

Throws:

UniversalConnectionPoolException

unregisterConnectionAffinityCallback

public void unregisterConnectionAffinityCallback(ConnectionAffinityCallback cbk)
                                          throws UniversalConnectionPoolException

Specified by:

unregisterConnectionAffinityCallback in interface RACManager

Throws:

UniversalConnectionPoolException

getConnectionAffinityCallback

public ConnectionAffinityCallback getConnectionAffinityCallback()

getConnectionAffinityValue

public boolean getConnectionAffinityValue(String instanceKey)

generateDatabaseInstanceKey

public String generateDatabaseInstanceKey(String instanceName,
                                          String dbName,
                                          String serviceName)

getMostDesirableInstanceToGrow

public RACInstance getMostDesirableInstanceToGrow()

Specified by:

getMostDesirableInstanceToGrow in interface RACManager

createRACAffinityContext

public RACAffinityContext createRACAffinityContext(String service,
                                                   String dbUniqName,
                                                   String instance,
                                                   String version,
                                                   RACAffinityContext.AffinityType affinityType)

Specified by:

createRACAffinityContext in interface RACManager

getAutoONSConfigurationFromServer

protected void getAutoONSConfigurationFromServer()
                                          throws UniversalConnectionPoolException

Throws:

UniversalConnectionPoolException

getONS

protected oracle.ons.ONS getONS()
                         throws UniversalConnectionPoolException

Throws:

UniversalConnectionPoolException

createShardManager

public oracle.ucp.routing.oracle.ShardManager createShardManager()
                                                          throws UniversalConnectionPoolException

Specified by:

createShardManager in interface RACManager

Returns:

a new instance of ShardManager

Throws:

UniversalConnectionPoolException - if there is an error during creation.