当前位置：首页 > news >正文

若依 RuoYi-Vue 自定义车间设备模块 + 数据权限完整实现教程

news 2026/6/3 17:34:41

一、前言

在若依框架中，权限分为菜单接口权限和数据权限。菜单权限控制能看到哪些功能、访问哪些接口；数据权限控制同一张数据表，不同角色用户能看到哪些行数据。

本次实战搭建车间设备管理模块，实现需求：

超级管理员：查看全部车间设备数据
普通角色用户：只能查看本部门 / 本车间设备数据
核心技术：@DataScope注解 + AOP 切面 + MyBatis 动态 SQL 拼接

二、核心原理

若依内置DataScopeAspect切面类，拦截@DataScope注解
自动获取当前登录用户所属部门、角色数据权限
动态拼接 SQL 过滤条件，存入实体类params参数
Mapper XML 通过${params.dataScope}引入动态条件，实现行级过滤
内置 5 种数据权限：全部、自定义、本部门、本部门及以下、仅本人

三、数据库准备（CMD 终端操作）

1. CMD 登录 MySQL

bash

运行

mysql -uroot -p

输入密码登录，选择若依数据库

sql

use ry-vue;

2. 创建设备表

sql

CREATE TABLE `sys_equipment` ( `equip_id` BIGINT NOT NULL AUTO_INCREMENT COMMENT '设备ID', `equip_name` VARCHAR(100) NOT NULL COMMENT '设备名称', `equip_no` VARCHAR(50) DEFAULT NULL COMMENT '设备编号', `dept_id` BIGINT NOT NULL COMMENT '所属车间部门ID', `user_id` BIGINT DEFAULT NULL COMMENT '负责人ID', `status` CHAR(1) DEFAULT '0' COMMENT '状态（0正常 1停用）', `create_time` DATETIME DEFAULT NULL COMMENT '创建时间', PRIMARY KEY (`equip_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='车间设备表';

3. 插入测试设备数据

sql

INSERT INTO sys_equipment (equip_name, equip_no, dept_id, user_id) VALUES ('LatheA', 'Li_001', 103, 2), ('MillingB', 'Li_002', 103, 3), ('DrillC', 'Li_003', 104, 2);

4. 导入菜单 SQL

解压代码生成包，在 CMD 执行菜单脚本：

sql

source D:/edgdownload/w13/equipmentMenu.sql;

四、若依代码生成

登录若依后台 → 系统工具 → 代码生成
导入sys_equipment表，配置：
- 模块名：equipment
- 功能名：设备管理
- 上级菜单：系统管理
生成代码并下载压缩包，解压得到后端、前端、SQL 文件

五、项目代码部署

1. 后端代码复制

将controller/domain/mapper/service对应文件复制到项目对应包下
将SysEquipmentMapper.xml复制到mapper/system目录

2. 前端代码复制

equipment.js复制到ruoyi-ui/src/api
equipment文件夹复制到ruoyi-ui/src/views

六、数据权限核心改造（三步必做）

1. 实体类继承 BaseEntity

自动生成的SysEquipment已默认继承，无需修改，核心作用：携带params参数存放动态 SQL。

2. Service 层添加 @DataScope 注解

修改SysEquipmentServiceImpl.java，导入注解并添加到查询列表方法：

java

运行

import com.ruoyi.common.annotation.DataScope; @Override @DataScope(deptAlias = "d", userAlias = "s") public List<SysEquipment> selectSysEquipmentList(SysEquipment sysEquipment) { return sysEquipmentMapper.selectSysEquipmentList(sysEquipment); }

deptAlias = "d"：部门表别名
userAlias = "s"：设备表别名

3. Mapper XML 改造

关联部门表，末尾加入${params.dataScope}接收动态权限 SQL：

xml

<select id="selectSysEquipmentList" parameterType="SysEquipment" resultMap="SysEquipmentResult"> select s.* from sys_equipment s left join sys_dept d on s.dept_id = d.dept_id <where> <if test="equipName != null and equipName != ''"> and equip_name like concat('%', #{equipName}, '%') </if> <if test="status != null and status != ''"> and status = #{status} </if> ${params.dataScope} </where> </select>