路由组件构建方案(分库分表)V1

最新推荐文章于 2025-09-13 08:16:27 发布

转载最新推荐文章于 2025-09-13 08:16:27 发布 · 298 阅读

0 ·

CC 4.0 BY-SA版权

原文链接：https://www.cnblogs.com/xbhog/p/16808738.html

文章标签：

#mybatis #java #spring boot

本文详细介绍了如何利用Java注解动态切换数据源，并结合MyBatis拦截器实现分库分表操作。首先，通过配置文件设置多个数据源，然后在启动时加载配置信息，利用`EnvironmentAware`接口获取数据源配置。接着，通过`AbstractRoutingDataSource`实现数据源的动态切换，自定义`DataSource`的`lookupKey`以确定当前数据源。此外，还介绍了自定义切点和拦截器，通过注解标记方法并获取参数，计算出目标库表，最后在MyBatis的拦截器中修改SQL语句以实现分表。整个过程涉及到了分库分表、AOP、Mybatis拦截器等关键技术。

路由组件构建方案V1

实现效果：通过注解实现数据分散到不同库不同表的操作。
实现主要以下几部分：

数据源的配置和加载
数据源的动态切换
切点设置以及数据拦截
数据的插入

涉及的知识点：

分库分表相关概念
散列算法
数据源的切换
AOP切面
Mybatis拦截器

数据源的配置和加载

获取多个数据源我们肯定需要在yaml或者properties中进行配置。所以首先需要获取到配置信息；
定义配置文件中的库和表：

server:
  port: 8080
# 多数据源路由配置
router:
  jdbc:
    datasource:
      dbCount: 2
      tbCount: 4
      default: db00
      routerKey: uId
      list: db01,db02
      db00:
        driver-class-name: com.mysql.jdbc.Driver
        url: jdbc:mysql://xxxxx:3306/xxxx?useUnicode=true
        username: xxxx
        password: 111111
      db01:
        driver-class-name: com.mysql.jdbc.Driver
        url: jdbc:mysql://xxxxx:3306/xxxxx?useUnicode=true
        username: xxxxx
        password: 111111
      db02:
        driver-class-name: com.mysql.jdbc.Driver
        url: jdbc:mysql://xxxxx:3306/xxxx?useUnicode=true
        username: xxxxx
        password: 111111
mybatis:
  mapper-locations: classpath:/com/xbhog/mapper/*.xml
  config-location:  classpath:/config/mybatis-config.xml

为了实现并且使用自定义的数据源配置信息，启动开始的时候让SpringBoot定位位置。
首先类加载顺序：指定自动配置；

org.springframework.boot.autoconfigure.EnableAutoConfiguration=com.xbhog.db.router.config.DataSourceAutoConfig

针对读取这种自定义较大的信息配置，就需要使用到 org.springframework.context.EnvironmentAware 接口，来获取配置文件并提取需要的配置信息。

public class DataSourceAutoConfig implements EnvironmentAware {

    @Override
    public void setEnvironment(Environment environment){
        ......
    }
}

属性配置中的前缀需要跟路由组件中的属性配置：
这里设置成什么，在配置文件中就要设置成对应名字

String prefix = "router.jdbc.datasource.";

根据其前缀获取对应的库数量dbCount、表数量tbCount以及数据源信息dataSource;

//库的数量
dbCount = Integer.valueOf(environment.getProperty(prefix + "dbCount"));
//表的数量
tbCount = Integer.valueOf(environment.getProperty(prefix + "tbCount"));
//分库分表数据源
String dataSources = environment.getProperty(prefix + "list");

针对多数据源的存在，使用Map进行存储：Map<String，Map<String，Object>> daraSources;

for(String dbInfo : dataSources.split(",")){
    Map<String,Object> dataSourceProps = PropertyUtil.handle(environment, prefix + dbInfo, Map.class);
    dataSourceMap.put(dbInfo,dataSourceProps);
}

通过dataSource方法实现数据源的实例化：把基于从配置信息中读取到的数据源信息，进行实例化创建。
将获得的信息放到DynamicDataSource类(父类：DataSource)中进行实例化(setTargetDataSources,setDefaultTargetDataSource);
将我们自定义的数据源加入到Spring容器管理中。

//创建数据源
Map<Object, Object> targetDataSource = new HashMap<>();
//遍历数据源的key和value
for(String dbInfo : dataSourceMap.keySet()){
    Map<String, Object> objectMap = dataSourceMap.get(dbInfo);
    targetDataSource.put(dbInfo,new DriverManagerDataSource(objectMap.get("url").toString(),
            objectMap.get("username").toString(),objectMap.get("password").toString()));
}
//这是数据源
DynamicDataSource dynamicDataSource = new DynamicDataSource();
dynamicDataSource.setTargetDataSources(targetDataSource);
//defaultDataSourceConfig的输入点
dynamicDataSource.setDefaultTargetDataSource(new DriverManagerDataSource(defaultDataSourceConfig.get("url").toString(),
        defaultDataSourceConfig.get("username").toString(),defaultDataSourceConfig.get("password").toString()));
return dynamicDataSource;

到这里前置的配置都在spring中完成，后续是对数据的插入，也就是mybatis的操作：包含库表的随机计算和数据拦截器的实现。

动态切换数据源

路由切换的实现通过AbstractRoutingDataSource抽象类，该类充当了DataSource的路由中介, 在运行的时候，根据某种key值来动态切换到真正的DataSource上。继承了AbstractDataSource且AbstractDataSource实现了DataSource;
在AbstractRoutingDataSource根据方法determineTargetDataSource:

检索当前目标数据源。确定当前查找键，在targetDataSources映射中执行查找，必要时退回到指定的默认目标数据源。

protected DataSource determineTargetDataSource() {
    Assert.notNull(this.resolvedDataSources, "DataSource router not initialized");
    Object lookupKey = determineCurrentLookupKey();
    DataSource dataSource = this.resolvedDataSources.get(lookupKey);
    if (dataSource == null && (this.lenientFallback || lookupKey == null)) {
        dataSource = this.resolvedDefaultDataSource;
    }
    if (dataSource == null) {
        throw new IllegalStateException("Cannot determine target DataSource for lookup key [" + lookupKey + "]");
    }
    return dataSource;
}

里面使用determineCurrentLookupKey方法来确定当前查找的键(数据源key)；

抽象方法determineCurrentLookupKey()返回DataSource的key值，然后根据这个key从resolvedDataSources这个map里取出对应的DataSource，如果找不到，则用默认的resolvedDefaultDataSource。

	/**
	 *确定当前查找键。这通常用于检查线程绑定的事务上下文。 
	 *允许任意键。返回的键需要匹配由resolveSpecifiedLookupKey方法解析的存储查找键类型
	 */
	@Nullable
	protected abstract Object determineCurrentLookupKey();

