com.mysql.cj.jdbc.ha.plugins.failover

Class ClusterAwareWriterFailoverHandler

java.lang.Object

com.mysql.cj.jdbc.ha.plugins.failover.ClusterAwareWriterFailoverHandler

All Implemented Interfaces:

IWriterFailoverHandler

public class ClusterAwareWriterFailoverHandler
extends java.lang.Object
implements IWriterFailoverHandler

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 IConnectionProvider	connectionProvider
protected java.util.Map<java.lang.String,java.lang.String>	initialConnectionProps
protected Log	log The logger we're going to use.
protected int	maxFailoverTimeoutMs
protected static Log	NULL_LOGGER Null logger shared by all connections at startup.
protected IReaderFailoverHandler	readerFailoverHandler
protected int	readTopologyIntervalMs
protected int	reconnectWriterIntervalMs
protected ITopologyService	topologyService

Constructor Summary

Constructors

Constructor and Description
ClusterAwareWriterFailoverHandler(ITopologyService topologyService, IConnectionProvider connectionProvider, IReaderFailoverHandler readerFailoverHandler, java.util.Map<java.lang.String,java.lang.String> initialConnectionProps, int failoverTimeoutMs, int readTopologyIntervalMs, int reconnectWriterIntervalMs, Log log) ClusterAwareWriterFailoverHandler constructor.
ClusterAwareWriterFailoverHandler(ITopologyService topologyService, IConnectionProvider connectionProvider, IReaderFailoverHandler readerFailoverHandler, java.util.Map<java.lang.String,java.lang.String> initialConnectionProps, Log log) ClusterAwareWriterFailoverHandler constructor.

Method Summary

Modifier and Type	Method and Description
WriterFailoverResult	failover(java.util.List<HostInfo> 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

NULL_LOGGER

protected static final Log NULL_LOGGER

Null logger shared by all connections at startup.

log

protected transient Log log

The logger we're going to use.

maxFailoverTimeoutMs

protected int maxFailoverTimeoutMs

readTopologyIntervalMs

protected int readTopologyIntervalMs

reconnectWriterIntervalMs

protected int reconnectWriterIntervalMs

initialConnectionProps

protected java.util.Map<java.lang.String,java.lang.String> initialConnectionProps

topologyService

protected ITopologyService topologyService

connectionProvider

protected IConnectionProvider connectionProvider

readerFailoverHandler

protected IReaderFailoverHandler readerFailoverHandler

Constructor Detail

ClusterAwareWriterFailoverHandler

public ClusterAwareWriterFailoverHandler(ITopologyService topologyService,
                                         IConnectionProvider connectionProvider,
                                         IReaderFailoverHandler readerFailoverHandler,
                                         java.util.Map<java.lang.String,java.lang.String> initialConnectionProps,
                                         Log log)

ClusterAwareWriterFailoverHandler constructor.

ClusterAwareWriterFailoverHandler

public ClusterAwareWriterFailoverHandler(ITopologyService topologyService,
                                         IConnectionProvider connectionProvider,
                                         IReaderFailoverHandler readerFailoverHandler,
                                         java.util.Map<java.lang.String,java.lang.String> initialConnectionProps,
                                         int failoverTimeoutMs,
                                         int readTopologyIntervalMs,
                                         int reconnectWriterIntervalMs,
                                         Log log)

ClusterAwareWriterFailoverHandler constructor.

Method Detail

failover

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

Called to start Writer Failover Process.

Specified by:

failover in interface IWriterFailoverHandler

Parameters:

currentTopology - Cluster current topology

Returns:

WriterFailoverResult The results of this process.

Throws:

java.sql.SQLException