RuoYi是一套后台管理系统,基于经典技术组合(Spring Boot、Spring Security、MyBatis、Thymeleaf)主要目的让开发者注重专注业务,降低技术难度,从而节省人力成本,缩短项目周期,提高软件安全质量。目前提供单体应用、前后端分离和微服务版本,还不知道的同学可以到其官网详细了解并在线体验。
基于这个框架开发,可以使用他已经提供的能力,如用户管理、角色管理、权限管理、菜单管理、日志审计、数据字典、定时任务等实用功能,本次微信加油站管理系统使用前后端分离版本,主要原因是前后端分离是现在的主流开发模式,其次前后端分离能够完全区分前端和后端的工作,各司其职更利于提高开发效率,接下我们将下载源码并在本地运行起来,后期的系统开发将在这套源码上进行。
下载Ruoyi源码
打开浏览器进入gitee仓库,https://gitee.com/y_project/RuoYi-Vue,目前最新的版本为3.8.5,直接下载master分支代码,为方便开发时代码管理,建议将其导入自己的代码仓库;
目录结构说明
打开下载的源码,目录结构如下图,将比较重要的目录介绍一下:
ruoyi-admin 项目启动入口,引用了其他业务模块,数据库等配置均在这个项目中配置;
ruoyi-generator 基于mybatis的代码生成模块,可生成前后端和菜单配置代码,后面将会使用这个模块来快速完成业务功能开发;
ruoyi-ui 管理界面的源码,基于vue+elementui构建;
sql 系统数据库和quartz的初始化脚本;
导入项目
源码中doc目录下有《若依环境使用手册.docx》,介绍了在eclipse中的导入步骤,在idea中导入方式相似,选择File->Open,选择到源码目录即可;
初始化数据库
这里需要注意以下,ruoyi最新版本使用的是mysql8的驱动,初始化数据库的时候请选择mysql8.0以上版本,否则可能出现其他错误。
打开mysql管理工具,新建数据库ry-vue-385,名字可以随便起,然后执行源码中sql文件夹下的ry_20220822.sql和quartz.sql两个脚本即完成数据库初始化。
修改参数配置
打开ruoyi-admin项目,打开application.yml文件,找到redis配置,修改为自己本地的配置:
redis:
# 地址
host: localhost
# 端口,默认为6379
port: 6379
# 数据库索引
database: 0
# 密码
password: 123456
# 连接超时时间
timeout: 10s
打开application-druid.yml文件,找到数据库配置修改为自己本地的配置,开发阶段我们只配置主库数据源就可以了:
spring:
datasource:
type: com.alibaba.druid.pool.DruidDataSource
driverClassName: com.mysql.cj.jdbc.Driver
druid:
# 主库数据源
master:
url: jdbc:mysql://localhost:3306/ry-vue-385?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
username: root
password: 123456
至此,运行参数修改完成。
运行项目
在ruoyi-admin项目中找到RuoYiApplication文件,执行main方法,在Console窗口中看见如下输出,则表示后端项目启动成功了。
22:44:16.074[restartedMain]INFOc.r.RuoYiApplication-[logStarted,61]-StartedRuoYiApplicationin9.731seconds(JVMrunningfor11.611)
(♥◠‿◠)ノ゙若依启动成功ლ(´ڡ`ლ)゙
运行前端
前端基于vue+elementui构建,需要现在电脑上安装node.js环境,可下载node-v12及以上版本;
用vscode打开源码中ruoyi-ui目录,按照目录中README.md中的步骤,依次执行npm install,npm run dev运行项目;
验证项目
打开http://localhost,若出现登陆界面则前端项目编译正常,若验证码显示正常则表示与后端连接也正常,输入默认账号密码admin/admin123即可登录系统。
至此,ruoyi系统在本地就运行起来了,下一篇,我们将对若依系统进行一个小的改造,让其在后期的开发更加减少开发代码量。