com.mysql.cj.jdbc.ha.ca

Interface ReaderFailoverHandler

All Known Implementing Classes:

ClusterAwareReaderFailoverHandler

public interface ReaderFailoverHandler

Interface for Reader Failover Process handler. This handler implements all necessary logic to try to reconnect to another reader host.

Method Summary

Modifier and Type	Method and Description
ConnectionAttemptResult	failover(java.util.List<HostInfo> hosts, HostInfo currentHost) Called to start Reader Failover Process.
ConnectionAttemptResult	getReaderConnection(java.util.List<HostInfo> hostList) Called to get any available reader connection.

Method Detail

failover

ConnectionAttemptResult failover(java.util.List<HostInfo> hosts,
                                 HostInfo 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.

Parameters:

hosts - Cluster current topology.

currentHost - The currently connected host that has failed.

Returns:

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

Throws:

java.sql.SQLException

getReaderConnection

ConnectionAttemptResult getReaderConnection(java.util.List<HostInfo> 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 host.

Parameters:

hostList - Cluster current topology.

Returns:

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

Throws:

java.sql.SQLException