software.amazon.jdbc.plugin.failover

Class ClusterAwareReaderFailoverHandler

java.lang.Object

software.amazon.jdbc.plugin.failover.ClusterAwareReaderFailoverHandler

All Implemented Interfaces:

ReaderFailoverHandler

public class ClusterAwareReaderFailoverHandler
extends java.lang.Object
implements ReaderFailoverHandler

An implementation of ReaderFailoverHandler.

Reader Failover Process goal is to connect to any available reader. In order to connect faster, this implementation tries to connect to two readers at the same time. The first successfully connected reader is returned as the process result. If both readers are unavailable (i.e. could not be connected to), the process picks up another pair of readers and repeat. If no reader has been connected to, the process may consider a writer host, and other hosts marked down, to connect to.

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	DEFAULT_FAILOVER_TIMEOUT
protected static int	DEFAULT_READER_CONNECT_TIMEOUT
static ReaderFailoverResult	FAILED_READER_FAILOVER_RESULT
protected java.util.Properties	initialConnectionProps
protected boolean	isStrictReaderRequired
protected int	maxFailoverTimeoutMs
protected PluginService	pluginService
protected int	timeoutMs

Constructor Summary

Constructors

Constructor and Description
ClusterAwareReaderFailoverHandler(PluginService pluginService, java.util.Properties initialConnectionProps) ClusterAwareReaderFailoverHandler constructor.
ClusterAwareReaderFailoverHandler(PluginService pluginService, java.util.Properties initialConnectionProps, int maxFailoverTimeoutMs, int timeoutMs, boolean isStrictReaderRequired) ClusterAwareReaderFailoverHandler constructor.

Method Summary

Modifier and Type	Method and Description
ReaderFailoverResult	failover(java.util.List<HostSpec> hosts, HostSpec currentHost) Called to start Reader Failover Process.
protected ReaderFailoverResult	failoverInternal(java.util.List<HostSpec> hosts, HostSpec currentHost)
java.util.List<HostSpec>	getHostsByPriority(java.util.List<HostSpec> hosts)
ReaderFailoverResult	getReaderConnection(java.util.List<HostSpec> hostList) Called to get any available reader connection.
java.util.List<HostSpec>	getReaderHostsByPriority(java.util.List<HostSpec> hosts)
protected void	setTimeoutMs(int timeoutMs) Set process timeout in millis.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_FAILOVER_TIMEOUT

protected static final int DEFAULT_FAILOVER_TIMEOUT

See Also:

Constant Field Values

DEFAULT_READER_CONNECT_TIMEOUT

protected static final int DEFAULT_READER_CONNECT_TIMEOUT

See Also:

Constant Field Values

FAILED_READER_FAILOVER_RESULT

public static final ReaderFailoverResult FAILED_READER_FAILOVER_RESULT

initialConnectionProps

protected java.util.Properties initialConnectionProps

maxFailoverTimeoutMs

protected int maxFailoverTimeoutMs

timeoutMs

protected int timeoutMs

isStrictReaderRequired

protected boolean isStrictReaderRequired

pluginService

protected final PluginService pluginService

Constructor Detail

ClusterAwareReaderFailoverHandler

public ClusterAwareReaderFailoverHandler(PluginService pluginService,
                                         java.util.Properties initialConnectionProps)

ClusterAwareReaderFailoverHandler constructor.

Parameters:

pluginService - A provider for creating new connections.

initialConnectionProps - The initial connection properties to copy over to the new reader.

ClusterAwareReaderFailoverHandler

public ClusterAwareReaderFailoverHandler(PluginService pluginService,
                                         java.util.Properties initialConnectionProps,
                                         int maxFailoverTimeoutMs,
                                         int timeoutMs,
                                         boolean isStrictReaderRequired)

ClusterAwareReaderFailoverHandler constructor.

Parameters:

pluginService - A provider for creating new connections.

initialConnectionProps - The initial connection properties to copy over to the new reader.

maxFailoverTimeoutMs - Maximum allowed time for the entire reader failover process.

timeoutMs - Maximum allowed time in milliseconds for each reader connection attempt during the reader failover process.

isStrictReaderRequired - When true, it disables adding a writer to a list of nodes to connect

Method Detail

setTimeoutMs

protected void setTimeoutMs(int timeoutMs)

Set process timeout in millis. Entire process of connecting to a reader will be limited by this time duration.

Parameters:

timeoutMs - Process timeout in millis

failover

public ReaderFailoverResult failover(java.util.List<HostSpec> hosts,
                                     HostSpec currentHost)
                              throws java.sql.SQLException

Called to start Reader Failover Process. This process tries to connect to any reader. If no reader is available then driver may also try to connect to a writer host, down hosts, and the current reader host.

Specified by:

failover in interface ReaderFailoverHandler

Parameters:

hosts - Cluster current topology

currentHost - The currently connected host that has failed.

Returns:

ReaderFailoverResult The results of this process.

Throws:

java.sql.SQLException - indicating whether the failover attempt was successful.

failoverInternal

protected ReaderFailoverResult failoverInternal(java.util.List<HostSpec> hosts,
                                                HostSpec currentHost)
                                         throws java.sql.SQLException

Throws:

java.sql.SQLException

getHostsByPriority

public java.util.List<HostSpec> getHostsByPriority(java.util.List<HostSpec> hosts)

getReaderConnection

public ReaderFailoverResult getReaderConnection(java.util.List<HostSpec> hostList)
                                         throws java.sql.SQLException

Called to get any available reader connection. If no reader is available then result of process is unsuccessful. This process will not attempt to connect to the writer.

Specified by:

getReaderConnection in interface ReaderFailoverHandler

Parameters:

hostList - Cluster current topology

Returns:

ReaderFailoverResult The results of this process.

Throws:

java.sql.SQLException - if any error occurred while attempting a reader connection.

getReaderHostsByPriority

public java.util.List<HostSpec> getReaderHostsByPriority(java.util.List<HostSpec> hosts)