com.mysql.cj.jdbc.ha

Class ConnectionProxy

java.lang.Object

com.mysql.cj.jdbc.ha.ConnectionProxy

All Implemented Interfaces:

ICurrentConnectionProvider, java.lang.reflect.InvocationHandler

public class ConnectionProxy
extends java.lang.Object
implements ICurrentConnectionProvider, java.lang.reflect.InvocationHandler

A proxy that uses the ConnectionPluginManager to initialize JdbcConnection and execute JDBC methods.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.String,java.lang.String>	initialConnectionProps
protected Log	log The logger we're going to use.
protected static Log	NULL_LOGGER Null logger shared by all connections at startup.
protected ConnectionPluginManager	pluginManager

Constructor Summary

Constructors

Constructor and Description
ConnectionProxy(ConnectionUrl connectionUrl)
ConnectionProxy(ConnectionUrl connectionUrl, JdbcConnection connection) Instantiates a new AuroraConnectionProxy for the given list of hosts and connection properties.

Method Summary

Modifier and Type	Method and Description
static JdbcConnection	autodetectClusterAndCreateProxyInstance(ConnectionUrl connectionUrl) Checks if connection is associated with Aurora cluster and instantiates a new AuroraConnectionProxy if needed.
static JdbcConnection	createProxyInstance(ConnectionUrl connectionUrl) Instantiates a new ConnectionProxy.
JdbcConnection	getCurrentConnection()
HostInfo	getCurrentHostInfo()
protected java.lang.reflect.InvocationHandler	getNewJdbcInterfaceProxy(java.lang.Object toProxy)
protected void	initLogger(ConnectionUrl connUrl)
protected void	initPluginManager(java.util.function.Function<Log,ConnectionPluginManager> connectionPluginManagerInitializer, ConnectionUrl connectionUrl)
protected void	initSettings(ConnectionUrl connectionUrl)
java.lang.Object	invoke(java.lang.Object proxy, java.lang.reflect.Method method, java.lang.Object[] args)
protected java.lang.Object	proxyIfReturnTypeIsJdbcInterface(java.lang.Class<?> returnType, java.lang.Object toProxy) If the given return type is or implements a JDBC interface, proxies the given object so that we can catch SQL errors and fire a connection switch.
void	setCurrentConnection(JdbcConnection connection, HostInfo info)

Methods inherited from class java.lang.Object

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

Field Detail

NULL_LOGGER

protected static final Log NULL_LOGGER

Null logger shared by all connections at startup.

log

protected transient Log log

The logger we're going to use.

initialConnectionProps

protected java.util.Map<java.lang.String,java.lang.String> initialConnectionProps

pluginManager

protected ConnectionPluginManager pluginManager

Constructor Detail

ConnectionProxy

public ConnectionProxy(ConnectionUrl connectionUrl)
                throws java.sql.SQLException

Throws:

java.sql.SQLException

ConnectionProxy

public ConnectionProxy(ConnectionUrl connectionUrl,
                       JdbcConnection connection)
                throws java.sql.SQLException

Instantiates a new AuroraConnectionProxy for the given list of hosts and connection properties.

Parameters:

connectionUrl - ConnectionUrl instance containing the lists of hosts available to switch on.

connection - JdbcConnection

Throws:

java.sql.SQLException - if an error occurs

Method Detail

autodetectClusterAndCreateProxyInstance

public static JdbcConnection autodetectClusterAndCreateProxyInstance(ConnectionUrl connectionUrl)
                                                              throws java.sql.SQLException

Checks if connection is associated with Aurora cluster and instantiates a new AuroraConnectionProxy if needed. Otherwise it returns a single-host connection.

Parameters:

connectionUrl - ConnectionUrl instance containing the lists of hosts available to switch on.

Throws:

java.sql.SQLException - if an error occurs

createProxyInstance

public static JdbcConnection createProxyInstance(ConnectionUrl connectionUrl)
                                          throws java.sql.SQLException

Instantiates a new ConnectionProxy.

Parameters:

connectionUrl - ConnectionUrl instance containing the lists of hosts available to switch on.

Throws:

java.sql.SQLException - if an error occurs

getCurrentConnection

public JdbcConnection getCurrentConnection()

Specified by:

getCurrentConnection in interface ICurrentConnectionProvider

getCurrentHostInfo

public HostInfo getCurrentHostInfo()

Specified by:

getCurrentHostInfo in interface ICurrentConnectionProvider

setCurrentConnection

public void setCurrentConnection(JdbcConnection connection,
                                 HostInfo info)

Specified by:

setCurrentConnection in interface ICurrentConnectionProvider

invoke

public java.lang.Object invoke(java.lang.Object proxy,
                               java.lang.reflect.Method method,
                               java.lang.Object[] args)
                        throws java.lang.Throwable

Specified by:

invoke in interface java.lang.reflect.InvocationHandler

Throws:

java.lang.Throwable

getNewJdbcInterfaceProxy

protected java.lang.reflect.InvocationHandler getNewJdbcInterfaceProxy(java.lang.Object toProxy)

initLogger

protected void initLogger(ConnectionUrl connUrl)

initSettings

protected void initSettings(ConnectionUrl connectionUrl)
                     throws java.sql.SQLException

Throws:

java.sql.SQLException

proxyIfReturnTypeIsJdbcInterface

protected java.lang.Object proxyIfReturnTypeIsJdbcInterface(java.lang.Class<?> returnType,
                                                            java.lang.Object toProxy)

If the given return type is or implements a JDBC interface, proxies the given object so that we can catch SQL errors and fire a connection switch.

Parameters:

returnType - The type the object instance to proxy is supposed to be.

toProxy - The object instance to proxy.

Returns:

The proxied object or the original one if it does not implement a JDBC interface.

initPluginManager

protected void initPluginManager(java.util.function.Function<Log,ConnectionPluginManager> connectionPluginManagerInitializer,
                                 ConnectionUrl connectionUrl)
                          throws java.sql.SQLException

Throws:

java.sql.SQLException