RuoYi-Cloud-Plus 发布 1.8.0 新增 sms4j 短信融合

Love The Way You Lie 2023-10-13 15:32 47阅读 0赞

![format_png][]

## 更新日志 ##

#### 重大更新 ####

*  \[重大更新\] 新增 sms4j 短信融合框架整合(支持数十种短信厂商接入、发送限制、负载均衡等功能)
 *  \[不兼容更新\] 移除 原短信功能(建议使用新 sms4j 功能)
 *  \[重要迁移\] 迁移 vue3 前端到主仓库统一维护

#### 依赖升级 ####

*  update springboot 2.7.11 => 2.7.13
 *  update spring-cloud 2021.0.7 => 2021.0.8
 *  update satoken 1.34.0 => 1.35.0.RC
 *  update easyexcel 3.2.1 => 3.3.1
 *  update sms4j 2.2.0
 *  update element 2.15.12 => 2.15.13

#### 功能更新 ####

*  update 优化 StreamUtils 方法过滤null值
 *  update 优化 页签在Firefox浏览器被遮挡
 *  update 优化 在全局异常拦截器中增加两类异常处理
 *  update 优化 下载zip方法增加遮罩层(感谢@梁剑锋)
 *  update 优化 用户昵称非空校验
 *  update 优化 修改角色如果未绑定用户则无需清理
 *  update 优化 RepeatSubmitAspect 逻辑避免并发请求问题
 *  update 优化 satoken 过期配置 支持多端token自定义有效期
 *  update 优化 加密注解注释错误
 *  update 优化 切换 maven 仓库到华为云(aliyun 不可用)
 *  update 优化 excel 导出存在合并项时在初始化类时进行数据的处理避免多次调用(感谢@yueye)
 *  update 优化 重构 CellMergeStrategy 支持多级表头修复一些小问题 整理代码结构
 *  update 补全 SysLogininforMapper.xml 缺失字段
 *  update 优化 demo 模块 路径适配统一前端
 *  update 调整 gateway 访问日志输出等级

#### 新增功能 ####

*  add 新增 RedisUtils.setObjectIfAbsent 不存在则设置方法
 *  add 新增 Excel 导出附带有下拉框(字典自动导出为下拉框) 可自定义多级下拉框(感谢@Emil.Zhang)
 *  add 新增 OssClient File 文件上传方法
 *  add 增加 RedisUtils 批量删除 hash key 方法

#### 问题修复 ####

*  fix 修复 sa-token.check-same-token 开关对网关鉴权无效问题
 *  fix 修复 服务未添加 common-security 模块导致异常拦截器不生效问题
 *  fix 修复 删除 skywalking dubbo 2.X 插件避免与 3.X 出现兼容性问题
 *  fix 修复 excel 枚举反向解析失败问题
 *  fix 修复 字典缓存注解使用错误问题
 *  fix 修复 新增角色使用内置管理员标识符问题
 *  fix 修复 缓存监控图表 支持跟随屏幕大小自适应调整(感谢@抓蛙师)
 *  fix 修复 防重组件 错删注解问题
 *  fix 修复 CacheName 缓存key存储错误问题
 *  fix 修复 字典缓存注解使用错误问题
 *  fix 修复 用户篡改管理员角色标识符越权问题
 *  fix 修复 登录校验错误次数未达到上限时 错误次数缓存未设置有效时间问题
 *  fix 修复 OssClient 切换服务 实例不正确问题
 *  fix 修复 element ui 因版本而未被工具识别问题(感谢@梁剑锋)
 *  fix 修复 admin监控 切换tab页需要重复登录问题
 *  fix 修复 个人中心tab栏关闭页面内容压缩问题

### 平台简介 ###

> RuoYi-Cloud-Plus `微服务通用权限管理系统` 重写 RuoYi-Cloud 全方位升级(不兼容原框架)

> 项目代码、文档 均开源免费可商用 遵循开源协议在项目中保留开源协议文件即可  
> 活到老写到老 为兴趣而开源 为学习而开源 为让大家真正可以学到技术而开源

## 本框架与RuoYi的功能差异 ##

