com.mysql.cj.jdbc.ha

Class ReplicationMySQLConnection

java.lang.Object

com.mysql.cj.jdbc.ha.MultiHostMySQLConnection

com.mysql.cj.jdbc.ha.ReplicationMySQLConnection

All Implemented Interfaces:

ReplicationConnection, JdbcConnection, MysqlConnection, TransactionEventHandler, java.lang.AutoCloseable, java.sql.Connection, java.sql.Wrapper

public class ReplicationMySQLConnection
extends MultiHostMySQLConnection
implements ReplicationConnection

Field Summary

Fields inherited from class com.mysql.cj.jdbc.ha.MultiHostMySQLConnection

thisAsProxy

Fields inherited from interface java.sql.Connection

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Constructor Summary

Constructors

Constructor and Description
ReplicationMySQLConnection(MultiHostConnectionProxy proxy)

Method Summary

Modifier and Type	Method and Description
void	abort(java.util.concurrent.Executor executor)
void	abortInternal() Clobbers the physical network connection and marks this connection as closed.
void	addReplicaHost(java.lang.String host)
void	changeUser(java.lang.String userName, java.lang.String newPassword) Changes the user on this connection by performing a re-authentication.
void	clearHasTriedMaster() Deprecated.
JdbcConnection	getActiveMySQLConnection()
long	getConnectionGroupId()
JdbcConnection	getCurrentConnection()
java.util.Properties	getProperties() Returns the parsed and passed in properties for this connection.
JdbcConnection	getReplicaConnection()
JdbcConnection	getSourceConnection()
ReplicationConnectionProxy	getThisAsProxy()
boolean	hasSameProperties(JdbcConnection c) Does this connection have the same properties as another?
boolean	isHostReplica(java.lang.String host)
boolean	isHostSource(java.lang.String host)
boolean	isReadOnly()
boolean	isWrapperFor(java.lang.Class<?> iface)
void	ping() Detect if the connection is still good by sending a ping command to the server.
void	promoteReplicaToSource(java.lang.String host)
void	removeReplica(java.lang.String host)
void	removeReplica(java.lang.String host, boolean closeGently)
void	removeSourceHost(java.lang.String host)
void	removeSourceHost(java.lang.String host, boolean waitUntilNotInUse)
void	setProxy(JdbcConnection proxy)
void	setReadOnly(boolean readOnlyFlag)
void	setStatementComment(java.lang.String comment) Sets the comment that will be prepended to all statements sent to the server.
<T> T	unwrap(java.lang.Class<T> iface)

Methods inherited from class com.mysql.cj.jdbc.ha.MultiHostMySQLConnection

checkClosed, cleanup, clearWarnings, clientPrepareStatement, clientPrepareStatement, clientPrepareStatement, clientPrepareStatement, clientPrepareStatement, clientPrepareStatement, close, commit, createArrayOf, createBlob, createClob, createNClob, createNewIO, createSQLXML, createStatement, createStatement, createStatement, createStruct, decachePreparedStatement, getActiveStatementCount, getAutoCommit, getAutoIncrementIncrement, getCachedMetaData, getCatalog, getCharacterSetMetadata, getClientInfo, getClientInfo, getClientInfoProviderImpl, getConnectionMutex, getDatabase, getExceptionInterceptor, getHoldability, getHost, getHostPortPair, getId, getIdleFor, getMetaData, getMetadataSafeStatement, getMultiHostParentProxy, getMultiHostSafeProxy, getNetworkTimeout, getPropertySet, getQueryInterceptorsInstances, getSchema, getServerSessionStateController, getServerVersion, getSession, getSessionMaxRows, getStatementComment, getTransactionIsolation, getTypeMap, getURL, getUser, getWarnings, hasTriedMaster, initializeResultsMetadataFromCache, initializeSafeQueryInterceptors, isClosed, isInGlobalTx, isInPreparedTx, isProxySet, isReadOnly, isSameResource, isServerLocal, isSourceConnection, isValid, lowerCaseTableNames, nativeSQL, normalClose, pingInternal, prepareCall, prepareCall, prepareCall, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, realClose, recachePreparedStatement, registerStatement, releaseSavepoint, resetServerState, rollback, rollback, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, setAutoCommit, setCatalog, setClientInfo, setClientInfo, setConnectionLifecycleInterceptor, setDatabase, setFailedOver, setHoldability, setInGlobalTx, setInPreparedTx, setNetworkTimeout, setReadOnlyInternal, setSavepoint, setSavepoint, setSchema, setSessionMaxRows, setTransactionIsolation, setTypeMap, shutdownServer, storesLowerCaseTableName, throwConnectionClosedException, transactionBegun, transactionCompleted, unregisterStatement, unSafeQueryInterceptors

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.mysql.cj.jdbc.ha.ReplicationConnection

