software.amazon.jdbc

Class HighestLoadHostSelector

java.lang.Object

software.amazon.jdbc.HighestLoadHostSelector

All Implemented Interfaces:

HostSelector

public class HighestLoadHostSelector
extends java.lang.Object
implements HostSelector

Host selector that picks the highest-loaded reader using a calculated load derived from HostSpec.getCpuPercent() and HostSpec.getLagMs()

Note: Non-Aurora dialects may not be compatible as they do not populate host cpuPercent or lagMs.

Field Summary

Fields

Modifier and Type	Field and Description
protected static long	CPU_DEFAULT
static AwsWrapperProperty	HIGHEST_LOAD_CPU_WEIGHT
static AwsWrapperProperty	HIGHEST_LOAD_LAG_WEIGHT
protected static long	LAG_MS_DEFAULT
static java.lang.String	STRATEGY_HIGHEST_LOAD
static java.lang.String	STRATEGY_HIGHEST_LOAD_BY_CPU
static java.lang.String	STRATEGY_HIGHEST_LOAD_BY_LAG

Constructor Summary

Constructors

Constructor and Description
HighestLoadHostSelector()
HighestLoadHostSelector(long defaultCpuWeight, long defaultLagWeight)

Method Summary

Modifier and Type	Method and Description
static HighestLoadHostSelector	byCpu()
static HighestLoadHostSelector	byLag()
@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

STRATEGY_HIGHEST_LOAD

public static final java.lang.String STRATEGY_HIGHEST_LOAD

See Also:

Constant Field Values

STRATEGY_HIGHEST_LOAD_BY_CPU

public static final java.lang.String STRATEGY_HIGHEST_LOAD_BY_CPU

See Also:

Constant Field Values

STRATEGY_HIGHEST_LOAD_BY_LAG

public static final java.lang.String STRATEGY_HIGHEST_LOAD_BY_LAG

See Also:

Constant Field Values

HIGHEST_LOAD_CPU_WEIGHT

public static final AwsWrapperProperty HIGHEST_LOAD_CPU_WEIGHT

HIGHEST_LOAD_LAG_WEIGHT

public static final AwsWrapperProperty HIGHEST_LOAD_LAG_WEIGHT

CPU_DEFAULT

protected static final long CPU_DEFAULT

See Also:

Constant Field Values

LAG_MS_DEFAULT

protected static final long LAG_MS_DEFAULT

See Also:

Constant Field Values

Constructor Detail

HighestLoadHostSelector

public HighestLoadHostSelector()

HighestLoadHostSelector

public HighestLoadHostSelector(long defaultCpuWeight,
                               long defaultLagWeight)

Method Detail

byCpu

public static HighestLoadHostSelector byCpu()

byLag

public static HighestLoadHostSelector byLag()

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