<table> 
 <thead> 
  <tr> 
   <th>功能</th> 
   <th>本框架</th> 
   <th>RuoYi</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>前端项目</td> 
   <td>基于vue3-element-admin开源项目重写<br> Vue3 + TS + ElementPlus</td> 
   <td>基于Vue2/Vue3 + JS</td> 
  </tr> 
  <tr> 
   <td>后端项目结构</td> 
   <td>采用插件化 + 扩展包形式 结构解耦 易于扩展</td> 
   <td>模块相互注入耦合严重难以扩展</td> 
  </tr> 
  <tr> 
   <td>后端代码风格</td> 
   <td>严格遵守Alibaba规范与项目统一配置的代码格式化</td> 
   <td>代码书写与常规结构不同阅读障碍大</td> 
  </tr> 
  <tr> 
   <td>分布式注册中心</td> 
   <td>采用 Alibaba Nacos 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控</td> 
   <td>采用 Alibaba Nacos 自行搭建纯官方版本不可靠</td> 
  </tr> 
  <tr> 
   <td>分布式配置中心</td> 
   <td>采用 Alibaba Nacos 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控</td> 
   <td>采用 Alibaba Nacos 自行搭建纯官方版本不可靠</td> 
  </tr> 
  <tr> 
   <td>服务网关</td> 
   <td>采用 SpringCloud Gateway 框架扩展了多种功能<br> 例如:内网鉴权、请求体缓存、跨域配置、请求响应日志等</td> 
   <td>采用 SpringCloud Gateway 功能单一</td> 
  </tr> 
  <tr> 
   <td>负载均衡</td> 
   <td>采用 SpringCloud Loadbalancer 扩展支持了开发团队路由 便于多团队开发调试</td> 
   <td>采用 SpringCloud Loadbalancer 功能单一</td> 
  </tr> 
  <tr> 
   <td>RPC远程调用</td> 
   <td>采用 全新 Apache Dubbo 3.X 历史悠远不用多说</td> 
   <td>采用 feign 功能有限编写方式 网络波动大 不稳定</td> 
  </tr> 
  <tr> 
   <td>分布式限流熔断</td> 
   <td>采用 Alibaba Sentinel 源码集成便于调试扩展与二次开发 框架还为其增加了各种监控</td> 
   <td>采用 Alibaba Sentinel 自行搭建纯官方版本不可靠</td> 
  </tr> 
  <tr> 
   <td>分布式事务</td> 
   <td>采用 Alibaba Seata 源码集成对接了Nacos与各种监控 简化了搭建部署流程</td> 
   <td>采用 Alibaba Seata 自行搭建纯官方版本 搭建繁琐与Nacos不挂钩 代码内使用方式怪异等</td> 
  </tr> 
  <tr> 
   <td>Web容器</td> 
   <td>采用 Undertow 基于 XNIO 的高性能容器</td> 
   <td>采用 Tomcat</td> 
  </tr> 
  <tr> 
   <td>权限认证</td> 
   <td>采用 Sa-Token、Jwt 静态使用功能齐全 低耦合 高扩展</td> 
   <td>Spring Security 配置繁琐扩展性极差</td> 
  </tr> 
  <tr> 
   <td>权限注解</td> 
   <td>采用 Sa-Token 支持注解 登录校验、角色校验、权限校验、二级认证校验、HttpBasic校验、忽略校验<br> 角色与权限校验支持多种条件 如 <code>AND</code> <code>OR</code> 或 <code>权限 OR 角色</code> 等复杂表达式</td> 
   <td>只支持是否存在匹配</td> 
  </tr> 
  <tr> 
   <td>关系数据库支持</td> 
   <td>原生支持 MySQL、Oracle、PostgreSQL、SQLServer<br> 可同时使用异构切换</td> 
   <td>支持 Mysql、Oracle 不支持同时使用、不支持异构切换</td> 
  </tr> 
  <tr> 
   <td>缓存数据库</td> 
   <td>支持 Redis 5-7 支持大部分新功能特性 如 分布式限流、分布式队列</td> 
   <td>Redis 简单 get set 支持</td> 
  </tr> 
  <tr> 
   <td>Redis客户端</td> 
   <td>采用 Redisson Redis官方推荐 基于Netty的客户端工具<br> 支持Redis 90%以上的命令 底层优化规避很多不正确的用法 例如: keys被转换为scan<br> 支持单机、哨兵、单主集群、多主集群等模式</td> 
   <td>Lettuce + RedisTemplate 支持模式少 工具使用繁琐<br> 连接池采用 common-pool Bug多经常性出问题</td> 
  </tr> 
  <tr> 
   <td>缓存注解</td> 
   <td>采用 Spring-Cache 注解 对其扩展了实现支持了更多功能<br> 例如 过期时间 最大空闲时间 组最大长度等 只需一个注解即可完成数据自动缓存</td> 
   <td>需手动编写Redis代码逻辑</td> 
  </tr> 
  <tr> 
   <td>ORM框架</td> 
   <td>采用 Mybatis-Plus 基于对象几乎不用写SQL全java操作 功能强大插件众多<br> 例如多租户插件 分页插件 乐观锁插件等等</td> 
   <td>采用 Mybatis 基于XML需要手写SQL</td> 
  </tr> 
  <tr> 
   <td>SQL监控</td> 
   <td>采用 p6spy 可输出完整SQL与执行时间监控</td> 
   <td>log输出 需手动拼接sql与参数无法快速查看调试问题</td> 
  </tr> 
  <tr> 
   <td>数据分页</td> 
   <td>采用 Mybatis-Plus 分页插件<br> 框架对其进行了扩展 对象化分页对象 支持多种方式传参 支持前端多排序 复杂排序</td> 
   <td>采用 PageHelper 仅支持单查询分页 参数只能从param传 只能单排序 功能扩展性差 体验不好</td> 
  </tr> 
  <tr> 
   <td>数据权限</td> 
   <td>采用 Mybatis-Plus 插件 自行分析拼接SQL 无感式过滤<br> 只需为Mapper设置好注解条件 支持多种自定义 不限于部门角色</td> 
   <td>采用 注解+aop 实现 基于部门角色 生成的sql兼容性差 不支持其他业务扩展<br> 生成sql后需手动拼接到具体业务sql上 对于多个Mapper查询不起作用</td> 
  </tr> 
  <tr> 
   <td>数据脱敏</td> 
   <td>采用 注解 + jackson 序列化期间脱敏 支持不同模块不同的脱敏条件<br> 支持多种策略 如身份证、手机号、地址、邮箱、银行卡等 可自行扩展</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>数据加解密</td> 
   <td>采用 注解 + mybatis 拦截器 对存取数据期间自动加解密<br> 支持多种策略 如BASE64、AES、RSA、SM2、SM4等</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>数据翻译</td> 
   <td>采用 注解 + jackson 序列化期间动态修改数据 数据进行翻译<br> 支持多种模式: <code>映射翻译</code> <code>直接翻译</code> <code>其他扩展条件翻译</code> 接口化两步即可完成自定义扩展 内置多种翻译实现</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>多数据源框架</td> 
   <td>采用 dynamic-datasource 支持世面大部分数据库<br> 通过yml配置即可动态管理异构不同种类的数据库 也可通过前端页面添加数据源<br> 支持spel表达式从请求头参数等条件切换数据源</td> 
   <td>基于 druid 手动编写代码配置数据源 配置繁琐 支持性差</td> 
  </tr> 
  <tr> 
   <td>多数据源事务</td> 
   <td>采用 dynamic-datasource 支持多数据源不同种类的数据库事务回滚</td> 
   <td>不支持</td> 
  </tr> 
  <tr> 
   <td>数据库连接池</td> 
   <td>采用 HikariCP Spring官方内置连接池 配置简单 以性能与稳定性闻名天下</td> 
   <td>采用 druid bug众多 社区维护差 活跃度低 配置众多繁琐性能一般</td> 
  </tr> 
  <tr> 
   <td>数据库主键</td> 
   <td>采用 雪花ID 基于时间戳的 有序增长 唯一ID 再也不用为分库分表 数据合并主键冲突重复而发愁</td> 
   <td>采用 数据库自增ID 支持数据量有限 不支持多数据源主键唯一</td> 
  </tr> 
  <tr> 
   <td>WebSocket协议</td> 
   <td>基于 Spring 封装的 WebSocket 协议 扩展了Token鉴权与分布式会话同步 不再只是基于单机的废物</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>序列化</td> 
   <td>采用 Jackson Spring官方内置序列化 靠谱!!!</td> 
   <td>采用 fastjson bugjson 远近闻名</td> 
  </tr> 
  <tr> 
   <td>分布式幂等</td> 
   <td>参考美团GTIS防重系统简化实现(细节可看文档)</td> 
   <td>手动编写注解基于aop实现</td> 
  </tr> 
  <tr> 
   <td>分布式任务调度</td> 
   <td>采用 Xxl-Job 天生支持分布式 统一的管理中心</td> 
   <td>采用 Quartz 基于数据库锁性能差 集群需要做很多配置与改造</td> 
  </tr> 
  <tr> 
   <td>分布式日志中心</td> 
   <td>采用 ELK 业界成熟解决方案 实时收集所有服务的运行日志 快速发现定位问题</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>分布式搜索引擎</td> 
   <td>采用 ElasticSearch、Easy-Es 以 Mybatis-Plus 方式操作 ElasticSearch</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>分布式消息队列</td> 
   <td>采用 SpringCloud-Stream 支持 Kafka、RocketMQ、RabbitMQ</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>文件存储</td> 
   <td>采用 Minio 分布式文件存储 天生支持多机、多硬盘、多分片、多副本存储<br> 支持权限管理 安全可靠 文件可加密存储</td> 
   <td>采用 本机文件存储 文件裸漏 易丢失泄漏 不支持集群有单点效应</td> 
  </tr> 
  <tr> 
   <td>云存储</td> 
   <td>采用 AWS S3 协议客户端 支持 七牛、阿里、腾讯 等一切支持S3协议的厂家</td> 
   <td>不支持</td> 
  </tr> 
  <tr> 
   <td>短信</td> 
   <td>支持 阿里、腾讯 只需在yml配置好厂家密钥即可使用 接口化支持扩展其他厂家</td> 
   <td>不支持</td> 
  </tr> 
  <tr> 
   <td>邮件</td> 
   <td>采用 mail-api 通用协议支持大部分邮件厂商</td> 
   <td>不支持</td> 
  </tr> 
  <tr> 
   <td>接口文档</td> 
   <td>采用 SpringDoc、javadoc 无注解零入侵基于java注释<br> 只需把注释写好 无需再写一大堆的文档注解了</td> 
   <td>采用 Springfox 已停止维护 需要编写大量的注解来支持文档生成</td> 
  </tr> 
  <tr> 
   <td>校验框架</td> 
   <td>采用 Validation 支持注解与工具类校验 注解支持国际化</td> 
   <td>仅支持注解 且注解不支持国际化</td> 
  </tr> 
  <tr> 
   <td>Excel框架</td> 
   <td>采用 Alibaba EasyExcel 基于插件化<br> 框架对其增加了很多功能 例如 自动合并相同内容 自动排列布局 字典翻译等</td> 
   <td>基于 POI 手写实现 功能有限 复杂 扩展性差</td> 
  </tr> 
  <tr> 
   <td>工具类框架</td> 
   <td>采用 Hutool、Lombok 上百种工具覆盖90%的使用需求 基于注解自动生成 get set 等简化框架大量代码</td> 
   <td>手写工具稳定性差易出问题 工具数量有限 代码臃肿需自己手写 get set 等</td> 
  </tr> 
  <tr> 
   <td>服务监控框架</td> 
   <td>采用 SpringBoot-Admin 基于SpringBoot官方 actuator 探针机制<br> 实时监控服务状态 框架还为其扩展了在线日志查看监控</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>全方位监控报警</td> 
   <td>采用 Prometheus、Grafana 多样化采集 多模板大屏展示 实时报警监控 提供详细的搭建文档</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>链路追踪</td> 
   <td>采用 Apache SkyWalking 还在为请求不知道去哪了 到哪出了问题而烦恼吗<br> 用了它即可实时查看请求经过的每一处每一个节点</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>代码生成器</td> 
   <td>只需设计好表结构 一键生成所有crud代码与页面<br> 降低80%的开发量 把精力都投入到业务设计上<br> 框架为其适配MP、SpringDoc规范化代码 同时支持动态多数据源代码生成</td> 
   <td>代码生成原生结构 只支持单数据源生成</td> 
  </tr> 
  <tr> 
   <td>部署方式</td> 
   <td>支持 Docker 编排 一键搭建所有环境 让开发人员从此不再为搭建环境而烦恼</td> 
   <td>原生jar部署 其他环境需手动下载安装 自行搭建</td> 
  </tr> 
  <tr> 
   <td>项目路径修改</td> 
   <td>提供详细的修改方案文档 并为其做了一些改动 非常简单即可修改成自己想要的</td> 
   <td>需要做很多改造 文档说明有限</td> 
  </tr> 
  <tr> 
   <td>国际化</td> 
   <td>基于请求头动态返回不同语种的文本内容 开发难度低 有对应的工具类 支持大部分注解内容国际化</td> 
   <td>只提供基础功能 其他需自行编写扩展</td> 
  </tr> 
  <tr> 
   <td>代码单例测试</td> 
   <td>提供单例测试 使用方式编写方法与maven多环境单测插件</td> 
   <td>只提供基础功能 其他需自行编写扩展</td> 
  </tr> 
  <tr> 
   <td>Demo案例</td> 
   <td>提供框架功能的实际使用案例 单独一个模块提供了很多很全</td> 
   <td>无</td> 
  </tr> 
 </tbody> 
