software.amazon.jdbc

Interface HostSelector

All Known Implementing Classes:

HighestWeightHostSelector, LeastConnectionsHostSelector, RandomHostSelector, RoundRobinHostSelector

public interface HostSelector

Method Summary

Modifier and Type	Method and Description
HostSpec	getHost(@NonNull java.util.List<HostSpec> hosts, @NonNull HostRole role, @Nullable java.util.Properties props) Selects a host with the requested role from the given host list.

Method Detail

getHost

HostSpec getHost(@NonNull java.util.List<HostSpec> hosts,
                 @NonNull HostRole role,
                 @Nullable java.util.Properties props)
          throws java.sql.SQLException

Selects a host with the requested role from the given host list.

Parameters:

hosts - a list of available hosts to pick from.

role - the desired host role - either a writer or a reader.

props - connection properties that may be needed by the host selector in order to choose a host.

Returns:

a host matching the requested role

Throws:

java.sql.SQLException - if the host list does not contain any hosts matching the requested role or an error occurs while selecting a host