addSlaveHost, getMasterConnection, getSlavesConnection, isHostMaster, isHostSlave, promoteSlaveToMaster, removeMasterHost, removeMasterHost, removeSlave, removeSlave

Methods inherited from interface com.mysql.cj.jdbc.JdbcConnection

clientPrepareStatement, clientPrepareStatement, clientPrepareStatement, clientPrepareStatement, clientPrepareStatement, clientPrepareStatement, decachePreparedStatement, getActiveStatementCount, getAutoIncrementIncrement, getCachedMetaData, getCharacterSetMetadata, getClientInfoProviderImpl, getDatabase, getHost, getHostPortPair, getIdleFor, getMetadataSafeStatement, getMultiHostParentProxy, getMultiHostSafeProxy, getPropertySet, getQueryInterceptorsInstances, getServerVersion, getSessionMaxRows, getStatementComment, hasTriedMaster, initializeResultsMetadataFromCache, initializeSafeQueryInterceptors, isInGlobalTx, isInPreparedTx, isMasterConnection, isProxySet, isReadOnly, isSameResource, isServerLocal, isSourceConnection, lowerCaseTableNames, pingInternal, realClose, recachePreparedStatement, registerStatement, resetServerState, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, setConnectionLifecycleInterceptor, setDatabase, setFailedOver, setInGlobalTx, setInPreparedTx, setReadOnlyInternal, setSessionMaxRows, shutdownServer, storesLowerCaseTableName, throwConnectionClosedException, unregisterStatement, unSafeQueryInterceptors

Methods inherited from interface java.sql.Connection

clearWarnings, close, commit, createArrayOf, createBlob, createClob, createNClob, createSQLXML, createStatement, createStatement, createStatement, createStruct, getAutoCommit, getCatalog, getClientInfo, getClientInfo, getHoldability, getMetaData, getNetworkTimeout, getSchema, getTransactionIsolation, getTypeMap, getWarnings, isClosed, isValid, nativeSQL, prepareCall, prepareCall, prepareCall, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, prepareStatement, releaseSavepoint, rollback, rollback, setAutoCommit, setCatalog, setClientInfo, setClientInfo, setHoldability, setNetworkTimeout, setSavepoint, setSavepoint, setSchema, setTransactionIsolation, setTypeMap

Methods inherited from interface com.mysql.cj.MysqlConnection

checkClosed, cleanup, createNewIO, getConnectionMutex, getExceptionInterceptor, getId, getServerSessionStateController, getSession, getURL, getUser, normalClose

Methods inherited from interface com.mysql.cj.TransactionEventHandler

transactionBegun, transactionCompleted

Constructor Detail

ReplicationMySQLConnection

public ReplicationMySQLConnection(MultiHostConnectionProxy proxy)

Method Detail

getThisAsProxy

public ReplicationConnectionProxy getThisAsProxy()

Overrides:

getThisAsProxy in class MultiHostMySQLConnection

getActiveMySQLConnection

public JdbcConnection getActiveMySQLConnection()

Specified by:

getActiveMySQLConnection in interface JdbcConnection

Overrides:

getActiveMySQLConnection in class MultiHostMySQLConnection

getCurrentConnection

public JdbcConnection getCurrentConnection()

Specified by:

getCurrentConnection in interface ReplicationConnection

getConnectionGroupId

public long getConnectionGroupId()

Specified by:

getConnectionGroupId in interface ReplicationConnection

getSourceConnection

public JdbcConnection getSourceConnection()

Specified by:

getSourceConnection in interface ReplicationConnection

promoteReplicaToSource

public void promoteReplicaToSource(java.lang.String host)
                            throws java.sql.SQLException

Specified by:

promoteReplicaToSource in interface ReplicationConnection

Throws:

java.sql.SQLException

removeSourceHost

public void removeSourceHost(java.lang.String host)
                      throws java.sql.SQLException

Specified by:

removeSourceHost in interface ReplicationConnection

Throws:

java.sql.SQLException

removeSourceHost

public void removeSourceHost(java.lang.String host,
                             boolean waitUntilNotInUse)
                      throws java.sql.SQLException

Specified by:

removeSourceHost in interface ReplicationConnection

Throws:

java.sql.SQLException

isHostSource

public boolean isHostSource(java.lang.String host)

Specified by:

isHostSource in interface ReplicationConnection

getReplicaConnection

public JdbcConnection getReplicaConnection()

Specified by:

getReplicaConnection in interface ReplicationConnection

addReplicaHost

public void addReplicaHost(java.lang.String host)
                    throws java.sql.SQLException

