SAAS架构之多租户系统-使用TenantLineInnerInterceptor

最新推荐文章于 2025-06-12 16:25:49 发布

原创最新推荐文章于 2025-06-12 16:25:49 发布 · 792 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#Mybatis-Plus

架构设计专栏收录该内容

3 篇文章

订阅专栏

文章介绍了MybatisPlus中的多租户插件，包括TenantLineHandler接口的使用，如获取租户ID表达式和忽略特定表的方法。在MybatisPlusConfig类中配置插件，可以通过重写方法来定制租户ID和忽略特定表的行为。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

MybatisPlus多租户插件官网地址

自带的租户处理接口

/**
 * 租户处理器（ TenantId 行级 ）
 *
 * @author hubin
 * @since 3.4.0
 */
public interface TenantLineHandler {

    /**
     * 获取租户 ID 值表达式，只支持单个 ID 值
     * <p>
     *
     * @return 租户 ID 值表达式
     */
    Expression getTenantId();

    /**
     * 获取租户字段名
     * <p>
     * 默认字段名叫: tenant_id
     *
     * @return 租户字段名
     */
    default String getTenantIdColumn() {
        return "tenant_id";
    }

    /**
     * 根据表名判断是否忽略拼接多租户条件
     * <p>
     * 默认都要进行解析并拼接多租户条件
     *
     * @param tableName 表名
     * @return 是否忽略, true:表示忽略，false:需要解析并拼接多租户条件
     */
    default boolean ignoreTable(String tableName) {
        return false;
    }
}

在MybatisPlusConfig类中添加多租户插件，

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

    /**
     * 新多租户插件配置,一缓和二缓遵循mybatis的规则,需要设置 MybatisConfiguration#useDeprecatedExecutor = false 避免缓存万一出现问题
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        interceptor.addInnerInterceptor(new TenantLineInnerInterceptor(new TenantLineHandler() {
            @Override
            public Expression getTenantId() {
                return new LongValue(1);
            }
            // 这是 default 方法,默认返回 false 表示所有表都需要拼多租户条件
            @Override
            public boolean ignoreTable(String tableName) {
                return !"users".equalsIgnoreCase(tableName);
            }
        }));
        return interceptor;
    }


}

在ignoreTable方法为true时，会自动加上getTenantIdColumn字段名和getTenantId字段值。