1 若依搭建
前后端分离版本:RuoYi-Vue利用SpringBoot作为后端开发框架,与Vue.js结合,实现了前后端分离的开发模式。这种架构有助于提高开发效率,前后端可以独立开发和部署,更适合现代化的Web应用开发。
RuoYi-Vue3(前端升级Vue3 Element Plus Vite)
https://github.com/yangzongzhuan/RuoYi-Vue3
RuoYi-Vue-Plus(后端集成Mybatis-Plus、Hutool、OSS存储、分布式锁等组件)
https://gitee.com/dromara/RuoYi-Vue-Plus
RuoYi-Vue
RuoYi-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
2 初始化项目
后端
Git下载
通过idea克隆若依源码,仓库地址:https://gitee.com/y_project/RuoYi-Vue.git
Maven构建
导入sql
1、创建数据库create schema ry-vue;
2、执行下图的sql脚本文件,完成导入
3、导入后ry-vue库内置30张表
配置信息
- 在ruoyi-admin模块下,编辑resources目录下的application-druid.yml,修改数据库连接。
- 启动Redis
- 修改Redis配置文件
项目运行
在ruoyi-admin模块下,运行com.ruoyi.RuoYiApplication.java,出现如下图表示启动成功
前端
进入开发目录下,使用vscode命令code打开项目
# 克隆vue3项目
git clone https://gitee.com/ys-gitee/RuoYi-Vue3.git# 通过vscode打开项目
code ./RuoYi-Vue3
在vscode终端中输入以下命令:
# 安装依赖
npm install# 建议不要直接使用 cnpm 安装依赖,会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
npm install --registry=https://registry.npmmirror.com# 启动服务
npm run dev
打开浏览器,输入:([http://localhost:80) 默认账户/密码 admin/admin123)若能正确展示登录页面,并能成功登录,菜单及页面展示正常,则表明环境搭建成功
3 入门案例
功能需求
实现CRM系统中的课程管理功能,涵盖增加、删除、修改和查询课程信息的完整前后端代码。
步骤
1、准备课程表结构和数据sql文件,导入到数据库中
2、登录系统(系统工具 -> 代码生成 -> 导入课程表)
3、代码生成列表中找到课程表(可预览、编辑、同步、删除生成配置)
4、点击生成代码会得到一个ruoyi.zip
5、执行sql文件导入菜单,按照包内目录结构复制到自己的项目中即可
4 功能详解
系统管理
权限系统
例如:
- demo账号(超级管理员),可以查看所有功能菜单
- zhangsan账号(市场专员),可以查看线索管理菜单
- yueyue账号(销售专员),可以查看商机、合同等菜单
RBAC
RBAC(基于角色的访问控制)是一种广泛使用的访问控制模型,通过角色来分配和管理用户的菜单权限。
数据字典
若依内置的数据字典,用于维护系统中常见的静态数据。例如:性别、状态…
功能包括:字典类型管理、字典数据管理
表关系
步骤
①添加字典类型和数据
②修改代码生成信息
③下载代码,导入前端
参数设置
参数设置:对系统中的参数进行动态维护。
比如:关闭登录验证码
通知公告
RuoYi的通知公告功能提供了一个方便的方式来发布和管理通知、公告和新闻等信息。管理员可以创建、编辑和删除通知(支持富文本编辑和附件上传)。
系统将信息发送给指定的用户、部门或角色。用户可以通过系统界面或电子邮件接收通知,从而确保信息及时传达(这部分需要自己开发)。
通知公告功能有助于组织内部沟通和信息传递,提高了工作效率和信息共享。
日志管理
登录日志
- 记录用户的登录信息,包括登录时间和地点(IP地址)。
- 帮助管理员监控登录行为,及时发现任何可疑的登录尝试。
- 同样提供搜索和筛选功能,方便查找特定用户的登录历史。
操作日志
- 记录用户在系统中的所有操作,如查看、修改数据等。
- 帮助管理员检查谁做了什么,以及何时做的,确保数据准确无误。
- 可以快速搜索和找到特定的操作记录,便于管理和审查。
系统监控
监控相关
- 在线用户:
- 管理员可以看到当前谁在系统里,他们什么时候登录的,从哪里登录的,属于哪个部门。
- 如果有人没权限还赖着不走,管理员可以一键让他们下线,保证系统的安全。
- 数据监控:
- 管理员可以实时看到系统的各项指标,比如资源使用情况,数据库状态等。
- 通过图表可以直观地看出系统是否健康,如果出现问题,系统会发出警报。
- 服务监控:
- 管理员可以监控系统中各个服务是否正常运行,以及它们的性能指标。
- 如果服务出现问题,系统会立即通知管理员,并通过仪表板展示,方便管理员快速了解情况。
- 缓存监控:
- 管理员可以监控系统的缓存使用情况,比如缓存是否经常被用到,缓存的大小等。
- 系统还可以自动清理缓存,保持数据的新鲜度,如果缓存有问题,也会发出警报。
定时任务
若依为定时任务功能提供方便友好的web界面,实现动态管理任务。
案例
每间隔5秒,控制台输出系统时间。
实现步骤:
①创建任务类
@Component
public class MyTask {public void showTime() {System.out.println("定时任务开始执行:"+new Date());}
}
②添加任务规则
- 任务名称:自定义,如:定时查询任务状态
- 任务分组:根据字典sys_job_group配置,可自行进行配置
- 调用目标字符串:设置后台任务方法名称参数
- 执行表达式:可查询官方cron表达式介绍
- 执行策略:定时任务自定义执行策略
- 并发执行:是否需要多个任务间同时执行
③启动任务
系统工具
表单构建
- 允许用户通过拖放等可视化操作创建表单,比如用来收集数据的表格或调查问卷。
- 可以自定义表单的各个部分,比如添加不同的输入项和设置验证规则,无需编写代码。
- 提供了导出数据、导入数据、分享表单和设置权限的功能,方便数据管理和共享。
实现步骤:
①制作表单并导出
②复制到前端工程
③创建动态菜单
代码生成
- 自动化工具,可以快速生成项目中常用的代码,如数据库操作类、后端控制器、前端页面等。
- 支持根据数据库的表结构反向生成代码,减少手动编写的工作量。
- 提供三种生成模板:单表、 树表、主子表(一对多),可以生成适用于Spring Boot、MyBatis等流行框架的代码,提高开发效率和代码质量。
- 树表是一种展示层级数据的表格,能展开折叠,清晰呈现父子关系,便于管理。