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

若依框架单体应用版：从建表到增删改查，代码生成器实战指南

news 2026/6/8 11:33:01

1. 若依框架单体应用版快速上手

第一次接触若依框架时，我被它的代码生成器功能惊艳到了。作为一个长期奋战在业务开发一线的程序员，最头疼的就是重复编写那些千篇一律的增删改查代码。若依的单体应用版（前后端不分离）特别适合中小型内部管理系统开发，就拿学生信息管理这个场景来说，从建表到功能上线，我用不到半小时就完成了全部流程。

若依框架本质上是一个基于Spring Boot的快速开发平台，它最大的亮点就是内置了强大的代码生成器。你只需要设计好数据库表结构，它就能自动生成符合规范的前后端代码。我经手过的教务管理系统、OA系统都在用这个方案，特别是当领导突然要求"明天就要看到原型"时，这个功能简直就是救命稻草。

要使用若依，首先需要准备以下环境：

JDK 1.8+
MySQL 5.7+
Maven 3.5+
开发工具推荐IntelliJ IDEA

安装过程比想象中简单很多。从官网下载压缩包后，导入IDE就能直接运行。记得第一次启动时，我按照文档先执行了那两个SQL文件，修改了数据库连接配置，一点启动按钮，控制台就开始刷刷刷地跑日志，那种"一次成功"的体验实在太棒了。

2. 学生信息表设计与代码生成

2.1 数据库建表实战

设计学生表时，我建议遵循若依的命名规范。比如表名用stu_student这样的前缀结构，字段名也要保持统一风格。这是我经过多次踩坑后总结的经验：

CREATE TABLE `stu_student` ( `student_id` int(11) NOT NULL AUTO_INCREMENT COMMENT '学号', `student_name` varchar(50) NOT NULL COMMENT '姓名', `student_age` int(3) DEFAULT NULL COMMENT '年龄', `student_sex` char(1) DEFAULT '0' COMMENT '性别（0男 1女 2未知）', `student_class` varchar(50) DEFAULT NULL COMMENT '班级', `student_phone` varchar(20) DEFAULT NULL COMMENT '联系电话', `student_address` varchar(255) DEFAULT NULL COMMENT '家庭住址', `status` char(1) DEFAULT '0' COMMENT '状态（0正常 1停用）', `create_time` datetime DEFAULT NULL COMMENT '创建时间', `update_time` datetime DEFAULT NULL COMMENT '更新时间', PRIMARY KEY (`student_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='学生信息表';

特别注意几个关键点：

主键自增字段用id后缀
状态字段遵循若依的0/1标准
创建时间和更新时间是审计字段，若依会自动处理
注释一定要写完整，代码生成器会把这些注释转为前端表单的label

2.2 代码生成器配置技巧

在若依后台的"系统工具 -> 代码生成"页面导入刚创建的表后，有几个配置项需要特别注意：

模块命名：包名改成com.ruoyi.student，这样生成的代码会自动归集
业务名称：填写"student"作为基础路径
功能名称：写"学生信息"会作为菜单显示名称
上级菜单：选择系统菜单中的合适位置

生成配置文件的修改也有门道。打开ruoyi-generator模块下的generator.yml，我通常这样设置：

gen: author: yourname packageName: com.ruoyi.student autoRemovePre: true tablePrefix: stu_

特别注意autoRemovePre这个参数，设为true后生成的实体类会自动去掉表前缀，这样StuStudent就会变成更简洁的Student。

3. 代码集成与功能调试

3.1 后端模块整合

生成的代码包解压后会看到一个完整的Maven模块结构。我习惯先处理后端部分：

在父工程下新建ruoyi-student模块
添加对ruoyi-common的依赖
把生成的Java代码拷贝到src/main/java
把mapper.xml放到resources目录

pom.xml配置很关键，这里有个小技巧：

<dependencies> <dependency> <groupId>com.ruoyi</groupId> <artifactId>ruoyi-common</artifactId> </dependency> <!-- 若依4.7.5+版本需要额外添加 --> <dependency> <groupId>com.ruoyi</groupId> <artifactId>ruoyi-framework</artifactId> </dependency> </dependencies>

记得还要在ruoyi-admin的pom中添加对新模块的依赖，否则启动时会报找不到类的错误。

3.2 前端页面调整

前端部分主要处理两个地方：

把生成的HTML文件放到ruoyi-admin/src/main/resources/templates
JS文件放到static目录下对应位置

我遇到过一个典型问题：页面显示出来了，但表格数据不加载。后来发现是生成的API路径和实际不符。解决方法是在ruoyi-student模块的StudentController上添加明确的RequestMapping：

@RestController @RequestMapping("/student/student") public class StudentController extends BaseController

另一个常见问题是表单提交失败，这通常是因为字段校验规则冲突。建议在生成代码后检查Student.java实体类中的@NotNull等注解是否符合业务实际需求。

4. 功能扩展与实战技巧

4.1 自定义业务逻辑增强

代码生成器产生的是基础CRUD，实际业务中我们通常需要扩展。比如在学生管理中，我经常要添加这些功能：

批量导入：添加Excel导入工具类
复杂查询：在Mapper.xml中添加联合查询
业务校验：如学号唯一性检查

以添加导出功能为例，可以在Controller中添加：

@PostMapping("/export") public void export(HttpServletResponse response, Student student) { List<Student> list = studentService.selectStudentList(student); ExcelUtil<Student> util = new ExcelUtil<>(Student.class); util.exportExcel(response, list, "学生数据"); }

4.2 性能优化建议

当数据量增大时，需要做一些优化处理：

在分页查询中添加索引提示
对大文本字段（如家庭住址）做延迟加载
使用若依自带的Redis缓存注解

@Cacheable(key = "#studentId", value = "studentCache") public Student selectStudentById(Long studentId) { return studentMapper.selectStudentById(studentId); }