software.amazon.jdbc.plugin.readwritesplitting.gate

Interface SwitchGate

All Known Implementing Classes:

TransactionAwareGate

public interface SwitchGate

Decides whether a connection switch is permitted right now ("when to switch?"). Owns the transaction-boundary rules and the pinning behavior.

Method Summary

Modifier and Type	Method and Description
boolean	canSwitch(RwSplitContext ctx, TargetRole desired) Returns whether a switch to desired is allowed.

Method Detail

canSwitch

boolean canSwitch(RwSplitContext ctx,
                  TargetRole desired)
           throws java.sql.SQLException

Returns whether a switch to desired is allowed. When it returns false the current connection is pinned (no switch is performed). Implementations may throw to reject an illegal transition (e.g. setReadOnly(false) inside an active transaction).

Parameters:

ctx - the read/write splitting context

desired - the desired target role

Returns:

true if switching is allowed, false to pin the current connection

Throws:

java.sql.SQLException