software.amazon.jdbc.hostlistprovider.monitoring

Class ClusterTopologyMonitorImpl

java.lang.Object

software.amazon.jdbc.util.monitoring.AbstractMonitor

software.amazon.jdbc.hostlistprovider.monitoring.ClusterTopologyMonitorImpl

All Implemented Interfaces:

java.lang.Runnable, ClusterTopologyMonitor, Monitor

Direct Known Subclasses:

MultiAzClusterTopologyMonitorImpl

public class ClusterTopologyMonitorImpl
extends AbstractMonitor
implements ClusterTopologyMonitor

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	closeConnectionNetworkTimeoutMs
protected java.lang.String	clusterId
protected HostSpec	clusterInstanceTemplate
protected ConnectionService	connectionService
protected static int	defaultConnectionTimeoutMs
protected static int	defaultSocketTimeoutMs
protected static int	defaultTopologyQueryTimeoutMs
protected static long	highRefreshPeriodAfterPanicNano
protected long	highRefreshRateEndTimeNano
protected long	highRefreshRateNano
protected HostListProviderService	hostListProviderService
protected java.util.concurrent.atomic.AtomicLong	ignoreNewTopologyRequestsEndTimeNano
protected static long	ignoreTopologyRequestNano
protected HostSpec	initialHostSpec
protected boolean	isVerifiedWriterConnection
protected static java.lang.String	MONITORING_PROPERTY_PREFIX
protected java.util.concurrent.atomic.AtomicReference<java.sql.Connection>	monitoringConnection
protected java.util.Properties	monitoringProperties
protected static long	monitorTerminationTimeoutSec
protected static java.util.concurrent.Executor	networkTimeoutExecutor
protected java.util.concurrent.locks.ReentrantLock	nodeExecutorLock
protected java.util.concurrent.ExecutorService	nodeExecutorService
protected java.lang.String	nodeIdQuery
protected java.util.concurrent.atomic.AtomicReference<java.util.List<HostSpec>>	nodeThreadsLatestTopology
protected java.util.concurrent.atomic.AtomicReference<java.sql.Connection>	nodeThreadsReaderConnection
protected java.util.concurrent.atomic.AtomicBoolean	nodeThreadsStop
protected java.util.concurrent.atomic.AtomicReference<java.sql.Connection>	nodeThreadsWriterConnection
protected java.util.concurrent.atomic.AtomicReference<HostSpec>	nodeThreadsWriterHostSpec
protected java.util.Properties	properties
protected static RdsUtils	rdsHelper
protected long	refreshRateNano
protected java.util.concurrent.atomic.AtomicBoolean	requestToUpdateTopology
protected StorageService	storageService
protected java.util.concurrent.ConcurrentHashMap<java.lang.String,java.lang.Boolean>	submittedNodes
protected java.lang.String	topologyQuery
protected java.lang.Object	topologyUpdated
protected java.util.concurrent.atomic.AtomicReference<HostSpec>	writerHostSpec
protected java.lang.String	writerTopologyQuery

Fields inherited from class software.amazon.jdbc.util.monitoring.AbstractMonitor

lastActivityTimestampNanos, monitorExecutor, state, stop, terminationTimeoutSec

Constructor Summary

Constructors

Constructor and Description

ClusterTopologyMonitorImpl(java.lang.String clusterId, StorageService storageService, ConnectionService connectionService, HostSpec initialHostSpec, java.util.Properties properties, HostListProviderService hostListProviderService, HostSpec clusterInstanceTemplate, long refreshRateNano, long highRefreshRateNano, java.lang.String topologyQuery, java.lang.String writerTopologyQuery, java.lang.String nodeIdQuery)

Method Summary

Modifier and Type	Method and Description
boolean	canDispose() Defines whether this monitor can be disposed.
void	close() Closes all resources used by this monitor.
protected void	closeConnection(@Nullable java.sql.Connection connection)
protected HostSpec	createHost(java.sql.ResultSet resultSet, java.lang.String suggestedWriterNodeId)
protected HostSpec	createHost(java.lang.String nodeName, boolean isWriter, long weight, java.sql.Timestamp lastUpdateTime)
protected void	createNodeExecutorService()
protected void	delay(boolean useHighRefreshRate)
protected @Nullable java.util.List<HostSpec>	fetchTopologyAndUpdateCache(java.sql.Connection connection)
java.util.List<HostSpec>	forceRefresh(boolean shouldVerifyWriter, long timeoutMs)
java.util.List<HostSpec>	forceRefresh(@Nullable java.sql.Connection connection, long timeoutMs)
protected java.lang.String	getHostEndpoint(java.lang.String nodeName)
protected java.lang.String	getNodeId(java.sql.Connection connection)
protected java.lang.Runnable	getNodeMonitoringWorker(HostSpec hostSpec, @Nullable HostSpec writerHostSpec)
protected java.lang.String	getSuggestedWriterNodeId(java.sql.Connection connection)
protected java.lang.String	getWriterNodeId(java.sql.Connection connection)
protected boolean	isInPanicMode()
void	monitor() Executes the monitoring loop for this monitor.
protected java.util.List<HostSpec>	openAnyConnectionAndUpdateTopology()
protected @Nullable java.util.List<HostSpec>	processQueryResults(java.sql.ResultSet resultSet, java.lang.String suggestedWriterNodeId)
protected @Nullable java.util.List<HostSpec>	queryForTopology(java.sql.Connection conn)
void	setClusterId(java.lang.String clusterId)
protected void	shutdownNodeExecutorService()
void	stop() Stops the monitoring tasks for this monitor and closes all resources.
protected void	updateTopologyCache(@NonNull java.util.List<HostSpec> hosts)
protected java.util.List<HostSpec>	waitTillTopologyGetsUpdated(long timeoutMs)

