别再手动CRUD了！用若依RuoYi-Vue的代码生成器，5分钟搞定商品管理模块

5分钟极速开发用若依代码生成器构建商品管理系统实战在中小企业的实际开发场景中商品管理模块几乎是每个电商类项目的标配。传统开发模式下我们需要手动编写Controller、Service、Mapper层的基础CRUD代码再逐个调试前端页面组件——这个过程往往要消耗大半天时间。而今天要介绍的若依RuoYi-Vue框架代码生成器能将这个流程压缩到5分钟以内。1. 环境准备与框架启动1.1 基础环境配置开始前请确保已安装以下组件Java 8推荐JDK11MySQL 5.7若依默认使用MySQL语法Maven 3.6用于后端依赖管理Node.js 12前端Vue项目构建Redis 5用于会话管理和缓存提示建议使用Docker快速部署MySQL和Redis服务避免环境配置问题1.2 项目初始化步骤克隆项目仓库git clone https://gitee.com/y_project/RuoYi-Vue.git导入SQL文件-- 执行项目sql目录下的quartz.sql和ry_20230223.sql source /path/to/RuoYi-Vue/sql/ry_20230223.sql修改配置文件# ruoyi-admin/src/main/resources/application.yml spring: datasource: url: jdbc:mysql://localhost:3306/ry?useSSLfalse username: root password: yourpassword redis: host: localhost port: 6379启动后端服务mvn spring-boot:run启动前端服务cd ruoyi-ui npm install npm run dev访问http://localhost:80即可看到若依的登录界面默认账号admin/123456。2. 数据库表设计与导入2.1 商品表结构设计我们以电商场景常见的商品表为例CREATE TABLE goods ( id bigint NOT NULL AUTO_INCREMENT COMMENT 商品ID, name varchar(100) NOT NULL COMMENT 商品名称, category_id bigint DEFAULT NULL COMMENT 分类ID, price decimal(10,2) DEFAULT 0.00 COMMENT 售价, cost_price decimal(10,2) DEFAULT NULL COMMENT 成本价, stock int DEFAULT 0 COMMENT 库存, cover_image 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 更新时间, remark varchar(500) DEFAULT NULL COMMENT 备注, PRIMARY KEY (id) ) ENGINEInnoDB DEFAULT CHARSETutf8mb4 COMMENT商品表;2.2 导入表到代码生成器登录系统后进入系统工具→代码生成点击导入按钮选择刚才创建的goods表在生成配置页面设置以下关键参数配置项建议值说明生成模块名goods对应业务模块名称作者你的名字生成的代码注释作者包路径com.ruoyi.goodsJava包结构前端路径goodsVue组件存放目录3. 代码生成与配置3.1 生成器核心配置技巧在生成代码前有几个关键配置需要注意字段校验规则为价格类字段添加DecimalMin校验字典类型映射将status字段关联到系统字典主子表关联如需关联商品SKU表可在此配置// 自动生成的实体类示例片段 public class Goods extends BaseEntity { Excel(name 商品名称) NotBlank(message 商品名称不能为空) private String name; Excel(name 售价) DecimalMin(value 0.01, message 售价必须大于0) private BigDecimal price; Excel(name 状态, readConverterExp 0下架,1上架) private String status; }3.2 一键生成操作流程点击生成代码按钮下载zip包解压后将文件分别放置到对应目录后端代码复制到ruoyi-admin模块前端代码复制到ruoyi-ui/src/views/goods执行以下命令使改动生效# 后端 mvn clean install # 前端 npm run dev注意首次生成后需要重启后端服务使新API生效4. 功能验证与效果展示4.1 生成的功能清单代码生成器自动创建了完整的CRUD功能前端商品列表页带分页、查询条件新增/编辑表单删除/导出操作后端Controller层RESTful接口Service层业务逻辑Mapper层数据库操作实体类与DTO4.2 实际效果对比传统开发与代码生成效率对比任务手动开发耗时代码生成耗时后端CRUD接口4小时30秒前端列表页3小时30秒前端表单页2小时30秒联调测试2小时10分钟总计11小时5分钟4.3 高级定制技巧虽然生成的代码开箱即用但实际项目中通常需要定制添加复杂查询// 在GoodsServiceImpl中添加 public ListGoods listWithCategory(GoodsQuery query) { return goodsMapper.selectGoodsListWithCategory(query); }扩展前端功能!-- 在goods.vue中添加导出按钮 -- el-button typewarning iconel-icon-download clickhandleExport 导出Excel/el-button添加业务校验Service public class GoodsServiceImpl implements IGoodsService { Override public void checkGoodsStock(Long goodsId, int quantity) { Goods goods goodsMapper.selectGoodsById(goodsId); if (goods.getStock() quantity) { throw new ServiceException(库存不足); } } }5. 常见问题排查5.1 代码生成后404错误可能原因及解决方案后端未重启新增Controller需要重启应用权限未配置在系统管理→菜单管理中添加对应路由前端路由冲突检查router/index.js中的路由配置5.2 表单提交报错典型错误处理// 前端拦截器添加错误处理 service.interceptors.response.use( response { const res response.data if (res.code ! 200) { Message({ message: res.msg || Error, type: error, duration: 5 * 1000 }) return Promise.reject(new Error(res.msg || Error)) } return res } )5.3 性能优化建议对于高频访问的商品接口添加Redis缓存Cacheable(value goods, key #goodsId) public Goods getGoodsById(Long goodsId) { return goodsMapper.selectGoodsById(goodsId); }启用MyBatis二级缓存!-- 在mapper.xml中添加 -- cache evictionLRU flushInterval60000/前端分页优化// 使用keep-alive缓存列表组件 keep-alive router-view v-if$route.meta.keepAlive / /keep-alive在最近的一个社区团购项目中我们使用若依代码生成器在3天内完成了原本需要2周的基础开发工作。特别是商品管理模块从数据库设计到上线测试只用了不到1小时这让我们有更多时间专注于优惠券系统等核心业务的开发。