记一次若依二开的简单流程

前言: 搞Java后端的应该都知道若依框架，是一个十分强大且功能齐全的开源的快速开发平台，且毫无保留给个人及企业免费使用。很多中小型公司会直接在该系统上进行二次开发使用。本文记录一次使用若依二开零编码的简单实现（简单增删修查）

注意，本文不涉及一句代码，只做流程记录，毫无技术含量

1. 下载运行若依

从gitee上下载若依程序，我下载的是前后端分离单体版本，RuoYi v3.8.6，springboot+vue2，链接如下

https://gitee.com/y_project/RuoYi-Vue

首先下载解压，在idea中导入应用。

在这里插入图片描述

然后在找到sql文件夹，找到ry_xxxx.sql脚本，先建一个数据库，然后执行该脚本创建表及导入基本数据。注意数据库编码选择UTF-8，否则可能报错执行失败。
在这里插入图片描述

修改ruoyi-admin模块中的application-druid.yml中数据库连接参数，改为自己的数据库地址及库名，账号及密码，另外application.yml中检查redis配置是否和自己的环境一样，
在这里插入图片描述

然后启动应用
在这里插入图片描述

2. 运行若依前端vue项目

若依前端vue项目跟springboot项目在一个包中，找到ruoyi-ui文件夹，导入到编辑器即可，我用的是idea，引入项目后，ruoyi-ui路径下的Terminal执行 npm install --registry=https://registry.npmmirror.com 下载相关依赖，我已经下载过了，以下截图仅供参考

npm install --registry=https://registry.npmmirror.com

然后 npm run dev 运行即可，但是高版本node.js可能会报错
在这里插入图片描述

可在package.json文件中，添加 set NODE_OPTIONS=--openssl-legacy-provider 解决
在这里插入图片描述

然后执行 npm run dev，运行vue项目
在这里插入图片描述

3. 删除用不到的模块

用默认的账号密码登录进入系统，可以看到有很多模块，用户管理，角色管理，部门管理等等。根据项目需求可以适当减少相应的模块。例如我不需要定时任务模块，选择将其删除。

像用户管理，角色管理，部门管理等，耦合度比较高，涉及到较大删改，这里不描述，只做最基本实现，所以选择基本0耦合的定时任务模块
在这里插入图片描述

1. 在系统管理中找到角色管理，点击修改普通角色，然后在菜单权限中将定时任务权限去掉
在这里插入图片描述

2. 在菜单管理中找到定时任务菜单项，将定时任务的子菜单（按钮）一一删除，然后将定时任务菜单删除
在这里插入图片描述

刷新页面，发现定时任务菜单消失。

3. 在vue的src中，找到定时任务相关代码，删除即可，例如

/src/views/monitor/job 下两个文件，index和log

/src/api/monitor/job.js 定时任务的封装api

/src/api/monitor/jobLog.js 定时任务日志api

在这里插入图片描述

最后将router.js中有关定时任务的配置删除
在这里插入图片描述

4. 将springboot中定时任务模块移除
在这里插入图片描述

在ruoyi-admin模块中的maven依赖（pom.xml）中，将定时任务依赖删除
在这里插入图片描述

在父类工程的maven依赖中将定时任务有关配置删除，两个位置

其一：
在这里插入图片描述

其二：
在这里插入图片描述

5. 最后到数据库中，将有关定时任务的表删除
在这里插入图片描述

至此，定时任务模块被彻底删除。

4. 添加新模块

添加简单的新模块，若依提供了自动代码生成，只需要将其生成的代码文件复制到适合位置即可，例如我创建一个学生管理模块（仅仅为例子，不考究字段是否合理）

1. 创建数据库表

先将需要添加的模块数据库表设计出来，完成数据库表的创建

CREATE TABLE IF NOT EXISTS `sys_student` (
  `stu_id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '学生id',
  `stu_account` VARCHAR(30) NOT NULL COMMENT '学生账号',
  `stu_name` VARCHAR(30) NOT NULL COMMENT '学生名字',
  `stu_class` CHAR(1) DEFAULT '1' COMMENT '学生年级',
  `email` VARCHAR(50) DEFAULT '' COMMENT '学生邮箱',
  `phonenumber` VARCHAR(11) DEFAULT '' COMMENT '手机号码',
  `sex` CHAR(1) DEFAULT '0' COMMENT '学生性别（0男 1女 2未知）',
  `avatar` VARCHAR(100) DEFAULT '' COMMENT '头像地址',
  `password` VARCHAR(100) DEFAULT '' COMMENT '密码',
  `status` CHAR(1) DEFAULT '0' COMMENT '帐号状态（0正常 1停用）',
  `del_flag` CHAR(1) DEFAULT '0' COMMENT '删除标志（0代表存在 2代表删除）',
  `login_ip` VARCHAR(128) DEFAULT '' COMMENT '最后登录IP',
  `login_date` DATETIME DEFAULT NULL COMMENT '最后登录时间',
  `create_by` VARCHAR(64) DEFAULT '' COMMENT '创建者',
  `create_time` DATETIME DEFAULT NULL COMMENT '创建时间',
  `update_by` VARCHAR(64) DEFAULT '' COMMENT '更新者',
  `update_time` DATETIME DEFAULT NULL COMMENT '更新时间',
  `remark` VARCHAR(500) DEFAULT NULL COMMENT '备注',
  PRIMARY KEY (`stu_id`)
) ENGINE=INNODB AUTO_INCREMENT=101 DEFAULT CHARSET=utf8 COMMENT='学生信息表'

2. 使用若依代码生成创建代码文件

在若依管理台，进入系统工具，点击代码生成，点击导入按钮，勾选刚刚创建的sys_student表，点击确定
在这里插入图片描述

点击编辑，修改sys_student的生成配置
在这里插入图片描述

这里补充一下，若依提供了字典管理，可以通过设置字典，提供下拉框标志与值的对应关系。先到系统管理的字典管理中新增字典，例如我想设置年级的字典，1 → 一年级，2→二年级，依次类推。所以在字典管理中新建字典sys_student_class
在这里插入图片描述

然后找到新建的字典，点击字典类型
在这里插入图片描述

进入字典数据页面，点击新增，创建标志与值的对应关系
在这里插入图片描述

完成创建后回到刚刚的代码生成 - 编辑页面

在学生年级这一项上的显示类型选择下拉框，在该项右边的字典类型中选择刚刚创建的学生年级类型（如果没看到新建的项，先刷新一下页面），其他项根据需求自己设计，点击提交
在这里插入图片描述

然后点击生成代码，浏览器会将代码下载到本地
在这里插入图片描述

3. 将生成代码粘贴到若依代码中

将上面下载的压缩包解压打开，会看到两个文件夹，分别为java代码以及vue代码

建议将java代码按照若依现有规范中，拷贝到对应文件夹，例如

将SysStudentController.java文件拷贝到 /ruoyi-admin/src/main/java/com/ruoyi/web/controller/system/ 中

将SysStudent.java文件拷贝到 /ruoyi-system/src/main/java/com/ruoyi/system/domain/

将SysStudentMapper.java文件拷贝到 /ruoyi-system/src/main/java/com/ruoyi/system/mapper/

将ISysStudentService.java文件拷贝到 /ruoyi-system/src/main/java/com/ruoyi/system/service/

将SysStudentServiceImpl.java文件拷贝到 /ruoyi-system/src/main/java/com/ruoyi/system/service/impl/中

另外