Methods inherited from class software.amazon.jdbc.util.monitoring.AbstractMonitor

getLastActivityTimestampNanos, getState, run, start

Methods inherited from class java.lang.Object

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

Methods inherited from interface software.amazon.jdbc.util.monitoring.Monitor

getLastActivityTimestampNanos, getState, start

Field Detail

MONITORING_PROPERTY_PREFIX

protected static final java.lang.String MONITORING_PROPERTY_PREFIX

See Also:

Constant Field Values

networkTimeoutExecutor

protected static final java.util.concurrent.Executor networkTimeoutExecutor

rdsHelper

protected static final RdsUtils rdsHelper

monitorTerminationTimeoutSec

protected static final long monitorTerminationTimeoutSec

See Also:

Constant Field Values

defaultTopologyQueryTimeoutMs

protected static final int defaultTopologyQueryTimeoutMs

See Also:

Constant Field Values

closeConnectionNetworkTimeoutMs

protected static final int closeConnectionNetworkTimeoutMs

See Also:

Constant Field Values

defaultConnectionTimeoutMs

protected static final int defaultConnectionTimeoutMs

See Also:

Constant Field Values

defaultSocketTimeoutMs

protected static final int defaultSocketTimeoutMs

See Also:

Constant Field Values

highRefreshPeriodAfterPanicNano

protected static final long highRefreshPeriodAfterPanicNano

ignoreTopologyRequestNano

protected static final long ignoreTopologyRequestNano

refreshRateNano

protected final long refreshRateNano

highRefreshRateNano

protected final long highRefreshRateNano

properties

protected final java.util.Properties properties

monitoringProperties

protected final java.util.Properties monitoringProperties

initialHostSpec

protected final HostSpec initialHostSpec

storageService

protected final StorageService storageService

connectionService

protected final ConnectionService connectionService

topologyQuery

protected final java.lang.String topologyQuery

nodeIdQuery

protected final java.lang.String nodeIdQuery

writerTopologyQuery

protected final java.lang.String writerTopologyQuery

hostListProviderService

protected final HostListProviderService hostListProviderService

clusterInstanceTemplate

protected final HostSpec clusterInstanceTemplate

clusterId

protected java.lang.String clusterId

writerHostSpec

protected final java.util.concurrent.atomic.AtomicReference<HostSpec> writerHostSpec

monitoringConnection

protected final java.util.concurrent.atomic.AtomicReference<java.sql.Connection> monitoringConnection

isVerifiedWriterConnection

protected boolean isVerifiedWriterConnection

highRefreshRateEndTimeNano

protected long highRefreshRateEndTimeNano

topologyUpdated

protected final java.lang.Object topologyUpdated

requestToUpdateTopology

protected final java.util.concurrent.atomic.AtomicBoolean requestToUpdateTopology

ignoreNewTopologyRequestsEndTimeNano

protected final java.util.concurrent.atomic.AtomicLong ignoreNewTopologyRequestsEndTimeNano

submittedNodes

protected final java.util.concurrent.ConcurrentHashMap<java.lang.String,java.lang.Boolean> submittedNodes

nodeExecutorService

protected java.util.concurrent.ExecutorService nodeExecutorService

nodeExecutorLock

protected final java.util.concurrent.locks.ReentrantLock nodeExecutorLock

nodeThreadsStop

protected final java.util.concurrent.atomic.AtomicBoolean nodeThreadsStop

nodeThreadsWriterConnection

protected final java.util.concurrent.atomic.AtomicReference<java.sql.Connection> nodeThreadsWriterConnection

nodeThreadsWriterHostSpec

protected final java.util.concurrent.atomic.AtomicReference<HostSpec> nodeThreadsWriterHostSpec

nodeThreadsReaderConnection

protected final java.util.concurrent.atomic.AtomicReference<java.sql.Connection> nodeThreadsReaderConnection

nodeThreadsLatestTopology

protected final java.util.concurrent.atomic.AtomicReference<java.util.List<HostSpec>> nodeThreadsLatestTopology

Constructor Detail

ClusterTopologyMonitorImpl

