更新日志
重大更新
-
[重大更新] 使用 caffeine 重构 PlusSaTokenDao 层实现 减少将近90%的redis查询提高性能
-
[重大更新] 新增 PlusCacheWrapper 装饰器 为 SpringCache 增加本地缓存减少redis查询提高性能
-
[重大更新] 升级 awsS3 到2.X版本 支持异步与自动分片上传下载(感谢 AprilWind)
-
[重大更新] 新增 flowable 工作流功能(感谢 May)
-
[重大更新] 新增 snailjob 调度中心 移除 powerjob (投诉的人太多) (感谢 dhb52)
-
[重大更新] 重构 将spring-cloud-stream改为普通的mq依赖用法(感谢 Xbhog)
-
[重大更新] 新增 ruoyi-common-bus 消息总线组件 基于MQ跨服务投递事件消息
依赖升级
-
update springboot 3.1.7 => 3.2.6 支持虚拟线程
-
update springboot-admin 3.1.8 => 3.2.3
-
update springdoc 2.2.0 => 2.5.0
-
update redisson 3.24.3 => 3.29.0 支持虚拟线程
-
update hutool 5.8.22 => 5.8.26
-
update dynamic-ds 4.2.0 => 4.3.0
-
update mybatis-plus 3.5.4 => 3.5.7 修复与boot代码冲突问题
-
update lock4j 2.2.5 => 2.2.7 消除启动警告
-
update sms4j 2.2.0 => 3.2.1 支持自定义配置key 可用于多厂商多租户等
-
update mapstruct-plus 1.3.5 => 1.3.6
-
update easyexcel 3.3.3 => 3.3.4
-
update lombok 1.18.30 => 1.18.32
-
update satoken 1.37.0 -> 1.38.0
-
update aws-oss 1.12.600 => 2.25.15
功能更新
-
update 优化 StreamUtils 抽取 findFirst findAny 方法
-
update 优化 更新使用 Spring 官方推荐 JDK
-
update 优化 webscoket 配置与异常拦截
-
update 优化 isTenantAdmin 空校验
-
update 优化 修改路由name命名规则(感谢 玲娜贝er)
-
update 优化 大数据量下join卡顿问题 使用子查询提高性能
-
update 优化 用户ID查询角色列表(感谢 AprilWind)
-
update 优化 获取用户账户(感谢 AprilWind)
-
update 优化 租户列表接口 避免登录之后列表被域名过滤
-
update 优化 三方登录不同域名获取不到租户id问题
-
update 优化 获取aop代理的方式 减少与其他使用aop的功能冲突的概率
-
update 优化 临时解决 spring 启动报 warn 问题
-
update 优化 移除表单构建菜单(没有可用组件 用处不大以后再考虑)
-
update 优化 修改用户信息接口(感谢 AprilWind)
-
update 优化 切换动态租户 默认线程内切换(如需全局 手动传参)
-
update 优化 适配最新前端代码生成模板
-
update 优化 代码生成 el-radio 标签过期属性
-
update 优化 文件下载(使用对流传递 降低内存使用量)(感谢 秋辞未寒)
-
update 优化 去除gc日志参数(有需要自己加)
-
update 优化 拆分异常处理器
-
update 优化 常规web异常状态码
-
update 优化 设置静态资源路径防止所有请求都可以访问静态资源
-
update 优化 代码生成表导入 排除工作流相关表
-
update 优化 redis 对Long值的存储类型不同问题
-
update 优化 去除加密请求类型限制
-
update 优化 mp多租户插件注入逻辑
-
update 优化 移除删表语句 用户自行处理
-
update 优化 RedisUtils 支持忽略租户
-
update 更新 ip地址 xdb文件
-
update 优化 新增修改菜单权限字符校验
-
update 优化 验证码背景色改为浅灰色
-
update 优化 更新 mybatis 多包扫描配置
-
update 优化 RateLimiter 注解使用体验(感谢 ly-chn)
-
update 优化 GET 方法响应体支持加密
-
update 优化 excel 单元格合并可以基于注解选择需要依赖哪些字段(感谢 司猫子)
-
update 优化 OssFactory 获取实例锁性能(感谢 fanc)
-
update 优化 登录消息 支持集群发送
-
update 优化 数据权限 使用预扫描mapper注解提升代码性能
-
update 优化 数据加密 使用预扫描实体类提升代码性能(感谢 老马)
-
update 优化 Async 针对虚拟线程配置 与其他注意事项注释
-
update 优化 框架整体sql提高查询性能
-
update 优化 将p6spy配置文件统一放置到 common-mybatis 插件包内
-
update 优化 使用翻译注解简化用户查询 调整用户查询逻辑
新增功能
-
add 新增 SMS异常处理器(感谢 AprilWind)
-
add 新增 在线设备管理(个人中心)(感谢 AprilWind)
-
add 新增 岗位编码与部门编码 并将岗位放到部门下(感谢 秋辞未寒)
-
add 新增 分布式锁Lock4j异常拦截(感谢 AprilWind)
-
add 新增 BaseMapperPlus提供一组可选是否抛出异常的selectVoOne方法(感谢 秋辞未寒)
-
add 新增 用户、部门、角色、岗位 下拉选接口与代码实现优化
-
add 新增 JustAuth 整合 TopIam 单点登录(感谢 马铃薯头)
-
add 新增 StringUtils.isVirtual 方法
-
add 新增 正则工具类 字符串提取 字符串校验
问题修复
-
fix 修复 isLogin 方法抛异常无法正常返回值问题
-
fix 修复 spring路径规则 导致 actuator 被特殊方式访问问题
-
fix 修复token无效时关闭ws(感谢 AprilWind)
-
fix 修复 oss未使用租户 拼接租户id null问题
-
fix 修复 用户昵称修改后未清除对应缓存问题
-
fix 修复 文件上传图片预览问题
-
fix 修复 三方账号可以被同一个用户多次绑定问题
-
fix 修复 兼容redis5.0出现的问题
-
fix 修复 字典键值可重复配置问题
-
fix 修复 部分浏览器无法获取加密响应头问题
-
fix 修复 用户未设置部门 登录报错问题
-
fix 修复 全局异常处理器 空指针null问题
-
fix 修复 excel 表达式字典 下拉框导出格式错误
-
fix 修复 InjectionMetaObjectHandler 已存在数据依旧会获取用户信息报异常问题
-
fix 修复 关闭租户功能 三方登录报错问题
-
fix 修复 部门树排序问题
-
fix 修复 CryptoFilter 代码逻辑问题
前端改动
-
update 升级 element vite 版本 最低nodejs版本提升到18.18.0
-
update 优化 更改客户端状态接口 使用clientId传参
-
update 优化 ws开关改为常开(vite5修复了崩溃bug)
-
update 优化 移除cjs
-
update 优化 对Volar支持
-
update 优化 富文本组件,修复两个组件上传图片位置错乱问题
-
update 优化 request请求类判断请求头方式
-
update 优化 密码校验策略增加非法字符限制
-
update 优化 支持全局开启或关闭接口加密功能
-
update 优化 暗黑模式,增加vxe的暗黑模式
-
update 优化 首页打开topNav不展开菜单问题
-
update 优化 el-select 与 el-input 全局样式
-
update 优化 跟密码相关的默认前端关闭防重功能
-
add 新增 社交登录整合 TopIam
-
add 新增 图片上传组件增加压缩功能支持,可自行开关
-
add 新增 vxe-table依赖支持
-
add 新增 全局用户选择组件
-
add 新增 工作流相关页面与组件
-
add 新增 使用bpmnjs流程预览
-
add 新增 在线登录设备管理(感谢 AprilWind)
-
add 新增 用户选择角色时 可搜索功能(感谢 追梦稻草人Li)
-
fix 修复 登录失效,重新登录丢失参数问题(感谢 爱宇阳)
-
fix 修复 websocket 非index页面刷新无法重连问题
-
fix 修复 全局属性找不到的问题(感谢 ahaos)
-
fix 修复 vue 类型识别问题
-
fix 修复 富文本编辑器 单页面多实例图片混乱问题
-
fix 修复 i18n无感刷新问题
-
fix 修复 文件预览大写后缀不展示的问题(感谢 北桥)
-
fix 修复 面板因为min width原因收缩不全
-
fix 修复 移动端下 无法展开菜单问题
-
fix 修复 菜单搜索下方出现白色区域
-
fix 修复 el-tag标签类型不一致问题
-
fix 修复 角色必填*号
微服务修改
-
update springcloud 2022.0.4 => 2023.0.2
-
update springcloud-alibaba 2022.0.0.0 => 2023.0.1.0
-
update dubbo 3.2.7 => 3.2.14
-
update easy-es 2.0.0-beta4 => 2.0.0 正式版
-
update nacos 2.2.1 => 2.3.2 默认开启nacos服务端授权认证 (感谢 OldDriver9527)
-
update rocketmq 4.9.4 => 5.2.0 docker镜像升级
-
update kafka 3.2.0 => 3.6.2 docker镜像升级
-
update rabbitmq 3.10.6 => 3.13.3 docker镜像升级
-
update sentinel 1.8.6 => 1.8.8
-
update skywalking 9.3.0 => 9.7.0
-
update skywalking-agent 8.16.0 => 9.2.0
-
update 优化 dubbo 使用 redis 作为元数据中心管理 支持过期时间 避免过期数据堆积 解放nacos存储空间
-
update 优化 调整配置文件语法
-
update 优化 使用spring工具自定义dubbo ip获取方法(针对多网卡ip获取不正确问题)
-
update 优化 common-dubbo 删除无用依赖
-
update 优化 去除重复的扫描器 @EnableDubbo 会自行扫描包
-
update 优化 加密组件 mp依赖改为可选
-
update 优化 mybatis依赖设置为可选依赖 避免出现不应该注入的情况
-
fix 修复 sentinel-dashboard的pom引入logaback冲突问题
-
fix 修复 nacos 不兼容 logback 1.4 新版本问题
-
fix 修复 开启数据库加密 auth服务报错问题
-
fix 修复 gateway sentinel 限流报错问题(临时方案) https://github.com/alibaba/Sentinel/issues/3298
平台简介
RuoYi-Cloud-Plus
微服务通用权限管理系统
重写 RuoYi-Cloud 全方位升级(不兼容原框架)
项目代码、文档 均开源免费可商用 遵循开源协议在项目中保留开源协议文件即可
活到老写到老 为兴趣而开源 为学习而开源 为让大家真正可以学到技术而开源
系统演示: https://plus-doc.dromara.org/#/common/demo_system
前端项目地址: https://gitee.com/JavaLionLi/plus-ui
文档地址: https://plus-doc.dromara.org
本框架与RuoYi的功能差异
功能 | 本框架 | RuoYi |
---|---|---|
前端项目 | 基于vue3-element-admin开源项目重写 Vue3 + TS + ElementPlus |
基于Vue2/Vue3 + JS |
后端项目结构 | 采用插件化 + 扩展包形式 结构解耦 易于扩展 | 模块相互注入耦合严重难以扩展 |
后端代码风格 | 严格遵守Alibaba规范与项目统一配置的代码格式化 | 代码书写与常规结构不同阅读障碍大 |
分布式注册中心 | 采用 Alibaba Nacos 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控 | 采用 Alibaba Nacos 自行搭建纯官方版本不可靠 |
分布式配置中心 | 采用 Alibaba Nacos 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控 | 采用 Alibaba Nacos 自行搭建纯官方版本不可靠 |
服务网关 | 采用 SpringCloud Gateway 框架扩展了多种功能 例如:内网鉴权、请求体缓存、跨域配置、请求响应日志等 |
采用 SpringCloud Gateway 功能单一 |
负载均衡 | 采用 SpringCloud Loadbalancer 扩展支持了开发团队路由 便于多团队开发调试 | 采用 SpringCloud Loadbalancer 功能单一 |
RPC远程调用 | 采用 全新 Apache Dubbo 3.X 历史悠远不用多说 | 采用 feign 功能有限编写方式 网络波动大 不稳定 |
分布式限流熔断 | 采用 Alibaba Sentinel 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控 | 采用 Alibaba Sentinel 自行搭建纯官方版本不可靠 |
分布式事务 | 采用 Alibaba Seata 源码集成对接了Nacos与各种监控 简化了搭建部署流程 | 采用 Alibaba Seata 自行搭建纯官方版本 搭建繁琐与Nacos不挂钩 代码内使用方式怪异等 |
Web容器 | 采用 Undertow 基于 XNIO 的高性能容器 | 采用 Tomcat |
权限认证 | 采用 Sa-Token、Jwt 静态使用功能齐全 低耦合 高扩展 | Spring Security 配置繁琐扩展性极差 |
权限注解 | 采用 Sa-Token 支持注解 登录校验、角色校验、权限校验、二级认证校验、HttpBasic校验、忽略校验 角色与权限校验支持多种条件 如 AND OR 或 权限 OR 角色 等复杂表达式 |
只支持是否存在匹配 |
关系数据库支持 | 原生支持 MySQL、Oracle、PostgreSQL、SQLServer 可同时使用异构切换 |
支持 Mysql、Oracle 不支持同时使用、不支持异构切换 |
缓存数据库 | 支持 Redis 5-7 支持大部分新功能特性 如 分布式限流、分布式队列 | Redis 简单 get set 支持 |
Redis客户端 | 采用 Redisson Redis官方推荐 基于Netty的客户端工具 支持Redis 90%以上的命令 底层优化规避很多不正确的用法 例如: keys被转换为scan 支持单机、哨兵、单主集群、多主集群等模式 |
Lettuce + RedisTemplate 支持模式少 工具使用繁琐 连接池采用 common-pool Bug多经常性出问题 |
缓存注解 | 采用 Spring-Cache 注解 对其扩展了实现支持了更多功能 例如 过期时间 最大空闲时间 组最大长度等 只需一个注解即可完成数据自动缓存 |
需手动编写Redis代码逻辑 |
ORM框架 | 采用 Mybatis-Plus 基于对象几乎不用写SQL全java操作 功能强大插件众多 例如多租户插件 分页插件 乐观锁插件等等 |
采用 Mybatis 基于XML需要手写SQL |
SQL监控 | 采用 p6spy 可输出完整SQL与执行时间监控 | log输出 需手动拼接sql与参数无法快速查看调试问题 |
数据分页 | 采用 Mybatis-Plus 分页插件 框架对其进行了扩展 对象化分页对象 支持多种方式传参 支持前端多排序 复杂排序 |
采用 PageHelper 仅支持单查询分页 参数只能从param传 只能单排序 功能扩展性差 体验不好 |
数据权限 | 采用 Mybatis-Plus 插件 自行分析拼接SQL 无感式过滤 只需为Mapper设置好注解条件 支持多种自定义 不限于部门角色 |
采用 注解+aop 实现 基于部门角色 生成的sql兼容性差 不支持其他业务扩展 生成sql后需手动拼接到具体业务sql上 对于多个Mapper查询不起作用 |
数据脱敏 | 采用 注解 + jackson 序列化期间脱敏 支持不同模块不同的脱敏条件 支持多种策略 如身份证、手机号、地址、邮箱、银行卡等 可自行扩展 |
无 |
数据加解密 | 采用 注解 + mybatis 拦截器 对存取数据期间自动加解密 支持多种策略 如BASE64、AES、RSA、SM2、SM4等 |
无 |
数据翻译 | 采用 注解 + jackson 序列化期间动态修改数据 数据进行翻译 支持多种模式: 映射翻译 直接翻译 其他扩展条件翻译 接口化两步即可完成自定义扩展 内置多种翻译实现 |
无 |
多数据源框架 | 采用 dynamic-datasource 支持世面大部分数据库 通过yml配置即可动态管理异构不同种类的数据库 也可通过前端页面添加数据源 支持spel表达式从请求头参数等条件切换数据源 |
基于 druid 手动编写代码配置数据源 配置繁琐 支持性差 |
多数据源事务 | 采用 dynamic-datasource 支持多数据源不同种类的数据库事务回滚 | 不支持 |
数据库连接池 | 采用 HikariCP Spring官方内置连接池 配置简单 以性能与稳定性闻名天下 | 采用 druid bug众多 社区维护差 活跃度低 配置众多繁琐性能一般 |
数据库主键 | 采用 雪花ID 基于时间戳的 有序增长 唯一ID 再也不用为分库分表 数据合并主键冲突重复而发愁 | 采用 数据库自增ID 支持数据量有限 不支持多数据源主键唯一 |
WebSocket协议 | 基于 Spring 封装的 WebSocket 协议 扩展了Token鉴权与分布式会话同步 不再只是基于单机的废物 | 无 |
序列化 | 采用 Jackson Spring官方内置序列化 靠谱!!! | 采用 fastjson bugjson 远近闻名 |
分布式幂等 | 参考美团GTIS防重系统简化实现(细节可看文档) | 手动编写注解基于aop实现 |
分布式任务调度 | 采用 SnailJob 天生支持分布式 统一的管理中心 支持多种数据库 支持分片重试DAG任务流等 | 采用 Quartz 基于数据库锁性能差 集群需要做很多配置与改造 |
分布式日志中心 | 采用 ELK 业界成熟解决方案 实时收集所有服务的运行日志 快速发现定位问题 | 无 |
分布式搜索引擎 | 采用 ElasticSearch、Easy-Es 以 Mybatis-Plus 方式操作 ElasticSearch | 无 |
分布式消息队列 | 采用 支持 Kafka、RocketMQ、RabbitMQ 各种 延迟消息 事务消息 流消息 | 无 |
分库分表功能 | 采用 Apache Sharding-Proxy 代理服务无入侵支持分库分表 只需编写分库分表规则即可 | 无 |
文件存储 | 采用 Minio 分布式文件存储 天生支持多机、多硬盘、多分片、多副本存储 支持权限管理 安全可靠 文件可加密存储 |
采用 本机文件存储 文件裸漏 易丢失泄漏 不支持集群有单点效应 |
云存储 | 采用 AWS S3 协议客户端 支持 七牛、阿里、腾讯 等一切支持S3协议的厂家 | 不支持 |
短信 | 支持 阿里、腾讯 只需在yml配置好厂家密钥即可使用 接口化支持扩展其他厂家 | 不支持 |
邮件 | 采用 mail-api 通用协议支持大部分邮件厂商 | 不支持 |
接口文档 | 采用 SpringDoc、javadoc 无注解零入侵基于java注释 只需把注释写好 无需再写一大堆的文档注解了 |
采用 Springfox 已停止维护 需要编写大量的注解来支持文档生成 |
校验框架 | 采用 Validation 支持注解与工具类校验 注解支持国际化 | 仅支持注解 且注解不支持国际化 |
Excel框架 | 采用 Alibaba EasyExcel 基于插件化 框架对其增加了很多功能 例如 自动合并相同内容 自动排列布局 字典翻译等 |
基于 POI 手写实现 功能有限 复杂 扩展性差 |
工具类框架 | 采用 Hutool、Lombok 上百种工具覆盖90%的使用需求 基于注解自动生成 get set 等简化框架大量代码 | 手写工具稳定性差易出问题 工具数量有限 代码臃肿需自己手写 get set 等 |
服务监控框架 | 采用 SpringBoot-Admin 基于SpringBoot官方 actuator 探针机制 实时监控服务状态 框架还为其扩展了在线日志查看监控 |
无 |
全方位监控报警 | 采用 Prometheus、Grafana 多样化采集 多模板大屏展示 实时报警监控 提供详细的搭建文档 | 无 |
链路追踪 | 采用 Apache SkyWalking 还在为请求不知道去哪了 到哪出了问题而烦恼吗 用了它即可实时查看请求经过的每一处每一个节点 |
无 |
代码生成器 | 只需设计好表结构 一键生成所有crud代码与页面 降低80%的开发量 把精力都投入到业务设计上 框架为其适配MP、SpringDoc规范化代码 同时支持动态多数据源代码生成 |
代码生成原生结构 只支持单数据源生成 |
部署方式 | 支持 Docker 编排 一键搭建所有环境 让开发人员从此不再为搭建环境而烦恼 | 原生jar部署 其他环境需手动下载安装 自行搭建 |
项目路径修改 | 提供详细的修改方案文档 并为其做了一些改动 非常简单即可修改成自己想要的 | 需要做很多改造 文档说明有限 |
国际化 | 基于请求头动态返回不同语种的文本内容 开发难度低 有对应的工具类 支持大部分注解内容国际化 | 只提供基础功能 其他需自行编写扩展 |
代码单例测试 | 提供单例测试 使用方式编写方法与maven多环境单测插件 | 只提供基础功能 其他需自行编写扩展 |
Demo案例 | 提供框架功能的实际使用案例 单独一个模块提供了很多很全 | 无 |
本框架与RuoYi的业务差异
业务 | 功能说明 | 本框架 | RuoYi |
---|---|---|---|
租户管理 | 系统内租户的管理 如:租户套餐、过期时间、用户数量、企业信息等 | 支持 | 无 |
租户套餐管理 | 系统内租户所能使用的套餐管理 如:套餐内所包含的菜单等 | 支持 | 无 |
用户管理 | 用户的管理配置 如:新增用户、分配用户所属部门、角色、岗位等 | 支持 | 支持 |
部门管理 | 配置系统组织机构(公司、部门、小组) 树结构展现支持数据权限 | 支持 | 支持 |
岗位管理 | 配置系统用户所属担任职务 | 支持 | 支持 |
菜单管理 | 配置系统菜单、操作权限、按钮权限标识等 | 支持 | 支持 |
角色管理 | 角色菜单权限分配、设置角色按机构进行数据范围权限划分 | 支持 | 支持 |
字典管理 | 对系统中经常使用的一些较为固定的数据进行维护 | 支持 | 支持 |
参数管理 | 对系统动态配置常用参数 | 支持 | 支持 |
通知公告 | 系统通知公告信息发布维护 | 支持 | 支持 |
操作日志 | 系统正常操作日志记录和查询 系统异常信息日志记录和查询 | 支持 | 支持 |
登录日志 | 系统登录日志记录查询包含登录异常 | 支持 | 支持 |
文件管理 | 系统文件展示、上传、下载、删除等管理 | 支持 | 无 |
文件配置管理 | 系统文件上传、下载所需要的配置信息动态添加、修改、删除等管理 | 支持 | 无 |
在线用户管理 | 已登录系统的在线用户信息监控与强制踢出操作 | 支持 | 支持 |
定时任务 | 运行报表、任务管理(添加、修改、删除)、日志管理、执行器管理等 | 支持 | 仅支持任务与日志管理 |
代码生成 | 多数据源前后端代码的生成(java、html、xml、sql)支持CRUD下载 | 支持 | 仅支持单数据源 |
系统接口 | 根据业务代码自动生成相关的api接口文档 | 支持 | 支持 |
服务监控 | 监视集群系统CPU、内存、磁盘、堆栈、在线日志、Spring相关配置等 | 支持 | 仅支持单机CPU、内存、磁盘监控 |
缓存监控 | 对系统的缓存信息查询,命令统计等。 | 支持 | 支持 |
在线构建器 | 拖动表单元素生成相应的HTML代码。 | 支持 | 支持 |
使用案例 | 系统的一些功能案例 | 支持 | 不支持 |