不灭的火

一、引言

先来说下动态名表在什么场景下需要使用呢？

拿小编的实际项目来说，小编公司手里掌握着国内各个部分地区的医院患者数据，那么一个医院的患者的数据流量肯定是很大的，这个时候如果全部放在同一张表中，那么可想而知数据量的庞大。所以数据库设计的时候可以一家医院对应一张表，分开来存储，表中的列名都是一样的，只是表名不同。

或者还可以做日志的存储，日志数据量也是很大的，可以分一个月对应一张表，比如：log_201907、log_201908等等之类的。

二、具体实现

动态表名SQL解析器也是基于MP分页插件来实现的，代码如下：

package com.baomidou.mybatisplus.samples.dytablename.config;

import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.DynamicTableNameInnerInterceptor;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.Map;
import java.util.Random;


@Configuration
@MapperScan("com.baomidou.mybatisplus.samples.dytablename.mapper")
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
		
        DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor = new DynamicTableNameInnerInterceptor();
        dynamicTableNameInnerInterceptor.setTableNameHandler((sql, tableName) -> {
            // 获取参数方法
            Map<String, Object> paramMap = RequestDataHelper.getRequestData();
            paramMap.forEach((k, v) -> System.err.println(k + "----" + v));

			// 自定义表名规则，或者从配置文件、request上下文中读取
            // 假设这里的“用户表”根据年份来进行分表操作
			if (tableName.equal("sys_user")) {
				Date date = new Date();
				String year = String.format("%tY", date);
				// 返回最后需要操作的表名：sys_user_2019
                return "sys_user_" + year;
			}
			
            return tableName;
        });
		
        interceptor.addInnerInterceptor(dynamicTableNameInnerInterceptor);
        
		// 3.4.3.2 作废该方式
        // dynamicTableNameInnerInterceptor.setTableNameHandlerMap(map);
		
        return interceptor;
    }
}

代码演示：MP会针对配置的表名做动态解析，从sql中可以看出表名已经替换成sys_user_2019了。

@Test
public void select(){
	List<User> users = userMapper.selectList(Wrappers.<User>lambdaQuery().eq(User::getAge, 18));
	users.forEach(System.out::println);
}

日志信息：

INFOStarted UserMapperTest in 3.409 seconds (JVM running for 4.233)
DEBUG==>  Preparing: SELECT id, login_name, name, password, email, salt, sex, age, phone, user_type, status, organization_id, create_time, update_time, version, tenant_id FROM sys_user_2019 WHERE sys_user_2019.tenant_id = 'jiannan' AND is_delete = '0' AND age = ? 
DEBUG==> Parameters: 18(Integer)

三、注意细节

细节一：如果自定义规则的表名返回为空，则会按照实际的表名来处理。

细节二：如果配置了多租户SQL解析器，过滤了特定的sql，则也会按照实际表名来处理。

如下代码使用了@SqlParser注解来过滤这条sql不需要加租户ID，执行这条sql的时候同样也会把动态表名SQL解析也会过滤掉，按照实际表名处理，MP可能后续版本会进行改进。

/**
 * 用户 Mapper 接口
 */
public interface UserMapper extends BaseMapper<User> {
 
    /**
     * 自定Wrapper修改
     *
     * @param userWrapper 条件构造器
     * @param user        修改的对象参数
     * @return
     */
    @SqlParser(filter = true)
    int updateByMyWrapper(@Param(Constants.WRAPPER) Wrapper<User> userWrapper, @Param("user") User user);
 
}

参考：

/config/MybatisPlusConfig.java

https://jiannan.blog.csdn.net/article/details/101196130