一、若依简介
若依（RuoYi）框架是一款基于Spring Boot、Spring Cloud等开源框架搭建的企业级开发平台。它的主要目标是提供全面的解决方案，以简化企业级应用开发，提高开发效率。以下是对若依框架的详细介绍：
- 模块化设计：若依框架采用模块化的设计，使得应用可以根据需求进行灵活的扩展和定制。每个模块都可以独立部署和升级，这大大提高了系统的可维护性和可扩展性。
- 前后端分离：框架采用前后端分离的开发模式，后端专注于数据处理和API接口的提供，前端则负责页面的展示和用户交互。这种模式使得前后端职责明确，进一步提高了开发效率和代码的可维护性。
- 权限管理：若依框架提供了完善的用户权限管理功能，包括角色管理、菜单授权、部门管理等，便于对系统权限进行灵活的配置和管理。
- 代码生成器：框架内置代码生成器，能够快速生成前后端代码，减少重复劳动，提高开发效率。通过简单的配置即可生成基础的增删改查代码。
- 定时任务：若依框架集成了定时任务模块，支持动态添加定时任务，可以通过界面对定时任务进行管理与调度。此外，框架还能实时查看系统运行日志和在线用户信息，监控服务状态和性能。
- 易于集成：若依框架可以轻松地与其他常用技术栈集成，如MySQL、Redis、消息队列等。这使得开发者可以根据项目需求灵活地选择合适的技术组件，降低技术门槛和成本。
官网：https://ruoyi.vip/
若依框架分为四个版本：
- 前后端不分离版本RuoYi（单体）。
- 前后端分离版RuoYi-Vue（单体）本项目使用版本。
- 微服务版本RuoYi-Cloud。
- 移动端版RuoYi-App。
RuoYi-Vue 是一个 Java EE 企业级快速开发平台，基于经典技术组合（Spring Boot、Spring Security、MyBatis、Jwt、Vue），内置模块如：部门管理、角色用户、菜单及按钮授权、数据权限、系统参数、日志管理、代码生成等。在线定时任务配置；支持集群，支持多数据源，支持分布式事务。
环境要求：
官方推荐：
JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本)
Redis >= 3.0
Maven >= 3.0
Node >= 12 vue2升级为vue3，需要Node 18及以上的版本
二、使用若依
下载代码：https://ruoyi.vip/
1.编码设置为UTF-8。2.JDK设置为11。3.配置Maven。
sql执行成功以后，修改数据库连接，找到ruoyi-admin模块中的resources目录下的application-druid.yml。
# 数据源配置
spring:datasource:type: com.alibaba.druid.pool.DruidDataSourcedriverClassName: com.mysql.cj.jdbc.Driverdruid:# 主库数据源master:url: jdbc:mysql://192.168.100.129:3306/ry-zzyl?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8username: rootpassword: root123
找到ruoyi-admin模块中的resources目录下的application.yml，如下配置：
# Spring配置
spring:redis:# 地址host: 192.168.100.129# 端口，默认为6379port: 6379# 数据库索引database: 0# 密码password: 123456# 连接超时时间timeout: 10slettuce:pool:# 连接池中的最小空闲连接min-idle: 0# 连接池中的最大空闲连接max-idle: 8# 连接池的最大数据库连接数max-active: 8# #连接池最大阻塞等待时间（使用负值表示没有限制）max-wait: -1ms
运行前端i项目：
npm install
npm run dev
npm代码：
node -v
npm config set prefix "F:\DevTools\nodejs"npm config set registry https://registry.npmmirror.com
npm config set registry https://developer.aliyun.com/mirror/npm
npm config set registry https://registry.npm.taobao.org
npm init vue@latest
2.替换artifactID：
3.定制化UI界面：
-
登录名称及背景图：
组件位置：src/views/login.vue：
![在这里插入图片描述]()
背景图：
![在这里插入图片描述]()
-
logon替换：
替换前端中的public文件夹，替换原有的favicon.ico。
修改根目录下的index.html文件。
关于环境的文件一般有三个：
- .env.development 开发环境的配置，默认的环境。
- .env.production 生产环境。
- .env.staging 测试环境。
在打包或启动项目的时候，可以加参数来使用不同的环境，需要参考package.json中的配置。
4.使用Swagger：
依赖：
<!-- swagger3--><dependency><groupId>io.springfox</groupId><artifactId>springfox-boot-starter</artifactId></dependency><!-- 防止进入swagger页面报类型转换错误，排除3.0.0中的引用，手动增加1.6.2版本 --><dependency><groupId>io.swagger</groupId><artifactId>swagger-models</artifactId><version>1.6.2</version></dependency>
核心配置类：.core.config.SwaggerConfig。
- 集成knife4j ：https://doc.ruoyi.vip/ruoyi-vue/document/cjjc.html#%E9%9B%86%E6%88%90knife4j%E5%AE%9E%E7%8E%B0swagger%E6%96%87%E6%A1%A3%E5%A2%9E%E5%BC%BA
引入依赖：
<!-- ruoyi-springboot2 / swagger knife4j 配置 -->
<dependency><groupId>com.github.xiaoymin</groupId><artifactId>knife4j-spring-boot-starter</artifactId><version>3.0.3</version>
</dependency>
设置ui\views\tool\swagger\index.vue跳转地址
src: process.env.VUE_APP_BASE_API + "/doc.html",
常用注解：
//注解
@Api
@ApiOperation
@ApiParam
@ApiImplicitParam
@ApiModel
@ApiModelProperty
6.创建菜单：创建子菜单：
系统管理=>菜单管理=>新增
创建子菜单：
系统工具=>代码生成=>导入=>选中表导入=>编辑配置
7.新建模块：
https://doc.ruoyi.vip/ruoyi/document/htsc.html#%E6%96%B0%E5%BB%BA%E5%AD%90%E6%A8%A1%E5%9D%97
新建子模块：
Maven多模块下新建子模块流程案例。
1、新建业务模块目录，例如：yyyl-mokuai。
2、在yyyl-mokuai业务模块下新建pom.xml文件以及src\main\java，src\main\resources目录。
3、根目录pom.xml依赖声明节点dependencies中添加依赖
4、根目录pom.xml模块节点modules添加业务模块
5、yyyl-admin目录pom.xml添加模块依赖
6、测试模块
在yyyl-mokuai业务模块添加com.yyyl.mokuai包，新建TestService.java
在yyyl-admin新建测试类，调用helloTest成功返回hello代表成功。