SQL数据分表Mybatis Plus动态表名优方案
一、利用场景
大家在使用Mybatis进行开发的时候，常常会遇到一种情况：依照月份month将数据放在区别的表里面，查询数据的时候需要跟区别的月份month去查询区别的表。
但是我们都知道，Mybatis是ORM持久层框架，即：实体关系映照，实体Object与数据库表之间是存在逐一对应的映照关系。
比如：
public class Student {
private Integer id;
private String stuName;
private Integer age;
}
表结构：
`id` INT(11) NOT NULL AUTO_INCREMENT,
`stu_name` VARCHAR(64) NOT NULL DEFAULT ‘0’ COMMENT ‘姓名’,
`age` INT(11) NOT NULL COMMENT ‘年龄’,
PRIMARY KEY (`id`)
)
COMMENT=’学生表’
COLLATE=’utf8_general_ci’
ENGINE=InnoDB
;
Student 实体类与student表是逐一对应的关系，如果我们希望将学员表依照月份进行分表，比如：student_202206、student_202207、student_202208，即产生了**「一个实体类及其Mapper需要操作多个数据库分月表，这类情况在Mybatis plus下我们该怎么操作数据呢？」** 其实方法有很多，我将我实践中总结出的最优方案给大家进行说明。
二、动态表名处理器接口实现
为了处理上述类似的问题，mybatis plus提供了动态表名处理器接口TableNameHandler，我们只需要实现这个接口，并将这个接口利用配置生效，便可实现动态表名。
需要注意的是：
- 在mybatis plus 3.4版本之前，动态表名处理器接口是
ITableNameHandler, 需要配合mybatis plus分页插件一起使用才能生效。我们这里只介绍3.4版本以后的实现方式。- 在mybatis plus 3.4.3.2 作废该的方式：dynamicTableNameInnerInterceptor.setTableNameHandlerMap(map); 大家如果见到这类方式实现的动态表名，也是过时的实现方法，新版本中该方法已删除。
经过我一段时间的实践总结，我的实现类以下（基于mybatis plus 3.4.3.2以后的版本）：
import java.util.Arrays;
import java.util.List;
/**
* 按月份参数，组成动态表名
*/
public class MonthTableNameHandler implements TableNameHandler {
//用于记录哪些表可使用该月份动态表名处理器（即哪些表按月分表）
private List<String> tableNames;
//构造函数，构造动态表名处理器的时候，传递tableNames参数
public MonthTableNameHandler(String …tableNames) {
this.tableNames = Arrays.asList(tableNames);
}
//每一个要求线程保护一个month数据，避免多线程数据冲突。所以使用ThreadLocal
private static final ThreadLocal<String> MONTH_DATA = new ThreadLocal<>();
//设置要求线程的month数据
public static void setData(String month) {
MONTH_DATA.set(month);
}
//删除当前要求线程的month数据
public static void removeData() {
MONTH_DATA.remove();
}
//动态表名接口实现方法
@Override
public String dynamicTableName(String sql, String tableName) {
if (this.tableNames.contains(tableName)){
return tableName + “_” + MONTH_DATA.get(); //表名增加月份后缀
}else{
return tableName; //表名原样返回
}
}
}
大家先对上面的代码有一个基础了解，看了下面的测试进程，再回头看上面的代码中的注释，就比较不错理解了。表名处理器写好了以后，我们要让它生效，还需要做以下的配置。配置内容照葫芦画瓢就能够了。需要关注的部份，我都已给大家添加了注释。
@MapperScan(“com.zimug”)
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor = new DynamicTableNameInnerInterceptor();
dynamicTableNameInnerInterceptor.setTableNameHandler(
//可以传多个表名参数，指定哪些表使用MonthTableNameHandler处理表名称
new MonthTableNameHandler(“student”,”teacher”)
);
//以拦截器的方式处理表名称
interceptor.addInnerInterceptor(dynamicTableNameInnerInterceptor);
//可以传递多个拦截器，即：可以传递多个表名处理器TableNameHandler
//interceptor.addInnerInterceptor(dynamicTableNameInnerInterceptor);
return interceptor;
}
}
三、测试实现效果
首先创建一个StudentMapper ，默许情况下StudentMapper 只能操作student表，不能操作student_YYYYMM表。
public interface StudentMapper extends BaseMapper<Student> {}
下面我们来写一个单元测试用例，该测试用例test函数摹拟一次要求访问的Controller或service函数。
class DynamicTableNameTest {
@Resource
private StudentMapper studentMapper;
@Test
void test() {
//履行数据操作之前设置月份（实际场景下该参数从要求参数中解析）
MonthTableNameHandler.setData(“202208”);
studentMapper.selectById(1); //以id=2查询student_202208这张表
//阅后即焚，将ThreadLocal当前要求线程的数据移除
MonthTableNameHandler.removeData();
}
}
当我们履行这个单元测试用例的时候，我们发现控制台打印出以下信息，注意看SQL的部份，真的是去查询student_202208这张表了，而不是student表。这说明我们的动态表名实现是成功的。
到此这篇关于SQL数据分表Mybatis Plus动态表名优方案的文章就介绍到这了,更多相关Mybatis Plus优化内容请搜索之前的文章或继续浏览下面的相关文章希望大家以后多多支持！
文章来源：丸子建站
文章标题：SQL数据分表Mybatis Plus动态表名优方案
https://www.wanzijz.com/view/60289.html
