MyBatis 多租户、逻辑删除、数据权限插件、多数据源-SqlHelper(持续维护，放心使用)

如果您正在使用MyBatis，并且您的项目需要多租户、逻辑删除和数据权限、多数据源的功能建议您使用，这一定是最方便的方式，使用它对您的现有代码没有侵入，您不需要对现有代码进行任何修改。

特点

可实现多租户
可实现真实删除转逻辑删除
可实现行级别和列级别权限控制（自动解析注入）
简单方便开箱即用的多数据源管理和切换
可插拔
简单方便,无压力
高效率（基于阿里 druid sql解析器）
将多租户、逻辑删除与应用程序解耦，随配随用
强大的字段自动注入能力（查询条件注入/插入语句注入/更新语句注入/查询列过滤），定制其他业务逻辑
支持多种数据库（基于阿里 druid sql解析器）

spring 集成

查看博客戳这里 👆

使用数据权限

数据权限专篇

使用多数据源

多数据源专篇

注入示例

sql自动注入

CONDITION条件注入

单一条件注入，创建类实现InjectColumnInfoHandler，如：

@Component
public class MyConditionInfoHandler implements InjectColumnInfoHandler {
    @Override
    public String getColumnName() {
        return "tenant_id";
    }
    @Override
    public String getValue() {
        return "sqlhelper";
    }
    @Override
    public String op() {
        return "=";
    }
    @Override
    public int getInjectTypes() {
        return CONDITION;
    }
    @Override
    public boolean checkCommandType(SqlCommandType commandType) {
        return true;
    }
    @Override
    public boolean checkTableName(String tableName) {
        return true;
    }

    @Override
    public boolean checkMapperId(String mapperId) {
        return true;
    }
}

查询语句中：

select * from user s

输出：

SELECT * FROM user s WHERE s.tenant_id = 'sqlhelper'

更新语句中：

update user set name = ? where id = ?

输出：

update user set name = ? where id = ? and user.tenant_id = 'sqlhelper'

删除语句中：

delete from user where id = ?

输出：

delete from user where id = ? and user.tenant_id = 'sqlhelper'

外连接语句中：

SELECT * FROM user u left JOIN card c ON u.id = c.user_id

输出：

SELECT *
FROM user u
	LEFT JOIN card c
	ON u.id = c.user_id
		AND c.tenant_id = sqlhelper
WHERE u.tenant_id = sqlhelper

各种子查询语句中：

SELECT * FROM (select * from user where id = 2) s

输出：

SELECT *
FROM (
	(SELECT *
	FROM user
	WHERE id = 2
		AND user.tenant_id = sqlhelper)
) s

查看更多测试示例
2. 多条件组合注入继承BinaryConditionInjectInfoHandler

/**
 * @author heykb
 * 注入： a = 1 and (b > 1 or c = 'x')
 */
@Component
public class MyBinaryConditionInjectInfoHandler extends BinaryConditionInjectInfoHandler {

    @Override
    public String op() {
        return "and";
    }

    @Override
    public InjectColumnInfoHandler getLeftConditionInjectInfo() {
        return new SimpleCondition("a","=","1");
    }

    @Override
    public InjectColumnInfoHandler getRightConditionInjectInfo() {
        return new BinaryConditionInjectInfoHandler() {
            @Override
            public InjectColumnInfoHandler getLeftConditionInjectInfo() {
                return new SimpleCondition("b",">","1");
            }

            @Override
            public String op() {
                return "or";
            }

            @Override
            public InjectColumnInfoHandler getRightConditionInjectInfo() {
                return new SimpleCondition("c","=","'x'");
            }
        };
    }
    
    static class SimpleCondition implements InjectColumnInfoHandler{
        String columnName;
        String op;
        String value;

        public SimpleCondition(String columnName, String op, String value) {
            this.columnName = columnName;
            this.op = op;
            this.value = value;
        }

        @Override
        public String getColumnName() {
            return columnName;
        }

        @Override
        public String op() {
            return op;
        }

        @Override
        public String getValue() {
            return value;
        }

        @Override
        public int getInjectTypes() {
            return 0;
        }
    }
}

INSERT插入列注入如自动插入租户id列

实现InjectColumnInfoHandler，如:

@Component
public class MyInsertInfoHandler implements InjectColumnInfoHandler {
        
        @Override
        public String getColumnName() {
            return "tenant_id";
        }
        @Override
        public String getValue() {
            return "'sqlhelper'";
        }
    
        @Override
        public int getInjectTypes() {
            return INSERT;
        }
        @Override
        public boolean checkCommandType(SqlCommandType commandType) {
            return true;
        }
        @Override
        public boolean checkTableName(String tableName) {
            return true;
        }
};

输入：

INSERT INTO user (id, name)
VALUES ('0', 'heykb')

