关于数据权限

参考 demo 模块用法(需导入 test.sql 文件)

新版数据权限功能:

1.支持自动注入 sql 数据过滤
2.查询、更新、删除限制
3.支持自定义数据字段过滤
4.模板支持 spel 语法实现动态 Bean 处理
5.支持与菜单权限标识符联合使用(2.2.X新功能)

数据权限相关代码

类	说明	功能
DataScopeType	数据权限模板定义	用于定义数据权限模板
DataPermission	数据权限组注解	用于标注开启数据权限 (默认过滤部门权限)
DataColumn	具体的数据权限字段标注	用于替换数据权限模板内的 key 变量
PlusDataPermissionInterceptor	数据权限 sql 拦截器	用于拦截所有 sql 检查是否标注了 `DataPermission` 注解
PlusDataPermissionHandler	数据权限处理器	用于处理被拦截到的 sql 为其添加数据权限过滤条件
DataPermissionHelper	数据权限助手	操作数据权限上下文变量
SysDataScopeService	自定义 Bean 处理数据权限	用于自定义扩展

忽略数据权限

1.如果需要指定单独 SQL 不开启过滤，可在对应的 Mapper 接口添加如下忽略注解：

@InterceptorIgnore(dataPermission = "true")

2.如果需要在业务层忽略数据权限，可调用以下方法：

# 无返回值
DataPermissionHelper.ignore(() -> { 业务代码 });
# 有返回值
Class result = DataPermissionHelper.ignore(() -> { return 业务代码 });

使用方式 `参考demo模块`

数据权限体系 用户 -> 多角色 => 角色 -> 单数据权限

例子: 用户A 拥有两个角色
角色A 部门经理可查看本部门及以下部门的数据
角色B 兼职开发可查看仅自己的数据

创建角色 test1 为本部门及以下

创建角色 test2 为仅本人

将其分配给用户 test

编写列表查询(注意: 数据权限注解只能在 Mapper 层使用)

标注数据权限注解 dept_id 为过滤部门字段 user_id 为过滤创建用户

重点注意: 如下情况不生效

有自定义实现方法最终执行的mapper不是这个方法所以无法生效

解决方案: 一直往下点找到最终的执行mapper重写即可

编写数据权限模板

1.code 为关联角色的数据权限 code
2.sqlTemplate 为 sql 模板
#{#deptName} 为模板变量对应权限注解的 key
#{@sdss} 为模板 Bean 调用调用其 Bean 的处理方法
3.elseSql 为兜底 sql 处理当前角色与标注的注解无对应的情况
例如数据权限为仅本人且方法并未标注具体过滤注解则填充 1 = 0 使条件不满足不允许查看
更详细用法可以参考 DataScopeType 注释