software.amazon.jdbc.plugin.failover

Class ClusterAwareWriterFailoverHandler

java.lang.Object

software.amazon.jdbc.plugin.failover.ClusterAwareWriterFailoverHandler

All Implemented Interfaces:

WriterFailoverHandler

public class ClusterAwareWriterFailoverHandler
extends java.lang.Object
implements WriterFailoverHandler

An implementation of WriterFailoverHandler.

Writer Failover Process goal is to re-establish connection to a writer. Connection to a writer may be disrupted either by temporary network issue, or due to writer host unavailability during cluster failover. This handler tries both approaches in parallel: 1) try to re-connect to the same writer host, 2) try to update cluster topology and connect to a newly elected writer.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Properties	initialConnectionProps
protected int	maxFailoverTimeoutMs
protected PluginService	pluginService
protected ReaderFailoverHandler	readerFailoverHandler
protected int	readTopologyIntervalMs
protected int	reconnectWriterIntervalMs

Constructor Summary

Constructors

Constructor and Description
ClusterAwareWriterFailoverHandler(PluginService pluginService, ReaderFailoverHandler readerFailoverHandler, java.util.Properties initialConnectionProps)
ClusterAwareWriterFailoverHandler(PluginService pluginService, ReaderFailoverHandler readerFailoverHandler, java.util.Properties initialConnectionProps, int failoverTimeoutMs, int readTopologyIntervalMs, int reconnectWriterIntervalMs)

Method Summary

Modifier and Type	Method and Description
WriterFailoverResult	failover(java.util.List<HostSpec> currentTopology) Called to start Writer Failover Process.

Methods inherited from class java.lang.Object

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

Field Detail

maxFailoverTimeoutMs

protected int maxFailoverTimeoutMs

readTopologyIntervalMs

protected int readTopologyIntervalMs

reconnectWriterIntervalMs

protected int reconnectWriterIntervalMs

initialConnectionProps

protected java.util.Properties initialConnectionProps

pluginService

protected PluginService pluginService

readerFailoverHandler

protected ReaderFailoverHandler readerFailoverHandler

Constructor Detail

ClusterAwareWriterFailoverHandler

public ClusterAwareWriterFailoverHandler(PluginService pluginService,
                                         ReaderFailoverHandler readerFailoverHandler,
                                         java.util.Properties initialConnectionProps)

ClusterAwareWriterFailoverHandler

public ClusterAwareWriterFailoverHandler(PluginService pluginService,
                                         ReaderFailoverHandler readerFailoverHandler,
                                         java.util.Properties initialConnectionProps,
                                         int failoverTimeoutMs,
                                         int readTopologyIntervalMs,
                                         int reconnectWriterIntervalMs)

Method Detail

failover

public WriterFailoverResult failover(java.util.List<HostSpec> currentTopology)
                              throws java.sql.SQLException

Called to start Writer Failover Process.

Specified by:

failover in interface WriterFailoverHandler

Parameters:

currentTopology - Cluster current topology

Returns:

WriterFailoverResult The results of this process.

Throws:

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