基础应用篇
一、项目搭建
若依为满足多样化的开发需求,提供了多种各具特色的框架版本“

本次我们以 RouYi-Vue版本来学习,采用的是前后端分离的单体架构设计
软件环境:JDK、MySQL、Redis、Maven、Node
技术选型:Spring Boot、Spring Security、MyBatis、Jwt、Vue3、Element-PLus
官方地址:https://gitee.com/y_project/RuoYi-Vue
扩展地址:https://gitee.com/ys-gitee/RuoYi-Vue3
项目搭建流程:
1、Git克隆并初始化项目
通过IDEA的从VSC获取,克隆项目到IDEA中
2、MySQL导入与配置
创建数据库 ry-vue
运行ry的配套SQL文件,将数据库导入
3、启动Redis
运行Redis
4、运行后端项目
运行ry后端启动类
项目Vue3前端搭建流程:
1、Git克隆并初始化项目
通过git克隆项目到本地
2、安装依赖
运行npm i
命令下载项目所需依赖
3、运行前端项目
运行npm run dev
命令来启动项目
到这里,项目就搭建成功了
二、代码生成
1、准备SQL并导入数据库
准备完整的表结构,导入数据库中
2、配套代码生成信息
使用RuoYi代码生成器进行代码生成的功能,将我们导入好的表导入若依
按照业务需求进行代码的配置,及生成信息等
3、下载代码并导入项目
将生成好的代码下载下来
菜单权限表的sql文件导入数据库
main内的文件导入后端项目
vue内的文件导入前端项目
重新运行查看效果
三、功能详解
3.1 系统管理
3.1.1 权限控制:
若依内置了强大的权限控制系统,为企业级项目提供了通用的解决方案。
RBAC(基于角色的访问控制)通过角色来分配和管理用户的菜单权限。
步骤:
1、创建菜单

2、创建角色,并分配权限

3、创建用户,并关联角色

3.1.2 数据字典
创建字典进行维护
1、添加字典类型和数据

2、修改代码生成信息
在若依代码生成器中修改代码生成信息
3、下载代码,导入前端(只需要修改前端页面views)
3.1.3 其他功能
- 参数设置:对系统中的参数进行动态维护
- 通知公告:促进组织内部信息传递
- 日志管理:轻松追踪用户行为和系统运行状况
3.2 系统监控
3.2.1 监控相关
若依提供了一些列强大的监控工具,能够帮助开发者和运维快速了解应用程序的性能状态。
3.2.2 定时任务
若依为定时任务功能提供方便友好的wb界面,实现动态管理任务。
定时任务
1、创建任务类
在ruoyi-quartz/src/main/java/com/ruoyi/quartz/task下创建新的任务类
2、添加任务规则
在若依管理系统/定时任务里创建新的任务规则
3、启动任务
3.3 系统工具
3.3.1 表单构建
表单构建工具,只需要开发者通过图形界面和拖拽等操作,可以快速构建复杂的表单。

构建页面:
1、制作表单并导出
使用若依表单构建功能工具,创建一个新的表单域
2、复制到前端工程
将表单页面导出为vue文件,将它放入我们的前端工程
3、创建动态菜单
创建动态菜单,将我们构建的页面放入菜单当中,编辑所需的信息,之后刷新页面
3.3.2 代码生成
代码生成器,根据数据库表结构自动生成前后端CRUD代码。
提供三种生成模板:单表、树表、主子表(一对多)
树表:
树表是一种展示层级数据的表格,能展开折叠,清晰呈现父子关系,便于管理。

树编码字段:当前编码的主键
树父编码字段:编码等级字段(它所对应的父级编码)
树名称字段:编码名称字段
3.3.3 系统接口
Swagger工具,能够自动生成AP!的同步在线文档,并提供Wb界面进行接口调用和测试
如何在若依项目中使用Swagger工具
四、项目结构
五、二次开发
5.1 新建业务模块
若依框架修改器:
可以一键修改RuoYi框架包名、项目名的工具
- 将我们现有的工程打包为.zip压缩包
- 运行若依修改器,选择若依版本系列
- 填写我们需要更改的名称...之后点击开始执行
- 任务结束,将后端工程切换为新工程即可
- 进入工程,主目录的模块名点击 Shift+F6 更改模块名
- 启动类重命名,更改名字
新建业务子模块:
- 新建子模块 merchant
直接创建新模块 - 父亲工程版本锁定
在父工程的pom.xml文件中创建新建的模块,进行版本锁定 - 在 admin 中添加依赖
在admin模块中的pom.xml文件中创建新建的模块,添加依赖
5.2 菜品管理(主子表)
通义灵码
熟练掌握各种代码,国内最受欢迎的AI编程工具
1、准备SQL并导入数据库
将主子表两张表导入数据库中
2、配置代码生成信息
3、下载代码并导入项目
将下载的代码对应导入数据库、前端、后端
4.升级改造
按照我们的需求更改前后端
5.3 页面调整
将原有的若依页面调整为外卖管理系统的项目标识
1、浏览器标签页icon、标题
2、系统页面中的logo、标题
3、去除源码 & 文档 按钮
4、设置后台管理系统主题风格 自定义图标
5、登陆页面中的标题、背景图更改