software.amazon.jdbc.plugin.readwritesplitting.handler

Interface InitialConnectionHandler

All Known Implementing Classes:

GdbInitAndVerify, NoOpInitialConnectionHandler, VerifyEndpointOnConnect, VerifyRoleOnConnect

public interface InitialConnectionHandler

Handles the plugin's connect() behavior ("how is the initial connection established and verified?"). Implementations cover topology role verification, endpoint verification with retry, Global Database region initialization, and a pass-through.

Method Summary

Modifier and Type	Method and Description
java.sql.Connection	onConnect(RwSplitContext ctx, java.lang.String driverProtocol, HostSpec hostSpec, java.util.Properties props, boolean isInitialConnection, @NonNull JdbcCallable<java.sql.Connection,java.sql.SQLException> connectFunc) Invoked from the unified plugin's connect.

Method Detail

onConnect

java.sql.Connection onConnect(RwSplitContext ctx,
                              java.lang.String driverProtocol,
                              HostSpec hostSpec,
                              java.util.Properties props,
                              boolean isInitialConnection,
                              @NonNull JdbcCallable<java.sql.Connection,java.sql.SQLException> connectFunc)
                       throws java.sql.SQLException

Invoked from the unified plugin's connect.

Parameters:

ctx - the read/write splitting context

driverProtocol - the driver protocol

hostSpec - the host being connected to

props - the connection properties

isInitialConnection - whether this is the initial connection

connectFunc - the downstream connect function

Returns:

the established connection

Throws:

java.sql.SQLException