software.amazon.jdbc.plugin.dev

Class DeveloperConnectionPlugin

java.lang.Object

software.amazon.jdbc.plugin.AbstractConnectionPlugin

software.amazon.jdbc.plugin.dev.DeveloperConnectionPlugin

All Implemented Interfaces:

ConnectionPlugin, ExceptionSimulator

public class DeveloperConnectionPlugin
extends AbstractConnectionPlugin
implements ExceptionSimulator

Constructor Summary

Constructors

Constructor and Description
DeveloperConnectionPlugin()

Method Summary

Modifier and Type	Method and Description
java.sql.Connection	connect(java.lang.String driverProtocol, HostSpec hostSpec, java.util.Properties props, boolean isInitialConnection, JdbcCallable<java.sql.Connection,java.sql.SQLException> connectFunc) Establishes a connection to the given host using the given driver protocol and properties.
<T,E extends java.lang.Exception> T	execute(java.lang.Class<T> resultClass, java.lang.Class<E> exceptionClass, java.lang.Object methodInvokeOn, java.lang.String methodName, JdbcCallable<T,E> jdbcMethodFunc, java.lang.Object[] jdbcMethodArgs)
java.sql.Connection	forceConnect(java.lang.String driverProtocol, HostSpec hostSpec, java.util.Properties props, boolean isInitialConnection, JdbcCallable<java.sql.Connection,java.sql.SQLException> forceConnectFunc) Establishes a connection to the given host using the given driver protocol and properties.
java.util.Set<java.lang.String>	getSubscribedMethods()
protected <E extends java.lang.Exception> void	raiseException(java.lang.Class<E> exceptionClass, java.lang.Throwable throwable, java.lang.String methodName)
protected <T,E extends java.lang.Exception> void	raiseExceptionIfNeeded(java.lang.Class<T> resultClass, java.lang.Class<E> exceptionClass, java.lang.String methodName, java.lang.Object[] jdbcMethodArgs)
protected void	raiseExceptionOnConnect(java.lang.Throwable throwable)
protected void	raiseExceptionOnConnectIfNeeded(java.lang.String driverProtocol, HostSpec hostSpec, java.util.Properties props, boolean isInitialConnection)
void	raiseExceptionOnNextCall(@NonNull java.lang.String methodName, java.lang.Throwable throwable)
void	raiseExceptionOnNextCall(java.lang.Throwable throwable)
void	setCallback(ExceptionSimulatorExecuteJdbcMethodCallback exceptionSimulatorExecuteJdbcMethodCallback)

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

acceptsStrategy, getHostSpecByStrategy, getHostSpecByStrategy, initHostProvider, notifyConnectionChanged, notifyNodeListChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

DeveloperConnectionPlugin

public DeveloperConnectionPlugin()

Method Detail

getSubscribedMethods

public java.util.Set<java.lang.String> getSubscribedMethods()

Specified by:

getSubscribedMethods in interface ConnectionPlugin

Specified by:

getSubscribedMethods in class AbstractConnectionPlugin

raiseExceptionOnNextCall

public void raiseExceptionOnNextCall(java.lang.Throwable throwable)

Specified by:

raiseExceptionOnNextCall in interface ExceptionSimulator

raiseExceptionOnNextCall

public void raiseExceptionOnNextCall(@NonNull java.lang.String methodName,
                                     java.lang.Throwable throwable)

Specified by:

raiseExceptionOnNextCall in interface ExceptionSimulator

setCallback

public void setCallback(ExceptionSimulatorExecuteJdbcMethodCallback exceptionSimulatorExecuteJdbcMethodCallback)

Specified by:

setCallback in interface ExceptionSimulator

execute

public <T,E extends java.lang.Exception> T execute(java.lang.Class<T> resultClass,
                                                   java.lang.Class<E> exceptionClass,
                                                   java.lang.Object methodInvokeOn,
                                                   java.lang.String methodName,
                                                   JdbcCallable<T,E> jdbcMethodFunc,
                                                   java.lang.Object[] jdbcMethodArgs)
                                            throws E extends java.lang.Exception

Specified by:

execute in interface ConnectionPlugin

Overrides:

execute in class AbstractConnectionPlugin

Throws:

