シーケンス
本稿では、MasterSlaveRouterのシャーディング-JDBCを見ます
MasterSlaveRouter
インキュベーター-shardingsphere-4.0.0-RC1 /シャーディング・コア/シャーディング・コア・ルーティング/ srcに/メイン/ javaの/組織/ apacheの/ shardingsphere /コア/ルート/ルーター/ masterslave / MasterSlaveRouter.java
@RequiredArgsConstructor
public final class MasterSlaveRouter {
private final MasterSlaveRule masterSlaveRule;
private final boolean showSQL;
/**
* Route Master slave.
*
* @param sql SQL
* @return data source names
*/
// TODO for multiple masters may return more than one data source
public Collection<String> route(final String sql) {
Collection<String> result = route(new SQLJudgeEngine(sql).judge().getType());
if (showSQL) {
SQLLogger.logSQL(sql, result);
}
return result;
}
private Collection<String> route(final SQLType sqlType) {
if (isMasterRoute(sqlType)) {
MasterVisitedManager.setMasterVisited();
return Collections.singletonList(masterSlaveRule.getMasterDataSourceName());
}
return Collections.singletonList(masterSlaveRule.getLoadBalanceAlgorithm().getDataSource(
masterSlaveRule.getName(), masterSlaveRule.getMasterDataSourceName(), new ArrayList<>(masterSlaveRule.getSlaveDataSourceNames())));
}
private boolean isMasterRoute(final SQLType sqlType) {
return SQLType.DQL != sqlType || MasterVisitedManager.isMasterVisited() || HintManager.isMasterRouteOnly();
}
}
复制代码
- masterSlaveRuleを使用してルーティング方法にMasterSlaveRouter経路
MasterSlaveRule
インキュベーター-shardingsphere-4.0.0-RC1 /シャーディング・コア/シャーディング・コア共通/ srcに/メイン/ javaの/組織/ apacheの/ shardingsphere /コア/ルール/ MasterSlaveRule.java
@Getter
public class MasterSlaveRule {
private final String name;
private final String masterDataSourceName;
private final Collection<String> slaveDataSourceNames;
private final MasterSlaveLoadBalanceAlgorithm loadBalanceAlgorithm;
private final MasterSlaveRuleConfiguration masterSlaveRuleConfiguration;
public MasterSlaveRule(final String name, final String masterDataSourceName, final Collection<String> slaveDataSourceNames, final MasterSlaveLoadBalanceAlgorithm loadBalanceAlgorithm) {
this.name = name;
this.masterDataSourceName = masterDataSourceName;
this.slaveDataSourceNames = slaveDataSourceNames;
this.loadBalanceAlgorithm = null == loadBalanceAlgorithm ? new MasterSlaveLoadBalanceAlgorithmServiceLoader().newService() : loadBalanceAlgorithm;
masterSlaveRuleConfiguration = new MasterSlaveRuleConfiguration(name, masterDataSourceName, slaveDataSourceNames,
new LoadBalanceStrategyConfiguration(this.loadBalanceAlgorithm.getType(), this.loadBalanceAlgorithm.getProperties()));
}
public MasterSlaveRule(final MasterSlaveRuleConfiguration config) {
name = config.getName();
masterDataSourceName = config.getMasterDataSourceName();
slaveDataSourceNames = config.getSlaveDataSourceNames();
loadBalanceAlgorithm = createMasterSlaveLoadBalanceAlgorithm(config.getLoadBalanceStrategyConfiguration());
masterSlaveRuleConfiguration = config;
}
private MasterSlaveLoadBalanceAlgorithm createMasterSlaveLoadBalanceAlgorithm(final LoadBalanceStrategyConfiguration loadBalanceStrategyConfiguration) {
MasterSlaveLoadBalanceAlgorithmServiceLoader serviceLoader = new MasterSlaveLoadBalanceAlgorithmServiceLoader();
return null == loadBalanceStrategyConfiguration ? serviceLoader.newService() : serviceLoader.newService(loadBalanceStrategyConfiguration.getType(), loadBalanceStrategyConfiguration.getProperties());
}
/**
* Judge whether contain data source name.
*
* @param dataSourceName data source name
* @return contain or not.
*/
public boolean containDataSourceName(final String dataSourceName) {
return masterDataSourceName.equals(dataSourceName) || slaveDataSourceNames.contains(dataSourceName);
}
}
复制代码
- loadBalanceAlgorithm、masterSlaveRuleConfiguration建てMasterSlaveRule
MasterSlaveLoadBalanceAlgorithm
インキュベーター-shardingsphere-4.0.0-RC1 /シャーディングコア/シャーディングコア-API / SRC /メイン/ジャワ/ ORG /アパッチ/ shardingsphere / SPI / masterslave / MasterSlaveLoadBalanceAlgorithm.java
public interface MasterSlaveLoadBalanceAlgorithm extends TypeBasedSPI {
/**
* Get data source.
*
* @param name master-slave logic data source name
* @param masterDataSourceName name of master data sources
* @param slaveDataSourceNames names of slave data sources
* @return name of selected data source
*/
String getDataSource(String name, String masterDataSourceName, List<String> slaveDataSourceNames);
}
复制代码
- MasterSlaveLoadBalanceAlgorithm TypeBasedSPIインタフェースは、をgetDataSourceの方法を定義するインタフェースを拡張し、2つのクラスがRandomMasterSlaveLoadBalanceAlgorithm、RoundRobinMasterSlaveLoadBalanceAlgorithmを実装あり
RandomMasterSlaveLoadBalanceAlgorithm
インキュベーター-shardingsphere-4.0.0-RC1 /シャーディング・コア/シャーディング・コア共通/ srcに/メイン/ javaの/組織/ apacheの/ shardingsphere /コア/戦略/ masterslave / RandomMasterSlaveLoadBalanceAlgorithm.java
@Getter
@Setter
public final class RandomMasterSlaveLoadBalanceAlgorithm implements MasterSlaveLoadBalanceAlgorithm {
private Properties properties = new Properties();
@Override
public String getType() {
return "RANDOM";
}
@Override
public String getDataSource(final String name, final String masterDataSourceName, final List<String> slaveDataSourceNames) {
return slaveDataSourceNames.get(new Random().nextInt(slaveDataSourceNames.size()));
}
}
复制代码
- ランダムを使用してRandomMasterSlaveLoadBalanceAlgorithm()。ランダムにNextInt
RoundRobinMasterSlaveLoadBalanceAlgorithm
インキュベーター-shardingsphere-4.0.0-RC1 /シャーディング・コア/シャーディング・コア共通/ srcに/メイン/ javaの/組織/ apacheの/ shardingsphere /コア/戦略/ masterslave / RoundRobinMasterSlaveLoadBalanceAlgorithm.java
@Getter
@Setter
public final class RoundRobinMasterSlaveLoadBalanceAlgorithm implements MasterSlaveLoadBalanceAlgorithm {
private static final ConcurrentHashMap<String, AtomicInteger> COUNTS = new ConcurrentHashMap<>();
private Properties properties = new Properties();
@Override
public String getType() {
return "ROUND_ROBIN";
}
@Override
public String getDataSource(final String name, final String masterDataSourceName, final List<String> slaveDataSourceNames) {
AtomicInteger count = COUNTS.containsKey(name) ? COUNTS.get(name) : new AtomicInteger(0);
COUNTS.putIfAbsent(name, count);
count.compareAndSet(slaveDataSourceNames.size(), 0);
return slaveDataSourceNames.get(Math.abs(count.getAndIncrement()) % slaveDataSourceNames.size());
}
}
复制代码
- RoundRobinMasterSlaveLoadBalanceAlgorithmの使用は
Math.abs(count.getAndIncrement()) % slaveDataSourceNames.size()
、ラウンドロビンを行い、
MasterSlaveRuleConfiguration
インキュベーター-shardingsphere-4.0.0-RC1 /シャーディングコア/シャーディングコア-API / SRC /メイン/ジャワ/ ORG /アパッチ/ shardingsphere / API /設定/ masterslave / MasterSlaveRuleConfiguration.java
@Getter
public class MasterSlaveRuleConfiguration implements RuleConfiguration {
private final String name;
private final String masterDataSourceName;
private final Collection<String> slaveDataSourceNames;
private final LoadBalanceStrategyConfiguration loadBalanceStrategyConfiguration;
public MasterSlaveRuleConfiguration(final String name, final String masterDataSourceName, final Collection<String> slaveDataSourceNames) {
this(name, masterDataSourceName, slaveDataSourceNames, null);
}
public MasterSlaveRuleConfiguration(final String name,
final String masterDataSourceName, final Collection<String> slaveDataSourceNames, final LoadBalanceStrategyConfiguration loadBalanceStrategyConfiguration) {
Preconditions.checkArgument(!Strings.isNullOrEmpty(name), "Name is required.");
Preconditions.checkArgument(!Strings.isNullOrEmpty(masterDataSourceName), "MasterDataSourceName is required.");
Preconditions.checkArgument(null != slaveDataSourceNames && !slaveDataSourceNames.isEmpty(), "SlaveDataSourceNames is required.");
this.name = name;
this.masterDataSourceName = masterDataSourceName;
this.slaveDataSourceNames = slaveDataSourceNames;
this.loadBalanceStrategyConfiguration = loadBalanceStrategyConfiguration;
}
}
复制代码
- MasterSlaveRuleConfigurationはmasterDataSourceName、slaveDataSourceNames、loadBalanceStrategyConfigurationプロパティ、名前を定義します
概要
ルーティングのための方法masterSlaveRule MasterSlaveRouter経路、2つのクラスがRandomMasterSlaveLoadBalanceAlgorithm、RoundRobinMasterSlaveLoadBalanceAlgorithmを実装あり; MasterSlaveLoadBalanceAlgorithm TypeBasedSPIインターフェイスはをgetDataSourceの方法を定義するインタフェースを拡張; MasterSlaveRuleはloadBalanceAlgorithm、masterSlaveRuleConfigurationを建て