| | |
| | | ## 平台简介 |
| | | [](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus) |
| | | [](https://github.com/JavaLionLi/RuoYi-Vue-Plus) |
| | | [](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus/blob/master/LICENSE) |
| | | [](https://www.jetbrains.com/?from=RuoYi-Vue-Plus) |
| | | <br> |
| | | [](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus) |
| | | []() |
| | | []() |
| | | []() |
| | | |
| | | 基于 RuoYi-Vue 集成 Mybatis-Plus Lombok Hutool 等便捷开发工具 适配重写相关业务 便于开发 定期与 RuoYi-Vue 同步 |
| | | * 前端开发框架 Vue、Element UI |
| | |
| | | * 监控框架 spring-boot-admin 全方位服务监控 |
| | | * 校验框架 validation 增强接口安全性 严谨性 |
| | | * 文档框架 knife4j 美化接口文档 |
| | | * 序列化框架 统一使用 jackson 高效可靠 |
| | | * 代码生成器 一键生成前后端代码 |
| | | * 多数据源框架 dynamic-datasource 支持主从与多种类数据库异构 |
| | | * Redis客户端 采用 Redisson 性能更强 |
| | | * 分布式锁 Lock4j 注解锁、工具锁 多种多样 |
| | | |
| | | ## 参考文档 |
| | | |
| | | 使用框架前请仔细阅读文档重点注意事项 |
| | | <br> |
| | | >[初始化项目 必看](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus/wikis/关于初始化项目?sort_id=4164117) |
| | | > |
| | | >[参考文档 Wiki](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus/wikis/pages) |
| | | |
| | | ## 提问四部曲 |
| | | ### 一、查阅wiki |
| | | 优先在`wiki->重点事项`,查找是否有相关问题及解决方案,尤其是框架更新后产生的问题,多会在wiki中提及 |
| | | |
| | | > [参考文档 Wiki](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus/wikis/pages) |
| | | |
| | | ### 二、借助issues |
| | | 尝试issues中搜索问题关键字(记得选择已完成),看看是否有其他人提出相同问题 |
| | | - `如果有`那么依据评论中的解决方案自行尝试解决 |
| | | - `如果没有`那么提交一个新的issues描述清楚你的问题,需要包含以下内容(优质的issues,能够帮助作者更高效的帮你解决问题): |
| | | - 出现问题的模块或功能或类,总之你要说清楚在哪出的问题 |
| | | - 描述产生问题的相关操作流程,以便复现快速解决 |
| | | - 报错的日志截图,一定是截图,不要复制一堆报错的文本 |
| | | > [issues](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus/issues) |
| | | |
| | | ### 三、百度 |
| | | 大家都懂,不多描述,将关键的报错信息CC->CV到百度中看看大佬们怎么解决的 |
| | | > [百度](http://www.baidu.com) |
| | | |
| | | ### 四、加群 |
| | | 以上三点已经能解决大家绝大部分问题了,如果还有问题没能通过这几种方式解决,那么加群,大家一起在群里探讨一下 |
| | | |
| | | ## 修改RuoYi功能 |
| | | |
| | | ### 依赖改动 |
| | | |
| | | * ORM框架 使用 Mybatis-Plus 3.4.2 简化CRUD (不支持主子表) |
| | | * ORM框架 使用 Mybatis-Plus 简化CRUD (不支持主子表) |
| | | * Bean简化 使用 Lombok 简化 get set toString 等等 |
| | | * 容器改动 Tomcat 改为 并发性能更好的 undertow |
| | | * 分页移除 pagehelper 改为 Mybatis-Plus 分页 |
| | |
| | | * 集成 Feign 接口化管理 Http 请求(如三方请求 支付,短信,推送等) |
| | | * 移除 自带服务监控 改为 spring-boot-admin 全方位监控 |
| | | * 增加 demo 模块示例(给不会增加模块的小伙伴做参考) |
| | | * 增加 redisson 高性能 Redis 客户端 |
| | | * 移除 fastjson 统一使用 jackson 序列化 |
| | | * 集成 dynamic-datasource 多数据源(默认支持MySQL,其他种类需自行适配) |
| | | * 集成 Lock4j 实现分布式 注解锁、工具锁 多种多样 |
| | | |
| | | ### 代码改动 |
| | | |
| | |
| | | * 代码生成模板 增加 文档注解 与 校验注解 简化通用操作 |
| | | * 项目修改为 maven多环境配置 |
| | | * 项目配置修改为 application.yml 统一管理 |
| | | * 数据权限修改为 适配支持单表、多表 |
| | | * 使用 redisson 实现 spring-cache 整合 |
| | | * 增加 mybatis-plus 二级缓存 redis 存储 |
| | | |
| | | ### 其他 |
| | | |
| | | * 同步升级 RuoYi-Vue 3.5.0 |
| | | * GitHub 地址 [RuoYi-Vue-Plus-github](https://github.com/JavaLionLi/RuoYi-Vue-Plus) |
| | | * 单模块 fast 分支 [RuoYi-Vue-Plus-fast](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus/tree/fast/) |
| | | * Oracle 模块 oracle 分支 [RuoYi-Vue-Plus-oracle](https://gitee.com/JavaLionLi/RuoYi-Vue-Plus/tree/oracle/) |
| | | |
| | | ## 关注作者(扫码请备注: "加群") |
| | | |
| | |  |
| | | ## 扫码加群 一起交流 |
| | |  |
| | | |
| | | ## 捐献作者 |
| | | 作者为兼职做开源,平时还需要工作,如果帮到了您可以请作者吃个盒饭 |
| | | <img src="https://images.gitee.com/uploads/images/2021/0525/101654_451e4523_1766278.jpeg" width="300px" height="450px" /> |
| | | <img src="https://images.gitee.com/uploads/images/2021/0525/101713_3d18b119_1766278.jpeg" width="300px" height="450px" /> |
| | | |
| | | ## 重点注意事项 |
| | | |
| | | 若依文档对事务注解的描述 [关于事务](https://doc.ruoyi.vip/ruoyi/document/htsc.html#%E4%BA%8B%E5%8A%A1%E7%AE%A1%E7%90%86) 以下对多数据源事务做补充: |
| | | * 同一个事务下是无法切换数据源的 |
| | | * 禁止 父方法使用 @Transactional 创建事务 子方法使用 @DataSource 切换数据源 |
| | | * 正确用法: 子方法单独创建事务 或 父方法使用 @Transactional(propagation = Propagation.REQUIRES_NEW) 为所有子方法创建新事务 |
| | | |
| | | 关于如何使用Tomcat |
| | | * 查看ruoyi-framework模块的pom.xml文件,根据注释更改依赖 |
| | | * 查看ruoyi-admin模块中的application.yml文件,根据注释更改配置 |
| | | |
| | | 关于如何创建新模块 |
| | | * 参考ruoyi-demo模块 |
| | | * 需要改动: 父pom 与 admin模块pom |
| | | |
| | | 关于树表生成 |
| | | * 直接在mysql表中 添加 parentId orderNum 等字段(根据需要参考 TreeEntity类) |
| | | * 代码生成选择树表生成即可 |
| | | |
| | | 关于数据权限 |
| | | * 参考(用户,角色,部门)列表接口用法 |
| | | * 目前仅支持 XML 方式使用(后续修改为支持MP) |
| | | |
| | | 关于vue与boot整合部署 |
| | | * [前端静态资源如何整合到后端访问](https://doc.ruoyi.vip/ruoyi-vue/other/faq.html#前端静态资源如何整合到后端访问) |
| | | |
| | | 关于修改包名 |
| | | * 将文件夹全部修改为 com.xxx |
| | | * 使用IDEA全局替换 com.ruoyi 替换为 com.xxx |
| | | * 严禁手动修改 |
| | | |
| | | ## 内置功能 |
| | | |