</table>

### 本框架与RuoYi的业务差异 ###

<table> 
 <thead> 
  <tr> 
   <th>业务</th> 
   <th>功能说明</th> 
   <th>本框架</th> 
   <th>RuoYi</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>租户管理</td> 
   <td>系统内租户的管理 如:租户套餐、过期时间、用户数量、企业信息等</td> 
   <td>支持</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>租户套餐管理</td> 
   <td>系统内租户所能使用的套餐管理 如:套餐内所包含的菜单等</td> 
   <td>支持</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>用户管理</td> 
   <td>用户的管理配置 如:新增用户、分配用户所属部门、角色、岗位等</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>部门管理</td> 
   <td>配置系统组织机构（公司、部门、小组） 树结构展现支持数据权限</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>岗位管理</td> 
   <td>配置系统用户所属担任职务</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>菜单管理</td> 
   <td>配置系统菜单、操作权限、按钮权限标识等</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>角色管理</td> 
   <td>角色菜单权限分配、设置角色按机构进行数据范围权限划分</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>字典管理</td> 
   <td>对系统中经常使用的一些较为固定的数据进行维护</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>参数管理</td> 
   <td>对系统动态配置常用参数</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>通知公告</td> 
   <td>系统通知公告信息发布维护</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>操作日志</td> 
   <td>系统正常操作日志记录和查询 系统异常信息日志记录和查询</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>登录日志</td> 
   <td>系统登录日志记录查询包含登录异常</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>文件管理</td> 
   <td>系统文件展示、上传、下载、删除等管理</td> 
   <td>支持</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>文件配置管理</td> 
   <td>系统文件上传、下载所需要的配置信息动态添加、修改、删除等管理</td> 
   <td>支持</td> 
   <td>无</td> 
  </tr> 
  <tr> 
   <td>在线用户管理</td> 
   <td>已登录系统的在线用户信息监控与强制踢出操作</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>定时任务</td> 
   <td>运行报表、任务管理(添加、修改、删除)、日志管理、执行器管理等</td> 
   <td>支持</td> 
   <td>仅支持任务与日志管理</td> 
  </tr> 
  <tr> 
   <td>代码生成</td> 
   <td>多数据源前后端代码的生成（java、html、xml、sql）支持CRUD下载</td> 
   <td>支持</td> 
   <td>仅支持单数据源</td> 
  </tr> 
  <tr> 
   <td>系统接口</td> 
   <td>根据业务代码自动生成相关的api接口文档</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>服务监控</td> 
   <td>监视集群系统CPU、内存、磁盘、堆栈、在线日志、Spring相关配置等</td> 
   <td>支持</td> 
   <td>仅支持单机CPU、内存、磁盘监控</td> 
  </tr> 
  <tr> 
   <td>缓存监控</td> 
   <td>对系统的缓存信息查询，命令统计等。</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>在线构建器</td> 
   <td>拖动表单元素生成相应的HTML代码。</td> 
   <td>支持</td> 
   <td>支持</td> 
  </tr> 
  <tr> 
   <td>使用案例</td> 
   <td>系统的一些功能案例</td> 
   <td>支持</td> 
   <td>不支持</td> 
  </tr> 
 </tbody> 