Specified by:

addReplicaHost in interface ReplicationConnection

Throws:

java.sql.SQLException

removeReplica

public void removeReplica(java.lang.String host)
                   throws java.sql.SQLException

Specified by:

removeReplica in interface ReplicationConnection

Throws:

java.sql.SQLException

removeReplica

public void removeReplica(java.lang.String host,
                          boolean closeGently)
                   throws java.sql.SQLException

Specified by:

removeReplica in interface ReplicationConnection

Throws:

java.sql.SQLException

isHostReplica

public boolean isHostReplica(java.lang.String host)

Specified by:

isHostReplica in interface ReplicationConnection

setReadOnly

public void setReadOnly(boolean readOnlyFlag)
                 throws java.sql.SQLException

Specified by:

setReadOnly in interface java.sql.Connection

Overrides:

setReadOnly in class MultiHostMySQLConnection

Throws:

java.sql.SQLException

isReadOnly

public boolean isReadOnly()
                   throws java.sql.SQLException

Specified by:

isReadOnly in interface java.sql.Connection

Overrides:

isReadOnly in class MultiHostMySQLConnection

Throws:

java.sql.SQLException

ping

public void ping()
          throws java.sql.SQLException

Description copied from interface: JdbcConnection

Detect if the connection is still good by sending a ping command to the server.

Specified by:

ping in interface JdbcConnection

Overrides:

ping in class MultiHostMySQLConnection

Throws:

java.sql.SQLException - if the ping fails

changeUser

public void changeUser(java.lang.String userName,
                       java.lang.String newPassword)
                throws java.sql.SQLException

Description copied from interface: JdbcConnection

Changes the user on this connection by performing a re-authentication. If authentication fails, the connection is failed.

Specified by:

changeUser in interface JdbcConnection

Overrides:

changeUser in class MultiHostMySQLConnection

Parameters:

userName - the username to authenticate with

newPassword - the password to authenticate with

Throws:

java.sql.SQLException - if authentication fails, or some other error occurs while performing the command.

setStatementComment

public void setStatementComment(java.lang.String comment)

Description copied from interface: JdbcConnection

Sets the comment that will be prepended to all statements sent to the server. Do not use slash-star or star-slash tokens in the comment as these will be added by the driver itself.

Specified by:

setStatementComment in interface JdbcConnection

Overrides:

setStatementComment in class MultiHostMySQLConnection

Parameters:

comment - the comment that will be prepended to all statements sent to the server.

hasSameProperties

public boolean hasSameProperties(JdbcConnection c)

Description copied from interface: JdbcConnection

Does this connection have the same properties as another?

Specified by:

hasSameProperties in interface JdbcConnection

Overrides:

hasSameProperties in class MultiHostMySQLConnection

Parameters:

c - connection

Returns:

true if has the same properties

getProperties

public java.util.Properties getProperties()

Description copied from interface: MysqlConnection

Returns the parsed and passed in properties for this connection.

Specified by:

getProperties in interface MysqlConnection

Overrides:

getProperties in class MultiHostMySQLConnection

Returns:

Properties

abort

public void abort(java.util.concurrent.Executor executor)
           throws java.sql.SQLException

Specified by:

abort in interface java.sql.Connection

Overrides:

abort in class MultiHostMySQLConnection

Throws:

java.sql.SQLException

abortInternal

public void abortInternal()
                   throws java.sql.SQLException

Description copied from interface: JdbcConnection

Clobbers the physical network connection and marks this connection as closed.

Specified by:

abortInternal in interface JdbcConnection

Overrides:

abortInternal in class MultiHostMySQLConnection

Throws:

java.sql.SQLException - if an error occurs

setProxy

public void setProxy(JdbcConnection proxy)

Specified by:

setProxy in interface JdbcConnection

Overrides:

setProxy in class MultiHostMySQLConnection

isWrapperFor

public boolean isWrapperFor(java.lang.Class<?> iface)
                     throws java.sql.SQLException

Specified by:

isWrapperFor in interface java.sql.Wrapper

Overrides:

isWrapperFor in class MultiHostMySQLConnection

Throws:

java.sql.SQLException

unwrap

public <T> T unwrap(java.lang.Class<T> iface)
             throws java.sql.SQLException

Specified by:

unwrap in interface java.sql.Wrapper

Overrides:

unwrap in class MultiHostMySQLConnection

Throws:

java.sql.SQLException

clearHasTriedMaster

@Deprecated
public void clearHasTriedMaster()

Deprecated.

Specified by:

clearHasTriedMaster in interface JdbcConnection

Overrides:

clearHasTriedMaster in class MultiHostMySQLConnection