software.amazon.jdbc.hostlistprovider

Class GdbMonitoringConnectionPriority

java.lang.Object

software.amazon.jdbc.hostlistprovider.GdbMonitoringConnectionPriority

public class GdbMonitoringConnectionPriority
extends java.lang.Object

Represents a monitoring connection priority choice for Global Aurora Databases.

Supported values:

• strict-writer-primary — writer node in the primary region
• strict-reader-primary — reader node in the primary region
• strict-reader-secondary — reader node in any secondary region
• strict-writer-<region> — writer node in the specified region (e.g. strict-writer-us-east-1)
• strict-reader-<region> — reader node in the specified region (e.g. strict-reader-us-west-2)
• <region> — any node in the specified region (e.g. us-east-1)

Method Summary

Modifier and Type	Method and Description
@Nullable HostSpec	findMatchingHost(@NonNull java.util.List<HostSpec> hosts, @Nullable java.lang.String primaryRegion, @NonNull RdsUtils rdsUtils) Finds the first host from the list that satisfies this priority.
java.util.List<HostSpec>	findMatchingHosts(@NonNull java.util.List<HostSpec> hosts, @Nullable java.lang.String primaryRegion, @NonNull RdsUtils rdsUtils) Finds all hosts from the list that satisfy this priority.
static @Nullable GdbMonitoringConnectionPriority	fromValue(@Nullable java.lang.String value) Parses a single priority value string.
@Nullable java.lang.String	getRequiredRegion()
@Nullable HostRole	getRequiredRole()
boolean	isRequirePrimary()
boolean	isRequireSecondary()
boolean	isSatisfiedBy(@NonNull HostSpec host, @Nullable java.lang.String primaryRegion, @NonNull RdsUtils rdsUtils) Checks if a given host satisfies this priority.
static java.util.List<GdbMonitoringConnectionPriority>	parseList(@Nullable java.lang.String value) Parses a comma-separated list of priority values.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

fromValue

public static @Nullable GdbMonitoringConnectionPriority fromValue(@Nullable java.lang.String value)

Parses a single priority value string.

Parameters:

value - the priority string

Returns:

the parsed priority, or null if the value is invalid

parseList

public static java.util.List<GdbMonitoringConnectionPriority> parseList(@Nullable java.lang.String value)

Parses a comma-separated list of priority values.

Parameters:

value - the comma-separated priority string

Returns:

the ordered list of parsed priorities (invalid values are skipped)

isSatisfiedBy

public boolean isSatisfiedBy(@NonNull HostSpec host,
                             @Nullable java.lang.String primaryRegion,
                             @NonNull RdsUtils rdsUtils)

Checks if a given host satisfies this priority.

Parameters:

host - the host to check

primaryRegion - the current primary region of the global database (region where the writer is)

rdsUtils - utility to extract region from host

Returns:

true if the host satisfies this priority

findMatchingHost

public @Nullable HostSpec findMatchingHost(@NonNull java.util.List<HostSpec> hosts,
                                           @Nullable java.lang.String primaryRegion,
                                           @NonNull RdsUtils rdsUtils)

Finds the first host from the list that satisfies this priority.

Parameters:

hosts - the available hosts

primaryRegion - the current primary region

rdsUtils - utility to extract region from host

Returns:

a matching host, or null if none found

findMatchingHosts

public java.util.List<HostSpec> findMatchingHosts(@NonNull java.util.List<HostSpec> hosts,
                                                  @Nullable java.lang.String primaryRegion,
                                                  @NonNull RdsUtils rdsUtils)

Finds all hosts from the list that satisfy this priority.

Parameters:

hosts - the available hosts

primaryRegion - the current primary region

rdsUtils - utility to extract region from host

Returns:

list of matching hosts (may be empty)

getRequiredRole

public @Nullable HostRole getRequiredRole()

getRequiredRegion

public @Nullable java.lang.String getRequiredRegion()

isRequirePrimary

public boolean isRequirePrimary()

isRequireSecondary

public boolean isRequireSecondary()

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object