</table>

### 参考文档 ###

使用框架前请仔细阅读文档重点注意事项

> [初始化项目 必看][Link 1]
> 
> > [gitee.com/dromara/Ruo…][Link 1]
> 
> [专栏与视频 入门必看][Link 2]
> 
> > [gitee.com/dromara/Ruo…][Link 2]
> 
> [部署项目 必看][Link 3]
> 
> > [gitee.com/dromara/Ruo…][Link 3]
> 
> [参考文档 Wiki][Wiki]
> 
> > [gitee.com/dromara/Ruo…][Wiki]

[format_png]: https://img-blog.csdnimg.cn/img_convert/6fac22fd0c1baa59aab09fcd662f3785.webp?x-oss-process=image/format,png
[Link 1]: https://link.juejin.cn?target=https%3A%2F%2Fgitee.com%2Fdromara%2FRuoYi-Cloud-Plus%2Fwikis%2Fpages%3Fsort_id%3D5279751%26doc_id%3D2056143
[Link 2]: https://link.juejin.cn?target=https%3A%2F%2Fgitee.com%2Fdromara%2FRuoYi-Cloud-Plus%2Fwikis%2Fpages%3Fsort_id%3D5873351%26doc_id%3D2056143
[Link 3]: https://link.juejin.cn?target=https%3A%2F%2Fgitee.com%2Fdromara%2FRuoYi-Cloud-Plus%2Fwikis%2Fpages%3Fsort_id%3D5305504%26doc_id%3D2056143
[Wiki]: https://link.juejin.cn?target=https%3A%2F%2Fgitee.com%2Fdromara%2FRuoYi-Cloud-Plus%2Fwikis%2Fpages