程序包 com.mysql.cj.jdbc.ha

类 ReplicationConnectionProxy

java.lang.Object

com.mysql.cj.jdbc.ha.MultiHostConnectionProxy

com.mysql.cj.jdbc.ha.ReplicationConnectionProxy

所有已实现的接口:

PingTarget, InvocationHandler

public class ReplicationConnectionProxy
extends MultiHostConnectionProxy
implements PingTarget

Connection that opens two connections, one two a replication source, and another to one or more replicas, and decides to use source when the connection is not read-only, and use replica(s) when the connection is read-only.

字段概要

字段

修饰符和类型	字段	说明
protected boolean	allowReplicaDownConnections
protected boolean	allowSourceDownConnections
protected boolean	enableJMX
protected boolean	readFromSourceWhenNoReplicas
protected boolean	readFromSourceWhenNoReplicasOriginal
protected boolean	readOnly
protected LoadBalancedConnection	replicasConnection
protected LoadBalancedConnection	sourceConnection

从类继承的字段 com.mysql.cj.jdbc.ha.MultiHostConnectionProxy

connectionUrl, lastExceptionDealtWith

方法概要

修饰符和类型	方法	说明
void	addReplicaHost(String hostPortPair)
void	addSlaveHost(String hostPortPair)	已过时。
static ReplicationConnection	createProxyInstance(ConnectionUrl connectionUrl)	Static factory to create ReplicationConnection instances.
void	doPing()	Pings both l/b connections.
long	getConnectionGroupId()
JdbcConnection	getCurrentConnection()
JdbcConnection	getMasterConnection()	已过时。
JdbcConnection	getReplicasConnection()
JdbcConnection	getSlavesConnection()	已过时。
JdbcConnection	getSourceConnection()
boolean	isHostMaster(String hostPortPair)	已过时。
boolean	isHostReplica(String hostPortPair)
boolean	isHostSlave(String hostPortPair)	已过时。
boolean	isHostSource(String hostPortPair)
boolean	isReadOnly()
boolean	isReplicasConnection()	Checks if current connection is the replicas l/b connection.
boolean	isSlavesConnection()	已过时。
boolean	isSourceConnection()	Checks if current connection is the sources l/b connection.
void	promoteReplicaToSource(String hostPortPair)
void	promoteSlaveToMaster(String hostPortPair)	已过时。
protected void	propagateProxyDown(JdbcConnection proxyConn)	Propagates the connection proxy down through all live connections.
void	removeMasterHost(String hostPortPair)	已过时。
void	removeMasterHost(String hostPortPair, boolean waitUntilNotInUse)	已过时。
void	removeMasterHost(String hostPortPair, boolean waitUntilNotInUse, boolean isNowReplica)	已过时。
void	removeReplica(String hostPortPair)
void	removeReplica(String hostPortPair, boolean closeGently)
void	removeSlave(String hostPortPair)	已过时。
void	removeSlave(String hostPortPair, boolean closeGently)	已过时。
void	removeSourceHost(String hostPortPair)
void	removeSourceHost(String hostPortPair, boolean waitUntilNotInUse)
void	removeSourceHost(String hostPortPair, boolean waitUntilNotInUse, boolean isNowReplica)
void	setReadOnly(boolean readOnly)

从类继承的方法 com.mysql.cj.jdbc.ha.MultiHostConnectionProxy

allowedOnClosedConnection, getParentProxy, getProxy, invoke, setProxy

从类继承的方法 java.lang.Object

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

字段详细资料

enableJMX

protected boolean enableJMX

allowSourceDownConnections

protected boolean allowSourceDownConnections

allowReplicaDownConnections

protected boolean allowReplicaDownConnections

readFromSourceWhenNoReplicas

protected boolean readFromSourceWhenNoReplicas

readFromSourceWhenNoReplicasOriginal

protected boolean readFromSourceWhenNoReplicasOriginal

readOnly

protected boolean readOnly

sourceConnection

protected LoadBalancedConnection sourceConnection

replicasConnection

protected LoadBalancedConnection replicasConnection

方法详细资料

createProxyInstance

public static ReplicationConnection createProxyInstance(ConnectionUrl connectionUrl)
                                                 throws SQLException

Static factory to create ReplicationConnection instances.

参数:

connectionUrl - The connection URL containing the hosts in a replication setup.

返回:

A ReplicationConnection proxy.

抛出:

SQLException - if an error occurs

propagateProxyDown

protected void propagateProxyDown(JdbcConnection proxyConn)

Propagates the connection proxy down through all live connections.

覆盖:

propagateProxyDown 在类中 MultiHostConnectionProxy

参数:

proxyConn - The top level connection in the multi-host connections chain.

isSourceConnection

public boolean isSourceConnection()

