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	addSlaveHost(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()
JdbcConnection	getMasterConnection()
java.util.Properties	getProperties() Returns the parsed and passed in properties for this connection.
JdbcConnection	getSlavesConnection()
ReplicationConnectionProxy	getThisAsProxy()
boolean	hasSameProperties(JdbcConnection c) Does this connection have the same properties as another?
boolean	isHostMaster(java.lang.String host)
boolean	isHostSlave(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	promoteSlaveToMaster(java.lang.String host)
void	removeMasterHost(java.lang.String host)
void	removeMasterHost(java.lang.String host, boolean waitUntilNotInUse)
void	removeSlave(java.lang.String host)
void	removeSlave(java.lang.String host, boolean closeGently)
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, getServerVersion, getSession, getSessionMaxRows, getStatementComment, getTransactionIsolation, getTypeMap, getURL, getUser, getWarnings, hasTriedMaster, initializeResultsMetadataFromCache, initializeSafeQueryInterceptors, isClosed, isInGlobalTx, isMasterConnection, isProxySet, isReadOnly, isSameResource, isServerLocal, 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, setDatabase, setFailedOver, setHoldability, setInGlobalTx, 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.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, isMasterConnection, isProxySet, isReadOnly, isSameResource, isServerLocal, lowerCaseTableNames, pingInternal, realClose, recachePreparedStatement, registerStatement, resetServerState, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, serverPrepareStatement, setDatabase, setFailedOver, setInGlobalTx, 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, 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

getMasterConnection

public JdbcConnection getMasterConnection()

Specified by:

getMasterConnection in interface ReplicationConnection

promoteSlaveToMaster

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

Specified by:

promoteSlaveToMaster in interface ReplicationConnection

Throws:

java.sql.SQLException

removeMasterHost

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

Specified by:

removeMasterHost in interface ReplicationConnection

Throws:

java.sql.SQLException

removeMasterHost

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

Specified by:

removeMasterHost in interface ReplicationConnection

Throws:

java.sql.SQLException

isHostMaster

public boolean isHostMaster(java.lang.String host)

Specified by:

isHostMaster in interface ReplicationConnection

getSlavesConnection

public JdbcConnection getSlavesConnection()

Specified by:

getSlavesConnection in interface ReplicationConnection

addSlaveHost

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

Specified by:

addSlaveHost in interface ReplicationConnection

Throws:

java.sql.SQLException

removeSlave

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

Specified by:

removeSlave in interface ReplicationConnection

Throws:

java.sql.SQLException

removeSlave

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

Specified by:

removeSlave in interface ReplicationConnection

Throws:

java.sql.SQLException

isHostSlave

public boolean isHostSlave(java.lang.String host)

Specified by:

isHostSlave 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