software.amazon.jdbc.plugin.readwritesplitting

Class GdbSimpleReadWriteSplittingPlugin

java.lang.Object

software.amazon.jdbc.plugin.AbstractConnectionPlugin

software.amazon.jdbc.plugin.readwritesplitting.UnifiedReadWriteSplittingPlugin

software.amazon.jdbc.plugin.readwritesplitting.SimpleReadWriteSplittingPlugin

software.amazon.jdbc.plugin.readwritesplitting.GdbSimpleReadWriteSplittingPlugin

All Implemented Interfaces:

CanReleaseResources, ConnectionPlugin, RwSplitContext, StateSnapshotProvider

Direct Known Subclasses:

GdbAutoSimpleReadWriteSplittingPlugin

public class GdbSimpleReadWriteSplittingPlugin
extends SimpleReadWriteSplittingPlugin

Global Database read/write splitting plugin using configured endpoints instead of cluster topology (gdbSimpleReadWriteSplitting): routes on setReadOnly between the configured write/read endpoints, while applying the Global Database region rules and Global Write Forwarding to the write endpoint. Region configuration is held by GdbSettings.

Field Summary

Fields inherited from class software.amazon.jdbc.plugin.readwritesplitting.SimpleReadWriteSplittingPlugin

SRW_CONNECT_RETRY_INTERVAL_MS, SRW_CONNECT_RETRY_TIMEOUT_MS, SRW_READ_ENDPOINT, SRW_WRITE_ENDPOINT, VERIFY_INITIAL_CONNECTION_TYPE, VERIFY_NEW_SRW_CONNECTIONS

Fields inherited from class software.amazon.jdbc.plugin.readwritesplitting.UnifiedReadWriteSplittingPlugin

ALLOW_STATEMENT_RECREATION_ON_CONNECTION_SWITCH, ASSUME_WRITE_TRANSACTION, CACHED_READER_KEEP_ALIVE_TIMEOUT, helpers, hostListProviderService, inReadWriteSplit, isReaderConnFromInternalPool, isWriterConnFromInternalPool, LOAD_BALANCING_INCLUDE_WRITER, pluginService, properties, QUERY_LEVEL_LOAD_BALANCING, readerCacheItem, readerHostSpec, writerConnection, writerHostSpec

Constructor Summary

Constructors

Modifier	Constructor and Description
	GdbSimpleReadWriteSplittingPlugin(PluginService pluginService, java.util.Properties properties)
protected	GdbSimpleReadWriteSplittingPlugin(PluginService pluginService, java.util.Properties properties, RwSplitHelpers helpers) Constructor for subclasses that supply their own helper assembly.

Method Summary

Modifier and Type	Method and Description
protected static RwSplitHelpers	gdbEndpointHelpers(java.util.Properties props, RoutingSignal routingSignal, SwitchGate switchGate) Shared endpoint-based Global Database assembly builder, parameterized by routing signal and switch gate so the SQL-routed variant can reuse it.
protected static RwSplitHelpers	gdbSimple(java.util.Properties props) Builds the endpoint-based Global Database assembly with setReadOnly routing.

Methods inherited from class software.amazon.jdbc.plugin.readwritesplitting.SimpleReadWriteSplittingPlugin

endpointHelpers, simple

Methods inherited from class software.amazon.jdbc.plugin.readwritesplitting.UnifiedReadWriteSplittingPlugin

bindReader, bindWriter, closeReaderConnectionIfIdle, closeWriterConnectionIfIdle, connect, connect, currentConnection, currentHostSpec, enterReadWriteSplit, execute, getReaderConnection, getSnapshotState, getSubscribedMethods, getWriterConnection, hostListProviderService, initHostProvider, isConnectionUsable, isInReadWriteSplit, isReaderFromPool, isWriterFromPool, logAndThrow, logAndThrow, markReaderFromPool, markWriterFromPool, notifyConnectionChanged, pluginService, properties, readerConnection, readerHostSpec, readerLoadBalancer, releaseResources, setWriterHostSpec, switchCurrentConnectionTo, writerConnection, writerHostSpec

Methods inherited from class software.amazon.jdbc.plugin.AbstractConnectionPlugin

acceptsStrategy, forceConnect, getHostSpecByStrategy, getHostSpecByStrategy, notifyNodeListChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

GdbSimpleReadWriteSplittingPlugin

public GdbSimpleReadWriteSplittingPlugin(PluginService pluginService,
                                         java.util.Properties properties)

GdbSimpleReadWriteSplittingPlugin

protected GdbSimpleReadWriteSplittingPlugin(PluginService pluginService,
                                            java.util.Properties properties,
                                            RwSplitHelpers helpers)

Constructor for subclasses that supply their own helper assembly.

Method Detail

gdbSimple

protected static RwSplitHelpers gdbSimple(java.util.Properties props)

Builds the endpoint-based Global Database assembly with setReadOnly routing.

gdbEndpointHelpers

protected static RwSplitHelpers gdbEndpointHelpers(java.util.Properties props,
                                                   RoutingSignal routingSignal,
                                                   SwitchGate switchGate)

Shared endpoint-based Global Database assembly builder, parameterized by routing signal and switch gate so the SQL-routed variant can reuse it. Fails fast when a required endpoint is missing. The write endpoint host is seeded before writer resolution (via EndpointWriterHostRefresher) so the GdbWriterResolver can evaluate its region for accessible-region / home-region rules and Global Write Forwarding.