software.amazon.jdbc.plugin.readwritesplitting

Class ReadWriteSplittingPlugin

java.lang.Object

software.amazon.jdbc.plugin.AbstractConnectionPlugin

software.amazon.jdbc.plugin.readwritesplitting.UnifiedReadWriteSplittingPlugin

software.amazon.jdbc.plugin.readwritesplitting.ReadWriteSplittingPlugin

All Implemented Interfaces:

CanReleaseResources, ConnectionPlugin, RwSplitContext, StateSnapshotProvider

Direct Known Subclasses:

AutoReadWriteSplittingPlugin, GdbReadWriteSplittingPlugin

public class ReadWriteSplittingPlugin
extends UnifiedReadWriteSplittingPlugin

Topology-aware read/write splitting plugin (readWriteSplitting): routes on setReadOnly, selects a reader from the cluster topology using the configured host selector strategy, and caches a sticky reader. Composed from read/write splitting helpers on top of UnifiedReadWriteSplittingPlugin.

Field Summary

Fields

Modifier and Type	Field and Description
static AwsWrapperProperty	READER_HOST_SELECTOR_STRATEGY
static AwsWrapperProperty	VERIFY_INITIAL_CONNECTION_ROLE

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
	ReadWriteSplittingPlugin(PluginService pluginService, java.util.Properties properties)
protected	ReadWriteSplittingPlugin(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 java.lang.String	readerHostSelectorStrategy(java.util.Properties props)
protected static RwSplitHelpers	topology(java.util.Properties props) Builds the topology-aware, setReadOnly-driven, sticky-reader assembly.

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

Field Detail

READER_HOST_SELECTOR_STRATEGY

public static final AwsWrapperProperty READER_HOST_SELECTOR_STRATEGY

VERIFY_INITIAL_CONNECTION_ROLE

public static final AwsWrapperProperty VERIFY_INITIAL_CONNECTION_ROLE

Constructor Detail

ReadWriteSplittingPlugin

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

ReadWriteSplittingPlugin

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

Constructor for subclasses that supply their own helper assembly.

Method Detail

readerHostSelectorStrategy

protected static java.lang.String readerHostSelectorStrategy(java.util.Properties props)

topology

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

Builds the topology-aware, setReadOnly-driven, sticky-reader assembly.