一. 初始化准备
1. 官方文档:项目简介 (dromara.org)https://plus-doc.dromara.org/#/ruoyi-vue-plus/home
2. 后端代码:RuoYi-Vue-Plus: 多租户后台管理系统 重写RuoYi-Vue所有功能 集成 Sa-Token、Mybatis-Plus、Flowable、SpringDoc、Hutool、OSS 定期同步 (gitee.com)https://gitee.com/dromara/RuoYi-Vue-Plus 3. 前端代码:plus-ui: RuoYi-Vue-Plus 5.X 与 RuoYi-Cloud-Plus 2.X 统一 UI 前端代码仓库 问题请到主框架反馈 (gitee.com)https://gitee.com/JavaLionLi/plus-ui 4. MySQL支持 5.7及以上,Redis 5.x及以上,jdk 17以上
二. 启动服务
1. 启动后端服务
解压好之后,使用ide软件打开,配置好maven ,jdk。
修改配置文件
点击ruoyi-admin文件夹下的src目录
进入application.yml文件
按住CTRL+F 搜索 tenant ,把enable 修改为false。
修改mysql 和redis 的连接,确保mysql 和 redis 在后台运行
选择application-dev.yml 文件,找到主库数据源配置,配置好数据库名称(默认是ry-vue)账号,密码
配置redis,如果没有配置redis密码,没有密码要注释密码那一行
创建数据库
导入数据库,数据在script 文件夹中的sql 文件中
启动项目,确保maven 的依赖下载完成。刷新maven,选择配置文件为dev。
显示这样就是启动成功了。
2. 启动前端
解压好后使用vscode 打开,终端输入 npm i (如果node 或者 npm包管理器没有安装或者版本过低,查询其他教程解决)
依赖安装完成,输入npm run dev 启动前端,成功启动状态如下。后端默认端口:8080,前端默认端口:80。 默认管理员账号为:admin,密码为:admin123。
三. 新增业务
1. 新增菜单
点击侧边栏的系统管理的菜单管理
点击新增按钮
新增一个目录
点击刚刚新增的目录新增一个菜单
其中的路由地址,组件地址要和生成页面的地方相对应的。创建好后效果如下
刷新之后页面,侧边栏会多出群体活动的目录,俱乐部的菜单
2. 创建数据表
打开对应的数据库,点击新建表
填写字段,要保持下划线命名,一定要填写对应的注释,其中标红的字段最好都填写上去,若依会通过MybatisPlus帮助其自动填充。填写完成记得保存。
ps: 为了让del_flag添加的时候默认为0,要进行一些操作,输入这个条sql,ALTER TABLE club MODIFY del_flag INT DEFAULT 0; 意为在club表中,del_flag字段默认值为0。
3. 创建模块
找到ruoyi-modules,鼠标右键,新建,新模块。
填写模块名称,语言java,构建系统Maven,JDK选择构建系统一样的版本
在ruoyi-admin的pom.xml,填写模块依赖
在父文件下的pom.xml,引入依赖,其中的version版本最好填写${revision}。
点击右侧侧边栏的maven,刷新maven
4. 代码生成
点击侧边栏
点击导入,选择对应的数据表,点击确定
点击对应 的数据表进行编辑
基本信息中可以配置信息,默认都可以,基本不用修改
字段信息是最重要的配置
主键我个人习惯是通过MyBatisPlus自动生成的
插入: 勾选后,新增后,表单上会出现该字段的新增项,如id,后台如果随机生成,这里可以不勾选
编辑:勾选后,编辑时候展示对应字段项,不勾选不展示
列表:查询后页面展示字段,不勾选不展示
查询:勾选后页面呈现对应查询条件,后面查询方式可选择 = 、!=、like、 > 、<等
显示类型:可选择 文本框、下拉选、日期组件、富文本框等
字典类型:关联字典值,比如性别等,可以选择
修改生成包路径和生成模块名为你创建的模块,确认信息无误,点击提交。
下载对应的代码,解压后打开。
把生成的sql文件导入到对应对的数据库中。
把main文件导入到后端对应的文件模块中。复制整个main文件到模块中。
点击打开main文件夹中的Java文件找到controller,点开会有很多爆红报错。
鼠标移至爆红处下边点击导入类
导入成功后应该没有爆红报错,效果如下
找到domain下的新创建的实体类Club,复制主键 clubId,黏贴到bo,vo中对应的类
后端club的基础代码就添加好了,其他业务根据需求合理的添加,修改代码。重启服务看看是否启动正常。
前端文件vue,点击打开
复制到前端文件对应的位置
四. 功能使用
点击原先创建的菜单
测试基础功能增删改查
PS:应为设置了del_flag的字段,数据没有真正的被删除,是软删除,在数据中打开修改对应的数据del_flag 改为0 ,数据可以重新出现。