software.aws.rds.jdbc.postgresql.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
ReaderFailoverResult	failover(List<HostInfo> hosts, @Nullable HostInfo currentHost) Called to start Reader Failover Process.
ReaderFailoverResult	getReaderConnection(List<HostInfo> hostList) Called to get any available reader connection.

Method Detail

failover

ReaderFailoverResult failover(List<HostInfo> hosts,
                              @Nullable HostInfo currentHost)
                       throws 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:

ReaderFailoverResult The results of this process.

Throws:

SQLException - if an error occurs

getReaderConnection

ReaderFailoverResult getReaderConnection(List<HostInfo> hostList)
                                  throws 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:

ReaderFailoverResult The results of this process.

Throws:

SQLException - if an error occurs