com.mysql.cj.jdbc.ha.ca

Class ClusterAwareWriterFailoverHandler

java.lang.Object

com.mysql.cj.jdbc.ha.ca.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 ConnectionProvider	connectionProvider
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 ReaderFailoverHandler	readerFailoverHandler
protected int	readTopologyIntervalMs
protected int	reconnectWriterIntervalMs
protected TopologyService	topologyService

Constructor Summary

Constructors

Constructor and Description
ClusterAwareWriterFailoverHandler(TopologyService topologyService, ConnectionProvider connectionProvider, ReaderFailoverHandler readerFailoverHandler, int failoverTimeoutMs, int readTopologyIntervalMs, int reconnectWriterIntervalMs, Log log) ClusterAwareWriterFailoverHandler constructor.
ClusterAwareWriterFailoverHandler(TopologyService topologyService, ConnectionProvider connectionProvider, ReaderFailoverHandler readerFailoverHandler, Log log) ClusterAwareWriterFailoverHandler constructor.

Method Summary

Modifier and Type	Method and Description
ResolvedHostInfo	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

topologyService

protected TopologyService topologyService

connectionProvider

protected ConnectionProvider connectionProvider

readerFailoverHandler

protected ReaderFailoverHandler readerFailoverHandler

Constructor Detail

ClusterAwareWriterFailoverHandler

public ClusterAwareWriterFailoverHandler(TopologyService topologyService,
                                         ConnectionProvider connectionProvider,
                                         ReaderFailoverHandler readerFailoverHandler,
                                         Log log)

ClusterAwareWriterFailoverHandler constructor.

ClusterAwareWriterFailoverHandler

public ClusterAwareWriterFailoverHandler(TopologyService topologyService,
                                         ConnectionProvider connectionProvider,
                                         ReaderFailoverHandler readerFailoverHandler,
                                         int failoverTimeoutMs,
                                         int readTopologyIntervalMs,
                                         int reconnectWriterIntervalMs,
                                         Log log)

ClusterAwareWriterFailoverHandler constructor.

Method Detail

failover

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

Called to start Writer Failover Process.

Specified by:

failover in interface WriterFailoverHandler

Parameters:

currentTopology - Cluster current topology

Returns:

ResolvedHostInfo The results of this process. May return null, which is considered an unsuccessful result.

Throws:

java.sql.SQLException