E extends java.lang.Exception

raiseExceptionIfNeeded

protected <T,E extends java.lang.Exception> void raiseExceptionIfNeeded(java.lang.Class<T> resultClass,
                                                                        java.lang.Class<E> exceptionClass,
                                                                        java.lang.String methodName,
                                                                        java.lang.Object[] jdbcMethodArgs)
                                                                 throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

raiseException

protected <E extends java.lang.Exception> void raiseException(java.lang.Class<E> exceptionClass,
                                                              java.lang.Throwable throwable,
                                                              java.lang.String methodName)
                                                       throws E extends java.lang.Exception

Throws:

E extends java.lang.Exception

connect

public java.sql.Connection connect(java.lang.String driverProtocol,
                                   HostSpec hostSpec,
                                   java.util.Properties props,
                                   boolean isInitialConnection,
                                   JdbcCallable<java.sql.Connection,java.sql.SQLException> connectFunc)
                            throws java.sql.SQLException

Description copied from interface: ConnectionPlugin

Establishes a connection to the given host using the given driver protocol and properties. If a non-default ConnectionProvider has been set with Driver.setCustomConnectionProvider(ConnectionProvider) and ConnectionProvider.acceptsUrl(String, HostSpec, Properties) returns true for the given protocol, host, and properties, the connection will be created by the non-default ConnectionProvider. Otherwise, the connection will be created by the default ConnectionProvider. The default ConnectionProvider will be DriverConnectionProvider for connections requested via the DriverManager and DataSourceConnectionProvider for connections requested via an AwsWrapperDataSource.

Specified by:

connect in interface ConnectionPlugin

Overrides:

connect in class AbstractConnectionPlugin

Parameters:

driverProtocol - the driver protocol that should be used to establish the connection

hostSpec - the host details for the desired connection

props - the connection properties

isInitialConnection - a boolean indicating whether the current Connection is establishing an initial physical connection to the database or has already established a physical connection in the past

connectFunc - the function to call to continue the connect request down the connect pipeline

Returns:

a Connection to the requested host

Throws:

java.sql.SQLException - if there was an error establishing a Connection to the requested host

forceConnect

public java.sql.Connection forceConnect(java.lang.String driverProtocol,
                                        HostSpec hostSpec,
                                        java.util.Properties props,
                                        boolean isInitialConnection,
                                        JdbcCallable<java.sql.Connection,java.sql.SQLException> forceConnectFunc)
                                 throws java.sql.SQLException

Description copied from interface: ConnectionPlugin

Establishes a connection to the given host using the given driver protocol and properties. This call differs from ConnectionPlugin.connect(java.lang.String, software.amazon.jdbc.HostSpec, java.util.Properties, boolean, software.amazon.jdbc.JdbcCallable<java.sql.Connection, java.sql.SQLException>) in that the default ConnectionProvider will be used to establish the connection even if a non-default ConnectionProvider has been set via Driver.setCustomConnectionProvider(ConnectionProvider). The default ConnectionProvider will be DriverConnectionProvider for connections requested via the DriverManager and DataSourceConnectionProvider for connections requested via an AwsWrapperDataSource.

Specified by:

forceConnect in interface ConnectionPlugin

Overrides:

forceConnect in class AbstractConnectionPlugin

Parameters:

driverProtocol - the driver protocol that should be used to establish the connection

hostSpec - the host details for the desired connection

props - the connection properties

isInitialConnection - a boolean indicating whether the current Connection is establishing an initial physical connection to the database or has already established a physical connection in the past

forceConnectFunc - the function to call to continue the forceConnect request down the forceConnect pipeline

Returns:

a Connection to the requested host

Throws:

java.sql.SQLException - if there was an error establishing a Connection to the requested host

raiseExceptionOnConnectIfNeeded

protected void raiseExceptionOnConnectIfNeeded(java.lang.String driverProtocol,
                                               HostSpec hostSpec,
                                               java.util.Properties props,
                                               boolean isInitialConnection)
                                        throws java.sql.SQLException

Throws:

java.sql.SQLException

raiseExceptionOnConnect

protected void raiseExceptionOnConnect(java.lang.Throwable throwable)
                                throws java.sql.SQLException

Throws:

java.sql.SQLException