public ClusterTopologyMonitorImpl(java.lang.String clusterId,
                                  StorageService storageService,
                                  ConnectionService connectionService,
                                  HostSpec initialHostSpec,
                                  java.util.Properties properties,
                                  HostListProviderService hostListProviderService,
                                  HostSpec clusterInstanceTemplate,
                                  long refreshRateNano,
                                  long highRefreshRateNano,
                                  java.lang.String topologyQuery,
                                  java.lang.String writerTopologyQuery,
                                  java.lang.String nodeIdQuery)

Method Detail

canDispose

public boolean canDispose()

Description copied from interface: Monitor

Defines whether this monitor can be disposed.

Specified by:

canDispose in interface ClusterTopologyMonitor

Specified by:

canDispose in interface Monitor

Overrides:

canDispose in class AbstractMonitor

Returns:

true if this monitor can be disposed, otherwise returns false.

setClusterId

public void setClusterId(java.lang.String clusterId)

Specified by:

setClusterId in interface ClusterTopologyMonitor

forceRefresh

public java.util.List<HostSpec> forceRefresh(boolean shouldVerifyWriter,
                                             long timeoutMs)
                                      throws java.sql.SQLException,
                                             java.util.concurrent.TimeoutException

Specified by:

forceRefresh in interface ClusterTopologyMonitor

Throws:

java.sql.SQLException

java.util.concurrent.TimeoutException

forceRefresh

public java.util.List<HostSpec> forceRefresh(@Nullable java.sql.Connection connection,
                                             long timeoutMs)
                                      throws java.sql.SQLException,
                                             java.util.concurrent.TimeoutException

Specified by:

forceRefresh in interface ClusterTopologyMonitor

Throws:

java.sql.SQLException

java.util.concurrent.TimeoutException

waitTillTopologyGetsUpdated

protected java.util.List<HostSpec> waitTillTopologyGetsUpdated(long timeoutMs)
                                                        throws java.util.concurrent.TimeoutException

Throws:

java.util.concurrent.TimeoutException

stop

public void stop()

Description copied from interface: Monitor

Stops the monitoring tasks for this monitor and closes all resources.

Specified by:

stop in interface Monitor

Overrides:

stop in class AbstractMonitor

close

public void close()

Description copied from interface: Monitor

Closes all resources used by this monitor. This method will be called as part of Monitor.stop().

Specified by:

close in interface Monitor

Overrides:

close in class AbstractMonitor

monitor

public void monitor()

Description copied from interface: Monitor

Executes the monitoring loop for this monitor. This method should be called in the run() method of the thread submitted during the call to Monitor.start(). Additionally, the monitoring loop should regularly update the last activity timestamp so that the MonitorService can detect whether the monitor is stuck or not.

Specified by:

monitor in interface Monitor

shutdownNodeExecutorService

protected void shutdownNodeExecutorService()

createNodeExecutorService

protected void createNodeExecutorService()

isInPanicMode

protected boolean isInPanicMode()

getNodeMonitoringWorker

protected java.lang.Runnable getNodeMonitoringWorker(HostSpec hostSpec,
                                                     @Nullable HostSpec writerHostSpec)

openAnyConnectionAndUpdateTopology

protected java.util.List<HostSpec> openAnyConnectionAndUpdateTopology()

getNodeId

protected java.lang.String getNodeId(java.sql.Connection connection)

closeConnection

protected void closeConnection(@Nullable java.sql.Connection connection)

delay

protected void delay(boolean useHighRefreshRate)
              throws java.lang.InterruptedException

Throws:

java.lang.InterruptedException

fetchTopologyAndUpdateCache

protected @Nullable java.util.List<HostSpec> fetchTopologyAndUpdateCache(java.sql.Connection connection)

updateTopologyCache

protected void updateTopologyCache(@NonNull java.util.List<HostSpec> hosts)

getWriterNodeId

protected java.lang.String getWriterNodeId(java.sql.Connection connection)
                                    throws java.sql.SQLException

Throws:

java.sql.SQLException

queryForTopology

protected @Nullable java.util.List<HostSpec> queryForTopology(java.sql.Connection conn)
                                                       throws java.sql.SQLException

Throws:

java.sql.SQLException

getSuggestedWriterNodeId

protected java.lang.String getSuggestedWriterNodeId(java.sql.Connection connection)
                                             throws java.sql.SQLException

Throws:

java.sql.SQLException

processQueryResults

protected @Nullable java.util.List<HostSpec> processQueryResults(java.sql.ResultSet resultSet,
                                                                 java.lang.String suggestedWriterNodeId)
                                                          throws java.sql.SQLException

Throws:

java.sql.SQLException

createHost

protected HostSpec createHost(java.sql.ResultSet resultSet,
                              java.lang.String suggestedWriterNodeId)
                       throws java.sql.SQLException

Throws:

java.sql.SQLException

createHost

protected HostSpec createHost(java.lang.String nodeName,
                              boolean isWriter,
                              long weight,
                              java.sql.Timestamp lastUpdateTime)

getHostEndpoint

protected java.lang.String getHostEndpoint(java.lang.String nodeName)