Checks if current connection is the sources l/b connection.

isReplicasConnection

public boolean isReplicasConnection()

Checks if current connection is the replicas l/b connection.

返回:

true if current connection is the replicas l/b connection

isSlavesConnection

@Deprecated
public boolean isSlavesConnection()

已过时。

Use isReplicasConnection() instead.

返回:

true if it's a replicas connection

doPing

public void doPing()
            throws SQLException

Pings both l/b connections. Switch to another connection in case of failure.

指定者:

doPing 在接口中 PingTarget

抛出:

SQLException

getCurrentConnection

public JdbcConnection getCurrentConnection()

getConnectionGroupId

public long getConnectionGroupId()

getSourceConnection

public JdbcConnection getSourceConnection()

getMasterConnection

@Deprecated
public JdbcConnection getMasterConnection()

已过时。

Use getSourceConnection() instead.

返回:

JdbcConnection

promoteReplicaToSource

public void promoteReplicaToSource(String hostPortPair)
                            throws SQLException

抛出:

SQLException

promoteSlaveToMaster

@Deprecated
public void promoteSlaveToMaster(String hostPortPair)
                          throws SQLException

已过时。

Use promoteReplicaToSource(String) instead.

参数:

hostPortPair - host:port

抛出:

SQLException

removeSourceHost

public void removeSourceHost(String hostPortPair)
                      throws SQLException

抛出:

SQLException

removeMasterHost

@Deprecated
public void removeMasterHost(String hostPortPair)
                      throws SQLException

已过时。

Use removeSourceHost(String) instead.

参数:

hostPortPair - host:port

抛出:

SQLException

removeSourceHost

public void removeSourceHost(String hostPortPair,
                             boolean waitUntilNotInUse)
                      throws SQLException

抛出:

SQLException

removeMasterHost

@Deprecated
public void removeMasterHost(String hostPortPair,
                             boolean waitUntilNotInUse)
                      throws SQLException

已过时。

Use removeSourceHost(String, boolean) instead.

参数:

hostPortPair - host:port

waitUntilNotInUse - remove only when not in use

抛出:

SQLException

removeSourceHost

public void removeSourceHost(String hostPortPair,
                             boolean waitUntilNotInUse,
                             boolean isNowReplica)
                      throws SQLException

抛出:

SQLException

removeMasterHost

@Deprecated
public void removeMasterHost(String hostPortPair,
                             boolean waitUntilNotInUse,
                             boolean isNowReplica)
                      throws SQLException

已过时。

Use removeSourceHost(String, boolean, boolean) instead.

参数:

hostPortPair - host:port

waitUntilNotInUse - remove only when not in use

isNowReplica - place to replicas

抛出:

SQLException

isHostSource

public boolean isHostSource(String hostPortPair)

isHostMaster

@Deprecated
public boolean isHostMaster(String hostPortPair)

已过时。

Use isHostSource(String) instead.

参数:

hostPortPair - host:port

返回:

true if it's a source host

getReplicasConnection

public JdbcConnection getReplicasConnection()

getSlavesConnection

@Deprecated
public JdbcConnection getSlavesConnection()

已过时。

Use getReplicasConnection() instead.

返回:

JdbcConnection

addReplicaHost

public void addReplicaHost(String hostPortPair)
                    throws SQLException

抛出:

SQLException

addSlaveHost

@Deprecated
public void addSlaveHost(String hostPortPair)
                  throws SQLException

已过时。

Use addReplicaHost(String) instead.

参数:

hostPortPair - host:port

抛出:

SQLException

removeReplica

public void removeReplica(String hostPortPair)
                   throws SQLException

抛出:

SQLException

removeSlave

@Deprecated
public void removeSlave(String hostPortPair)
                 throws SQLException

已过时。

Use removeReplica(String) instead.

参数:

hostPortPair - host:port

抛出:

SQLException

removeReplica

public void removeReplica(String hostPortPair,
                          boolean closeGently)
                   throws SQLException

抛出:

SQLException

removeSlave

@Deprecated
public void removeSlave(String hostPortPair,
                        boolean closeGently)
                 throws SQLException

已过时。

Use removeReplica(String, boolean) instead.

参数:

hostPortPair - host:port

closeGently - option

抛出:

SQLException

isHostReplica

public boolean isHostReplica(String hostPortPair)

isHostSlave

@Deprecated
public boolean isHostSlave(String hostPortPair)

已过时。

Use isHostReplica(String) instead.

参数:

hostPortPair - host:port

返回:

true if it's a replica

setReadOnly

public void setReadOnly(boolean readOnly)
                 throws SQLException

抛出:

SQLException

isReadOnly

public boolean isReadOnly()
                   throws SQLException

抛出:

SQLException