software.amazon.jdbc

Class WeightedRandomHostSelector

java.lang.Object

software.amazon.jdbc.WeightedRandomHostSelector

All Implemented Interfaces:

HostSelector

public class WeightedRandomHostSelector
extends java.lang.Object
implements HostSelector

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	STRATEGY_WEIGHTED_RANDOM
static AwsWrapperProperty	WEIGHTED_RANDOM_HOST_WEIGHT_PAIRS

Constructor Summary

Constructors

Constructor and Description
WeightedRandomHostSelector()
WeightedRandomHostSelector(java.util.Random random)

Method Summary

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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

WEIGHTED_RANDOM_HOST_WEIGHT_PAIRS

public static final AwsWrapperProperty WEIGHTED_RANDOM_HOST_WEIGHT_PAIRS

STRATEGY_WEIGHTED_RANDOM

public static final java.lang.String STRATEGY_WEIGHTED_RANDOM

See Also:

Constant Field Values

Constructor Detail

WeightedRandomHostSelector

public WeightedRandomHostSelector()

WeightedRandomHostSelector

public WeightedRandomHostSelector(java.util.Random random)

Method Detail

getHost

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

Description copied from interface: HostSelector

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

Specified by:

getHost in interface HostSelector

Parameters:

hosts - a list of available hosts to pick from.

role - the desired host role - either a writer or a reader. Null value means no preferences on host role.

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

Returns:

a host matching the requested role, or null if no hosts match the requested role

Throws:

java.sql.SQLException - if an error occurs while selecting a host