所以我们只需要重写determineCurrentLookupKey，指定我们切换数据源的名字即可；

public class DynamicDataSource extends AbstractRoutingDataSource {
    @Override
    protected Object determineCurrentLookupKey() {
        return "db"+ DBContextHolder.getDBKey();
    }
}

在这部分对应上了前面创建数据源的操作，实现的该DynamicDataSource，并传入了默认数据源(setDefaultTargetDataSource)和目标数据源(setTargetDataSources);

自定义切点

前期数据源的配置和信息已经放到Spring容器中，可随时使用；根据注解通过拦截器拦截方法中的数据。进行分库分表的操作，通过扰动函数进行计算，将结果保存到ThreadLocal中，方便后续读取。

注解实现：

分库注解：首先设置三要素。

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.METHOD})
public @interface DBRouter {

    /** 分库分表字段 */
    String key() default "";
}

通过自定义切点@Around(**"aopPoint()&&@annotation(dbRouter)"**)，实现使用注解的时候就拦截对应的值：
在环绕处理的时候，判断方法上注解是否对应有值，有的话通过注解传入的value和方法传入的参数进行路由计算：
计算规则：

获取方法传入的参数
计算库表总数量：dbCount*tbCount
计算idx:**int **idx = (size -1) & (Key.hashCode() ^ (Key.hashCode() >>> 16))
1. 简单说明：与运算标识符后面，通过混合高位和低位，增大随机性
**int **dbIdx = idx / dbCount() + 1
**int **tbIdx = idx - tbCount() * (dbIdx - 1)

通过上述操作，将计算的记过保存到ThreadLocal中。
获取方法传入的参数：

private String getAttrValue(String dbKey, Object[] args) {
    if(1 == args.length){
        return args[0].toString();
    }
    String filedValue = null;
    for(Object arg : args){
        try{
            if(StringUtils.isNotBlank(filedValue)){
                break;
            }
            filedValue = BeanUtils.getProperty(arg,dbKey);
        }catch (Exception e){
            log.info("获取路由属性失败 attr：{}", dbKey,e);
        }
    }
    return filedValue;
}

自定义拦截器

我们定义了Interceptor将拦截StatementHandler(在SQL语法构建处理拦截)中参数类型为Connection的prepare方法，具体需要深入mybatis源码；
主要功能：在执行SQL语句前拦截，针对相关功能实现SQL的修改
在上述文章中主要是针对分库分表前做准备，下面才是决定数据入哪个库哪张表
通过StatementHandler(MyBatis直接在数据库执行SQL脚本的对象)获取mappedStatement(MappedStatement维护了一条<select|update|delete|insert>节点的封装),根据maperdStatement获取自定义注解dbRouterStrategy，判断是否进行分表操作;

Class<?> clazz = Class.forName(className);
DBRouterStrategy dbRouterStrategy = clazz.getAnnotation(DBRouterStrategy.class);
if (null == dbRouterStrategy || !dbRouterStrategy.splitTable()){
    return invocation.proceed();
}

dbRouterStrategy注解默认是false不分表，直接进行数据的插入【更新】；

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.TYPE,ElementType.METHOD})
public @interface DBRouterStrategy {
    boolean splitTable() default false;
}

如果分表注解存在或者分表参数是true，则进行以下四步：

获取SQL

BoundSql：表示动态生成的SQL语句以及相应的参数信息。

//获取SQL
BoundSql boundSql = statementHandler.getBoundSql();
String sql = boundSql.getSql();

匹配SQL

通过正则匹配分割【insert/select/update】和表名，方便后续表名的拼接。

//替换SQL表名USER为USER_3;
Matcher matcher = pattern.matcher(sql);
String tableName = null;
if(matcher.find()){
    tableName = matcher.group().trim();
}

拼接SQL

则通过反射修改SQL语句，并且替换表名；其中filed.set()将指定对象实参上由此field对象表示的字段设置为指定的新值。如果基础字段具有基元类型，则自动解开新值

assert null != tableName;
String replaceSQL = matcher.replaceAll(tableName + "_" + DBContextHolder.getTBKey());
//通过反射修改SQL语句
Field filed = boundSql.getClass().getDeclaredField("sql");
filed.setAccessible(true);
filed.set(boundSql,replaceSQL);