若依框架使用教程

一刻也没有为期末考试的结束而欢呼，立马赶到战场的是暑期实习（悲）。在实习摸鱼的时候偷偷把若依框架的教程做了。看着好久没更新的博客，本着能水一篇是一篇的精神，便把教程搬到了博客上。我还只是一个菜鸟，如果有什么不对的地方欢迎指出。

1.前情提要

配置Redis环境

下载地址：https://github.com/redis-windows/redis-windows

解压后运行install_redis_service

输入要安装的路径，路径内必须为空，回车两次

打开任务管理器ctrl+shift+esc

输入redis，看到redis-server和RedisService证明安装成功

2.启动若依框架

若依文档：https://doc.ruoyi.vip/ruoyi/

若依框架分离版下载地址：https://gitee.com/y_project/RuoYi-Vue

可用git进行下载或直接下载zip

1.若依后端启动

找到数据库文件ruoyi-admin/src/main/resources/application-druid.yml

将密码修改为自己的数据库密码，圈出部分为数据库名称，按需修改

打开navicat，创建数据库，名称与圈出部分相同

将若依框架中sql文件夹中的两个文件分别拖入navicat新建数据库的表中

刷新表

找到ruoyi-admin/src/main/java/com/ruoyi/RuoYiApplication.java

运行文件

显示“若依启动成功”后端启动完毕

如果没有Run Java选项，就去安装java的拓展

2.若依前端启动

在ruoyi -ui文件夹中启动cmd或powershell

输入：npm install —registry=https://registry.npmmirror.com

输入：npm run dev

如果出现报错，先输入：set NODE_OPTIONS=–openssl-legacy-provider

再输入：npm run dev

若依前端启动完成

3.若依项目目录结构

根目录结构：

ruoyi/
├── ruoyi-admin      // 后台管理模块（核心模块）
├── ruoyi-common    // 通用工具模块
├── ruoyi-framework // 框架核心模块
├── ruoyi-generator // 代码生成模块
├── ruoyi-quartz    // 定时任务模块
├── ruoyi-system    // 系统模块
└── ruoyi-ui       // 前端UI模块（Vue2版本）

后台管理：

ruoyi-admin/
├── src/
│   ├── main/
│   │   ├── java/com/ruoyi/web/      // 控制器层
│   │   │   ├── controller/          // 控制器
│   │   │   └── ...                 // 其他web层代码
│   │   ├── resources/
│   │   │   ├── static/              // 静态资源
│   │   │   ├── templates/           // 模板文件
│   │   │   ├── application.yml      // 应用配置
│   │   │   └── ...                 // 其他资源文件
│   │   └── webapp/                  // web资源(可选)
│   └── test/                        // 测试代码
└── pom.xml                          // 模块依赖

通用工具：

ruoyi-common/
├── src/
│ ├── main/
│ │ ├── java/com/ruoyi/common/
│ │ │ ├── annotation/ // 自定义注解
│ │ │ ├── config/ // 通用配置
│ │ │ ├── constant/ // 通用常量
│ │ │ ├── core/ // 核心工具
│ │ │ ├── enums/ // 枚举类
│ │ │ ├── exception/ // 异常类
│ │ │ ├── utils/ // 工具类
│ │ │ ├── xss/ // XSS过滤
│ │ │ └── … // 其他通用代码
│ │ └── resources/
│ │ └── … // 通用资源
└── pom.xml

框架核心：

ruoyi-framework/
├── src/
│   ├── main/
│   │   ├── java/com/ruoyi/framework/
│   │   │   ├── aspectj/            // 切面编程
│   │   │   ├── config/             // 框架配置
│   │   │   ├── datasource/         // 数据源
│   │   │   ├── interceptor/        // 拦截器
│   │   │   ├── manager/            // 异步管理器
│   │   │   ├── security/           // 安全模块
│   │   │   ├── web/                // web相关
│   │   │   └── ...                 // 其他框架代码
│   │   └── resources/
│   │       └── ...                 // 框架资源
└── pom.xml

系统模块：

ruoyi-system/
├── src/
│   ├── main/
│   │   ├── java/com/ruoyi/system/
│   │   │   ├── domain/             // 实体类
│   │   │   ├── mapper/             // 数据访问层
│   │   │   ├── service/            // 服务层
│   │   │   └── ...                 // 其他系统代码
│   │   └── resources/
│   │       ├── mapper/             // MyBatis映射文件
│   │       └── ...                 // 系统资源
└── pom.xml

代码生成：

ruoyi-generator/
├── src/
│   ├── main/
│   │   ├── java/com/ruoyi/generator/ // 代码生成逻辑
│   │   └── resources/
│   │       ├── templates/           // 代码生成模板
│   │       └── ...                 // 生成器配置
└── pom.xml

定时任务：

ruoyi-quartz/
├── src/
│   ├── main/
│   │   ├── java/com/ruoyi/quartz/   // 定时任务逻辑
│   │   └── resources/
│   │       └── ...                 // 定时任务配置
└── pom.xml

前端vue项目：

ruoyi-ui/
├── public/                         // 公共资源
├── src/
│   ├── api/                        // API请求
│   ├── assets/                     // 静态资源
│   ├── components/                 // 公共组件
│   ├── directive/                  // 自定义指令
│   ├── layout/                     // 布局组件
│   ├── router/                     // 路由配置
│   ├── store/                      // Vuex状态管理
│   ├── utils/                      // 工具类
│   ├── views/                      // 页面视图
│   ├── App.vue                     // 根组件
│   └── main.js                     // 入口文件
├── package.json                    // 依赖配置
└── vue.config.js                   // Vue配置