输出：

INSERT INTO user (id, name, tenant_id)
VALUES ('0', 'heykb', 'sqlhelper')

输入：

INSERT INTO user (id, name)
SELECT g.id, g.name
FROM user_group g
WHERE id = 1

输出：

INSERT INTO user (id, name, tenant_id)
SELECT g.id, g.name
FROM user_group g
WHERE id = 1

查看更多测试示例

UPDATE更新项注入...如自动更新updated_time列

@Override
public int getInjectTypes() {
    return UPDATE;
}

同时多种类型注入

@Override
public int getInjectTypes() {
    return UPDATE|INSERT|...;
}

查看更多测试示例

字段隔离的多租户（数据源隔离级别参考sqlhelper多数据源配置）

能帮你做什么？

1. 自动为所有where 、join on添加租户过滤条件
2. 自动为insert语句添加租户列的插入
3. 多租户的实现也是利用sqlhelper的自动注入功能，相当于配置了CONDITIO与INSERT的两种注入

创建注入类

创建类继承[TenantInfoHandler](mybatis-sqlhelper/src/main/java/io/github/heykb/sqlhelper/handler/abstractor/TenantInfoHandler.java)，如：
~~~java
@Component
public class SimpleTenantInfoHandler extends TenantInfoHandler {

    /**
     * 设置代表租户字段名称
     * @return
     */
    @Override
    public String getTenantIdColumn() {
        return "tenant_id";
    }

    /**
     * 当前租户value获取方式。通常从线程上下文中获取用户租户信息
     * @return
     */
    @Override
    public String getTenantId() {
        // SecurityContextHolder.getContext().getAuthentication()
        return "sqlhelper";
    }

}

物理删除切换逻辑删除

能帮你做什么？

对于删除sql自动转逻辑删除,查询和更新sql添加逻辑删除条件保证不会查询到已经删除的数据，支持多表删除等复杂情况，详情可以查看更多测试示例

创建类继承LogicDeleteInfoHandler

@Component
public class SimpleLogicDeleteInfoHandler extends LogicDeleteInfoHandler {
    // 主要是为了从中提取SET is_deleted = 'Y'
    @Override
    public String getDeleteSqlDemo() {
        return "UPDATE xx SET is_deleted = 'Y'";
    }

    @Override
    public String getNotDeletedValue() {
        return "'N'";
    }

    @Override
    public String getColumnName() {
        return "is_deleted";
    }

    @Override
    public boolean checkMapperId(String mapperId) {
        return !mapperId.contains("noPlugin");
    }
}

3.观察日志。

物理删除语句已经被自动转换成更新语句，并且保留了所有where条件。查询和更新也自动添加了过滤条件

未完待续。。(如果你有兴趣，右上角watch该项目获得最新的动态)

参与贡献

如果你发现问题，提交issue。

如果你解决了问题，fork项目提交pull request。

联系我

QQ群: 947964874
email: [email protected],[email protected]

Name		Name	Last commit message	Last commit date
Latest commit History 66 Commits
mybatis-sqlhelper-spring-boot		mybatis-sqlhelper-spring-boot
mybatis-sqlhelper-spring		mybatis-sqlhelper-spring
mybatis-sqlhelper		mybatis-sqlhelper
.gitignore		.gitignore
DYNAMIC_DATASOURCE_README.md		DYNAMIC_DATASOURCE_README.md
LICENSE		LICENSE
Mybatis-README.md		Mybatis-README.md
README.md		README.md
README_DATA_PERMISSION.md		README_DATA_PERMISSION.md
README_SPRING_BOOT.md		README_SPRING_BOOT.md
pom.xml		pom.xml
sql-demo.md		sql-demo.md

License

heykb/mybatis-sqlhelper

Folders and files

Latest commit

History

Repository files navigation

MyBatis 多租户、逻辑删除、数据权限插件、多数据源-SqlHelper(持续维护，放心使用)

特点

spring 集成

查看博客戳这里 👆

使用数据权限

使用多数据源

注入示例

sql自动注入

CONDITION条件注入

查询语句中：

输出：

更新语句中：

输出：

删除语句中：

输出：

外连接语句中：

输出：

各种子查询语句中：

输出：

INSERT插入列注入 如自动插入租户id列

输入：

输出：

输入：

输出：

UPDATE更新项注入...如自动更新updated_time列

同时多种类型注入

查看更多测试示例

字段隔离的多租户（数据源隔离级别参考sqlhelper多数据源配置）

能帮你做什么？

创建注入类

物理删除切换逻辑删除

能帮你做什么？

3.观察日志。

未完待续。。(如果你有兴趣，右上角watch该项目获得最新的动态)

参与贡献

联系我

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors 2

Uh oh!

Languages

INSERT插入列注入如自动插入租户id列

Packages