说在前面
啥是数据权限?
例如校长可以看到全部学生的信息,系主任可以看到该院系的学生信息,老师可以看到本班的学生信息,学生自己只能查看自己的信息
对于ruoyi的角色,我们只能控制用户可以访问那些菜单以及接口,而不能控制接口返回的数据
假如有这样一个需求,不同用户上传各自的图片,如果都是普通用户,那么他们可能都可以看到关于图片上传的菜单,也就相当于可以看到别人上传的图片,这是不合理的,所以我们需要分配数据权限,来进行控制
1.ruoyi实现数据权限原理
ruoyi中数据权限是通过AOP切入,修改SQL实现的,让SQL中拼接一些关于权限的SQL来实现的
关键类: DataScopeAspect
可以看到ruoyi分为了5类权限级别
全部数据权限 1
自定数据权限 2 用户指定对应的部门 对应到sql其实就是 in (指定的部门)
部门数据权限 3 直接使用部门查 =
部门及以下数据权限 4 通过find_in_set(101,ancestor)实现找到该部门下的所有子部门
仅本人数据权限 5 直接使用用户表查 =
/** * 数据过滤处理 * * @author ruoyi */ @Aspect @Component public class DataScopeAspect { /** * 全部数据权限 */ public static final String DATA_SCOPE_ALL = "1"; /** * 自定数据权限 */ public static final String DATA_SCOPE_CUSTOM = "2"; /** * 部门数据权限 */ public static final String DATA_SCOPE_DEPT = "3"; /** * 部门及以下数据权限 */ public static final String DATA_SCOPE_DEPT_AND_CHILD = "4"; /** * 仅本人数据权限 */ public static final String DATA_SCOPE_SELF = "5"; /** * 数据权限过滤关键字 */ public static final String DATA_SCOPE = "dataScope"; @Before("@annotation(controllerDataScope)") public void doBefore(JoinPoint point, DataScope controllerDataScope) throws Throwable { clearDataScope(point); handleDataScope(point, controllerDataScope); } protected void handleDataScope(final JoinPoint joinPoint, DataScope controllerDataScope) { // 获取当前的用户 LoginUser loginUser = SecurityUtils.getLoginUser(); if (StringUtils.isNotNull(loginUser)) { SysUser currentUser = loginUser.getUser(); // 如果是超级管理员，则不过滤数据 if (StringUtils.isNotNull(currentUser) && !currentUser.isAdmin()) { String permission = StringUtils.defaultIfEmpty(controllerDataScope.permission(), PermissionContextHolder.getContext()); dataScopeFilter(joinPoint, currentUser, controllerDataScope.deptAlias(), controllerDataScope.userAlias(), permission); } } } /** * 数据范围过滤 * * @param joinPoint 切点 * @param user 用户 * @param deptAlias 部门别名 * @param userAlias 用户别名 * @param permission 权限字符 */ public static void dataScopeFilter(JoinPoint joinPoint, SysUser user, String deptAlias, String userAlias, String permission) { StringBuilder sqlString = new StringBuilder(); List<String> conditions = new ArrayList<String>(); for (SysRole role : user.getRoles()) { String dataScope = role.getDataScope(); if (!DATA_SCOPE_CUSTOM.equals(dataScope) && conditions.contains(dataScope)) { continue; } if (StringUtils.isNotEmpty(permission) && StringUtils.isNotEmpty(role.getPermissions()) && !StringUtils.containsAny(role.getPermissions(), Convert.toStrArray(permission))) { continue; } if (DATA_SCOPE_ALL.equals(dataScope)) { sqlString = new StringBuilder(); break; } else if (DATA_SCOPE_CUSTOM.equals(dataScope)) { sqlString.append(StringUtils.format( " OR {}.dept_id IN ( SELECT dept_id FROM sys_role_dept WHERE role_id = {} ) ", deptAlias, role.getRoleId())); } else if (DATA_SCOPE_DEPT.equals(dataScope)) { sqlString.append(StringUtils.format(" OR {}.dept_id = {} ", deptAlias, user.getDeptId())); } else if (DATA_SCOPE_DEPT_AND_CHILD.equals(dataScope)) { sqlString.append(StringUtils.format( " OR {}.dept_id IN ( SELECT dept_id FROM sys_dept WHERE dept_id = {} or find_in_set( {} , ancestors ) )", deptAlias, user.getDeptId(), user.getDeptId())); } else if (DATA_SCOPE_SELF.equals(dataScope)) { if (StringUtils.isNotBlank(userAlias)) { sqlString.append(StringUtils.format(" OR {}.user_id = {} ", userAlias, user.getUserId())); } else { // 数据权限为仅本人且没有userAlias别名不查询任何数据 sqlString.append(StringUtils.format(" OR {}.dept_id = 0 ", deptAlias)); } } conditions.add(dataScope); } if (StringUtils.isNotBlank(sqlString.toString())) { Object params = joinPoint.getArgs()[0]; if (StringUtils.isNotNull(params) && params instanceof BaseEntity) { BaseEntity baseEntity = (BaseEntity) params; baseEntity.getParams().put(DATA_SCOPE, " AND (" + sqlString.substring(4) + ")"); } } } /** * 拼接权限sql前先清空params.dataScope参数防止注入 */ private void clearDataScope(final JoinPoint joinPoint) { Object params = joinPoint.getArgs()[0]; if (StringUtils.isNotNull(params) && params instanceof BaseEntity) { BaseEntity baseEntity = (BaseEntity) params; baseEntity.getParams().put(DATA_SCOPE, ""); } } }
代码的具体逻辑
前置通知 清理请求参数的DataScope防止SQL注入 (其实就是sql拼接如 … where … OR 1 = 1 这样就可以无视条件访问数据) 获取到当前登录的用户的所有角色对象 遍历角色获取角色上的dataScope (普通用户默认为5) 然后根据不同的dataScope拼接不同的sql,查出来的结果也不同 最后在mapper里的sql添加上${params.dataScope}变量
2. 定义自己的数据权限
我们要定义自己的表要和数据权限联动的话,就需要user_id字段
现在有这样一个需求,就是用户上传图片,不同用户只能看到自己的图片
CREATE TABLE `ruoyi-vue`.`picture` ( `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键', `URI` varchar(500) NULL COMMENT '若干图片URI', `user_id` bigint(20) NULL COMMENT '关联用户user_id', `create_by` varchar(50) NULL COMMENT '创建人', `create_time` datetime NULL COMMENT '创建时间', `update_by` varchar(50) NULL COMMENT '更新人', `update_time` datetime NULL COMMENT '更新时间', `remark` varchar(500) NULL COMMENT '备注', PRIMARY KEY (`id`) );
使用ruoyi自动生成前后端代码
直接看页面成果
2.2 数据权限的问题
创建两个普通用户,由于系统内置了一个ry普通用户所以只需要添加一个普通用户即可
用不同的普通用户上传图片, 然后就可以发现一个很神奇的问题,该用户可以看到所有的图片
dearth用户
ry用户
从上图可以看出自己可以看到其他用户上传的所有图片
2.3 设置数据权限
设置角色的数据权限类型
service
把创建人和user_id添加到表中
/** * 新增图片管理 * * @param picture 图片管理 * @return 结果 */ @Override public int insertPicture(Picture picture) { picture.setCreateTime(DateUtils.getNowDate()); picture.setCreateBy(SecurityUtils.getUsername()); picture.setUserId(SecurityUtils.getUserId()); return pictureMapper.insertPicture(picture); }
PictureMapper.xml
修改该查询的sql,拼接两个条件,并且把 ${params.dataScope} 添加上去
<select id="selectPictureList" parameterType="Picture" resultMap="PictureResult"> select p.id, p.URI, p.user_id, p.create_by, p.create_time, p.update_by, p.update_time, p.remark from picture p left join sys_user u on u.user_id = p.user_id left join sys_dept d on d.dept_id = u.dept_id <where> <if test="uri != null and uri != ''"> and URI = #{uri}</if> <if test="userId != null "> and user_id = #{userId}</if> ${params.dataScope} </where> </select>
添加@DateScope注解启用数据权限
/** * 查询图片管理列表 * * @param picture 图片管理 * @return 图片管理 */ @Override @DataScope(deptAlias = "d", userAlias = "u") public List<Picture> selectPictureList(Picture picture) { return pictureMapper.selectPictureList(picture); }
2.4 查看是否生效
dearth用户
ry用户
说明已经生效
