RuoYi 若依框架 前后端分离版 使用总结 (傻瓜式操作)
环境
JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本)
Redis >= 3.0
Maven >= 3.0
Node >= 12
下载完成记得配置环境变量,且运行Redis。
导入项目
下载项目
直接在:https://gitee.com/y_project/RuoYi-Vue 下载zip包即可
导入项目:
下载后解压,然后idea打开项目即可。
运行后端
数据库创建
- 创建数据库ry-vue
- 导入数据脚本ry_2021xxxx.sql,quartz.sql
(直接复制sql语句,新建查询一样)
修改数据库连接
编辑
-\ruoyi-admin\src\main\resources
目录下的application-druid.yml
# 数据源配置
spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driverClassName: com.mysql.cj.jdbc.Driver
druid:
# 主库数据源
master:
url: 数据库地址
username: 数据库账号
password: 数据库密码
运行
打开项目运行com.ruoyi.RuoYiApplication.java,出现如下图表示启动成功。
(♥◠‿◠)ノ゙ 若依启动成功 ლ(´ڡ`ლ)゙
.-------. ____ __
| _ _ \ \ \ / /
| ( ' ) | \ _. / '
|(_ o _) / _( )_ .'
| (_,_).' __ ___(_ o _)'
| |\ \ | || |(_,_)'
| | \ `' /| `-' /
| | \ / \ /
''-' `'-' `-..-'
运行前端
安装依赖
点击idea下方的 终端
输入以下命令即可。
# 进入项目目录
cd ruoyi-ui
# 安装依赖(只需要进行一次)
npm install --registry=https://registry.npmmirror.com
运行
输入以下命令:
# 本地开发 启动项目
npm run dev
如果想关闭项目:同时按下Ctrl键和c键
,然后输入y
即可退出前端。
代码生成 - 自动生成简单代码
推荐博客
若依管理系统RuoYi-Vue(三):代码生成器原理和实战
修改代码生成器配置
这步可做可不做
目的:修改生成代码的以下配置
author: wwz # 开发者姓名,生成到类注释上
packageName: com.ruoyi.student # 默认生成包路径
autoRemovePre: true # 是否自动去除表前缀
tablePrefix: stu # 表前缀
实现:
- 单应用:编辑ruoyi-admin中resources目录下的application.yml
- 多模块:编辑ruoyi-generator中的resources目录下的generator.yml
注意:表名要和表前缀匹配. (不匹配好像也没啥事)
例如表前缀是stu
,那表名就是要stu_xxx
准备数据库 表结构
若依建表有个要求:表字段 和 表,都需要加注释
,而且id自增,否则后面会报错。
而且注释就是生成页面的显示内容
drop table if exists stu_student;
create table stu_student (
student_id int(11) auto_increment comment '编号',
student_name varchar(30) default '' comment '学生名称',
student_age int(3) default null comment '年龄',
student_hobby varchar(30) default '' comment '爱好(0代码 1音乐 2电影)',
student_sex char(1) default '0' comment '性别(0男 1女 2未知)',
student_status char(1) default '0' comment '状态(0正常 1停用)',
student_birthday datetime comment '生日',
primary key (student_id)
) engine=innodb auto_increment=1 comment = '学生信息表';
导入表并生成代码
打开ruoyi系统的代码生成器,点击导入会看到我们刚刚创建的表,勾选后导入。
导入后点击 [编辑]
然后点击[生成信息] :
建议把生成模块名和生成业务名写的不一样,否则后面可能会遇到问题。
然后点击生成代码即可。
名称说明
这里说明一些上面填的东西会生成什么
生成包路径 com.ruoyi.student,就是生成的后端代码的包路径
生成模块名和生成业务名一起构成后端代码里自动生成的请求路径,即页面路径
具体来说:
- 模块名就是我们系统的模块名
- 业务名就是我们这个表的功能是什么
新建模块
这不也是不一定做,需要多模块就做;不需要,直接放在ruoyi-admin也行(可能)
新建一个模块
在ruoyi项目顶层文件夹右键 \(\to\) 新建 \(\to\) 新模块。(新版idea需要点击创建maven模板
)
记得改名,其余默认即可
添加通用模块依赖
在新建模块下的pom.xml里面,添加通用模块依赖
<!-- 通用工具-->
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>ruoyi-common</artifactId>
<version>${ruoyi.version}</version>
</dependency>
添加后结构如下:
根目录,声明节点和添加模块
在根目录pom.xml依赖声明节点dependencies中添加依赖,并且添加模块
<!-- 学生模块-->
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>student</artifactId>
<version>${ruoyi.version}</version>
</dependency>
<module>student</module>
添加后结构如下:
ruoyi-admin,添加模块依赖
在ruoyi-admin目录pom.xml添加模块依赖
<!-- 学生模块-->
<dependency>
<groupId>com.ruoyi</groupId>
<artifactId>student</artifactId>
</dependency>
添加后结构如下:
导入代码文件
导入zip代码文件
新生成的模块java和resource里面是没有东西的。故需要我们把zip文件里面的文件拷贝进来
如果是原本的模块,也是按照对应目录复制即可。
-
后端: 将自动生成的代码文件main目录直接复制到我们的新建模块的src下,替换原本的main目录。
-
前端: 打开zip里面的vue文件夹,会有两个api和views文件夹,对应着前端项目ruoyi-ui里面的src里面的api和views文件夹
我们只需要按照生成代码的层次 把zip压缩包里的api里面文件和views里面的文件拷贝到对应的前端项目文件夹即可。 -
数据库: 对于
xxxxMenu.sql
文件,用来生成菜单的,去数据库里执行一下这个SQL即可。
步骤:打开文件 -> 复制内容;打开Navicat(或者其他工具)-> 新建查询 -> 粘贴代码 -> 运行。
重启项目,访问页面
大功告成
问题解决
mybatis问题 - 实体类未找到Cause: java.lang.ClassNotFoundException: Cannot find class: PetFoods
如果
解决方案:
- 打开
ruoyi-admin/src/main/resources/application.yml
- 指定要扫描的Mapper类的包的路径typeAliasesPackage包路径名称替换com.xxxxx
# MyBatis
mybatis:
# 搜索指定包别名
typeAliasesPackage: com.你的包名.**.domain