Skip to content

更新日志

[1.x 版本 Redis 全局前缀失效问题]

1.x 版本 ballcat 切换了默认的验证码为 tianai,而 tianai-captcha 的自动配置中直接 import 了 SpringBoot Redis 的自动配置类, 导致 Ballcat Redis 的自动配置被覆盖,现在需要将配置添加到启动服务中,以提高 Bean 的优先级。

参考配置文件如下:

java
import com.hccake.ballcat.common.redis.prefix.IRedisPrefixConverter;
import com.hccake.ballcat.common.redis.serialize.PrefixJdkRedisSerializer;
import com.hccake.ballcat.common.redis.serialize.PrefixStringRedisSerializer;
import lombok.RequiredArgsConstructor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFactory;
import org.springframework.data.redis.core.RedisTemplate;
import org.springframework.data.redis.core.StringRedisTemplate;

/**
* @author hccake
*/
@RequiredArgsConstructor
@Configuration(proxyBeanMethods = false)
public class RedisConfiguration {

   private final RedisConnectionFactory redisConnectionFactory;

   @Bean
   public StringRedisTemplate stringRedisTemplate(IRedisPrefixConverter redisPrefixConverter) {
       StringRedisTemplate template = new StringRedisTemplate();
       template.setConnectionFactory(redisConnectionFactory);
       template.setKeySerializer(new PrefixStringRedisSerializer(redisPrefixConverter));
       return template;
   }

   @Bean
   public RedisTemplate<Object, Object> redisTemplate(IRedisPrefixConverter redisPrefixConverter) {
       RedisTemplate<Object, Object> template = new RedisTemplate<>();
       template.setConnectionFactory(redisConnectionFactory);
       template.setKeySerializer(new PrefixJdkRedisSerializer(redisPrefixConverter));
       return template;
   }
}

[1.4.1] 2023-10-23

⭐ Features

Redis

  • ✨ 添加 DistributedLock 在获取锁失败时可以进行自旋重试的能力。
  • ✨ @Cached 注解默认进行 3 次自旋尝试,可通过属性 retryCount 进行修改。

[1.4.0] 2023-05-31

💛 Warning

  • TraceId 过滤器从日志模块迁移到了 ballcat-spring-boot-starter-web 模块中
  • TraceId 请求响应头的 name 修改为可配置,默认值为 X-Trace-Id,之前为 traceId,注意调整代码或修改配置(ballcat.web.trace-id-header-name)

⭐ Features

日志模块

  • ✨ (Log) 新增 ballcat.log.access.filter-order 用于配置访问日志的过滤器优先级,默认值 -1000
  • 🎨 (Log) 默认的访问日志处理器,抽取请求响应体是否应该记录的判断方法,方便用户继承重写
  • ♻️ 重构 TraceId 相关代码
    • 迁移 TraceIdFilter 到 web 模块中
    • TraceId 先从请求头中读取,没有的话再进行生成
    • TraceId 响应头的 name 修改为可配置,默认值为 X-Trace-Id
    • 抽取 TraceIdGenerator 接口,方便用户覆盖默认的 TraceId 生成逻辑

OAuth2

  • ⚡ 优化资源所有者授权模式登陆时的错误提示信息

业务模块

  • ✏️ 错别字修正,登陆 -> 登录

🔨 Dependency

  • ⬆️ bump easyexcel from 3.1.5 to 3.3.2

[1.3.0] 2023-05-23

💛 Warning

  • 修改了 user 表中的字段名称, 使其更具规范性,sex -> gender, phone -> phone_number
  • 修改了所有业务表的主键 id 类型,从 integer 调整为 long 类型

⭐ Features

通用模块

涉及模块:ballcat-common-coreballcat-common-modelballcat-common-util

  • ✨ 添加系统命令执行工具类
  • ✨ 添加等待队列, 无限等待至队列中存在值
  • ✨ 添加线程池工具类
  • ✨ 添加布尔工具类
  • ✨ 添加StopWatch用于计算执行耗时
  • ⚡ 切换动态定时器队列到线程安全队列

OAuth2

  • ✨ (OAuth2) 抽象资源所有者授权模型,方便用户扩展登陆方式
  • 🐛 (OAuth2) fix refresh token 未持久化导致无法使用的问题
  • ⚡ 允许用户仅通过实现 OAuth2TokenResponseEnhancer 接口进行覆盖默认 Token 响应增强的行为
  • ⚡ 补充登陆时返回的用户信息,额外返回手机号、邮箱、性别

数据权限

涉及模块:ballcat-spring-boot-starter-datascope

  • ✨ (数据权限) DataPermissionUtils#executeWithDataPermissionRule 支持返回值

钉钉通知

涉及模块:ballcat-extend-dingtalk

  • ✨ 添加钉钉负载发送类

GRPC

涉及模块:ballcat-spring-boot-starter-grpc

  • ✨ 添加 grpc starter 模块

业务模块

  • 🐛 (System) 修复组织架构返回未按sort字段进行排序的问题 (#252)
  • (System) 增加角色code检测,防止新增已存在的code时直接返回数据库异常 (#253)
  • ♻️ 所有业务表主键修改为 Long 类型
  • ♻️ sys_user 表中 sex 字段改为 gender, phone 改为 phone_number

🔨 Dependency

  • ⬆️ spring-boot from 2.7.11 to 2.7.12
  • ⬆️ bump flatten-maven-plugin from 1.3.0 to 1.5.0
  • ⬆️ bump maven-compiler-plugin from 3.10.1 to 3.11.0
  • ⬆️ bump maven-resource-plugin from 3.3.0 to 3.3.1
  • ⬆️ bump maven-release-plugin from 3.0.0-M7 to 3.0.0
  • ⬆️ bump maven-javadoc-plugin from 3.4.1 to 3.5.0
  • ⬆️ bump maven-source-plugin from 3.2.1 to 3.3.0
  • ⬆️ bump spring-javaformat-maven-plugin from 0.0.38 to 0.0.39
  • 📌 remove s3-transfer-manager, s3-transfer-manager is released and can manage it with s3-bom

[1.2.0] 2023-05-10

💛 Warning

  • 移除了 ballcat-auth 模块以及所有 spring-security-oauth2 的相关代码

⭐ Features

  • 🎨 授权服务器和资源服务器配置切换到 SecurityFilterChain
  • 🔥 移除授权服务器中的 AuthenticationManagerConfiguration
  • ⚡ (OAuth2) 密码模式改为直接使用 DaoAuthenticationProvider 进行认证操作,避免 AuthenticationManagerProvider 之间的循环依赖
  • ✨ (OSS) 新增 ballcat.oss.chunked-encoding 配置,用于控制是否进行分块传输,默认为 false (#250)

[1.1.0] 2023-04-24

💛 Warning

  • 数据权限中 DataScope 不兼容更新,getTableNames 修改为 includes

  • Redis 组件中的 ballcat.redis.locked-time-out 配置修改为ballcat.redis.default-lock-timeout 并修改默认值为 10s

  • spring-javaformat 新版本优化了链式调用代码的格式化,更新后重新 format 代码,会导致大量文件更新。

  • 授权服务器的登录验证码开关默认值切换为 false,开启了验证码校验的注意修改对应配置为 true.

  • ballcat-admin-core 模块不再默认开启资源服务器的配置,需要用户在自己的配置类上手动添加 @EnableOauth2ResourceServer 注解。

  • ballcat-admin-core 不再传递授权服务器的依赖,用户根据自己的需要在配置类上添加对应的注解,以及 pom.xml 中引入对应的依赖:

    • 切换到 spring authorization server

      xml
            <!-- 基于 spring authorization server 的授权服务器 -->
          <dependency>
              <groupId>com.hccake</groupId>
              <artifactId>ballcat-spring-security-oauth2-authorization-server</artifactId>
          </dependency>

      添加注解 @org.ballcat.springsecurity.oauth2.server.authorization.annotation.EnableOauth2AuthorizationServer

    • 或者继续使用 spring-oauth2

      xml
               <!-- 已废弃,基于 spring oauth2 的授权服务器 -->
           <dependency>
               <groupId>com.hccake</groupId>
               <artifactId>ballcat-auth-controller</artifactId>
               <scope>provided</scope>
           </dependency>

      添加注解 @com.hccake.ballcat.auth.annotation.EnableOauth2AuthorizationServer

  • spring authorization server 的登陆和退出端点变更为 /oauth2/token/oauth2/revoke,请求方式也略有不同,请注意同步前端更新

⭐ Features

全局

  • 🔥 移除 dynamic-datasource 和 jasypt 等未在 ballcat 仓库中直接使用的第三方工具的版本管理
  • ✨ 版本统一由ballcat-dependencies模块管理,顶级父工程不再重复管理
  • 🚨 处理部分 SonarLint Error

OAuth2 授权服务器

涉及模块:ballcat-spring-security-oauth2-authorization-server

  • ✨ 使用 accessTokenResponseHandler 方式配置 token 增强,方便作用于所有的 grant_type
  • ⚡ 授权服务器的登录验证码开关默认值设置为 false
  • ✨ 提供默认的 BallcatOAuth2TokenCustomizer,方便做远程 token 自省
  • ✨ (授权服务器) 不再自动配置,改为使用 @EnableOauth2AuthorizationServer 注解显式开启
  • ✨ 添加 AnonymousForeverAuthenticationProvider,用于在使用错误 token 的访问资源时不终止流程,而是切换身份到匿名用户访问
  • ✅ (OAuth2) 添加授权服务器部分功能的单元测试
  • ✨ 提供了 OAuth2AuthorizationObjectMapperCustomizer 类,方便用户扩展 OAuth2Authorization 的序列化逻辑

OAuth2 资源服务器:

涉及模块:ballcat-spring-security-oauth2-resource-server

  • ⚡ (资源服务器) 远程不透明令牌自省器从 nimbus 实现迁移到 spring 实现,并移除 nimbus 依赖
  • ⚡ (资源服务器) 优化远程自省时解析的 attributes,只保留必要属性
  • ⚡ 删除手动指定鉴权管理器操作,开启资源服务器后默认会创建

后台管理模块

  • 🐛 fix 角色分页查询条件错误添加了 code 的问题

通用模块

涉及模块:ballcat-common-coreballcat-common-modelballcat-common-util

  • ♻️ BooleanEnum 重构, 同时管理 boolean 类型和对应的 int 类型值, 使用包装类, 方便与包装类进行 equals 判断, 避免拆箱的空指针
  • ♻️ 重载部分R对象方法
  • 🎨 精简依赖范围 ballcat-common-util 的依赖 hutool-extra 缩小为 hutool-core
  • ✨ 添加 array 工具类
  • ✨ 添加https部分静态实现
  • 🐛 修复 AbstractQueueThread 线程被中断的情况下, 未正确调用 shutdown 方法的问题
  • ⚡ 补充部分工具类
  • ✨ 添加spring 环境工具类
  • ✨ 添加LocalDateTime工具类
  • ⚡ markdown支持代码写入
  • ✨ 添加指定动态休眠的定时器

脱敏工具

涉及模块:ballcat-common-desensitize

  • ⚡ Holder 中的数据存储从静态常量修改为实例属性
  • ✅ 修复在不同顺序下执行测试用例导致结果不同的问题

IP 组件

涉及模块:ballcat-spring-boot-starter-ip2region

  • ✨ Ip工具类添加两个静默查询方法

Redis 组件

涉及模块:ballcat-common-redisballcat-spring-boot-starter-redis

  • ✨ 缓存锁添加几个超时时间的重载方法,方便用户自己控制锁释放时间
  • ♻️ 分布式锁使用spring内置断言替代hutool断言
  • ballcat.redis.locked-time-out 配置修改为ballcat.redis.default-lock-timeout 并修改默认值为 10s
  • ⚡ CacheLock 类移动到 lock 包下,同时移除内部 redisTemplate 的引用,改为使用 RedisHelper
  • ✨ redis 支持对redis的新增、修改、删除、过期的监听

数据权限

涉及模块:ballcat-spring-boot-starter-datascope

  • ✨ 新增 DataPermissionUtils#executeAndIgnoreAll 方法,方便忽略数据权限进行方法执行

  • 💥 DataScope 使用 includes 方法替换原 getTableNames 方法,以便支持更加多元化的方式来判断是否需要控制当前表

mybatis

涉及模块:ballcat-extend-mybatis-plus

  • ✨ LambdaQueryWrapperX#isPresent 添加对 Optional 和 Map 的判空支持

NTP 服务

涉及模块:ballcat-extend-ntp

  • ✨ 添加ntp模块, 添加 NtpCn 类便于国内使用

钉钉通知

涉及模块:ballcat-extend-dingtalk

  • ⚡ 钉钉消息发送模块请求工具转为okhttp
  • 🐛 修复 MarkDown 引用文本换行异常
  • ⚡ MarkDown 添加支持多行引用文本的方法
  • ✅ 添加钉钉消息发送测试用例

🔨 Dependency

  • ⬆️ commons-net from 3.8.0 to 3.9.0
  • ⬆️ springdoc-openapi from 1.6.13 to 1.7.0
  • ⬆️ spring-boot from 2.7.6 to 2.7.11
  • ⬆️ easyexcel from 3.1.2 to 3.1.5
  • ⬆️ hutool from 5.8.10 to 5.8.16
  • ⬆️ mybatis-plus from 3.5.2 to 3.5.3.1
  • ⬆️ spring-authorization-server from 0.4.0 to 0.4.2
  • ⬆️ spring-javaformat from 0.0.35 to 0.0.38
  • ⬆️ xxl-job from 2.3.1 to 2.4.0
  • ⬆️ lombok from 1.18.24 to 1.18.26
  • ⬆️ ip2region from 2.6.6 to 2.7.0

[1.0.3] 2022-12-05

💛 Warning

此版本移除了 ballcat 的 pom 中配置的 maven resource filter 控制,会导致 application.yml 中的 @profiles.active@ 等占位符无法正确解析替换,注意在自己项目的 pom.xml 中添加对应的 maven resource filter 配置。

配置方式参看: Maven 占位符配置

⭐ Features

全局

  • 🔥 移除 ballcat pom.xml 中对于 maven resource 的过滤配置,交由项目自己控制
  • 🚨 fix some java doc warning
  • 👷 明确指定 maven-surefire-plugin 插件的版本以及执行的字符集为 UTF-8
  • 👷 取消 maven 编译插件编译时跳过 test class 的配置
  • ✅ 修复单元测试在 maven test 命令时不执行或者执行报错的问题

定时任务组件

涉及模块:ballcat-spring-boot-starter-job

  • 🐛 (定时任务) 修复xxl-job执行器存在默认名称导致自动注册spring应用名失败

IP 组件

涉及模块:ballcat-spring-boot-starter-ip2region

  • 🐛 修复用户在启用资源过滤的情况下 ip2region 数据文件损坏的问题

Redis 组件

涉及模块:ballcat-common-redisballcat-spring-boot-starter-redis

  • ⚡ 明确指定下 Ballcat Redis 自动配置的顺序,需要在 spring-boot 的自动配置之前
  • 🐛 修复 RedisHelper#setExAt 的过期时间设置不正确的问题
  • 🐛 修复 RedisHelper#incrByAndExpire 序列化异常与 lua 脚本错误问题

数据权限

涉及模块:ballcat-spring-boot-starter-datascope

  • ✨ 添加只有 JOIN 关键字的连表 sql 处理支持
  • 🐛 修复在排除部分 DataScope 后剩余的 DataScope 没有匹配中当前 sql,导致后续不排除 DataScope 再执行时跳过了数据权限的问题
  • 🐛 修复在 DataScope 内部又进行了 SQL 查询导致数据权限控制递归调用时,导致的空指针问题

Excel 组件

涉及模块:ballcat-spring-boot-starter-easyexcel

  • ✨ Excel 导出支持动态 sheet 数量,不必指定 sheet 属性
  • ✨ Excel 导出支持指定 fill 填充模式
  • ⚡ 添加 @ResponseExcel 导出的校验:fill 属性必须配合 template 使用
  • ✨ 添加 EmptyHeadGenerator 组件,用来忽略 excel 头生成
  • 🎨 Excel 导出部分过期方法替换
  • 🐛 修复 Excel 导出名称有空格时变成 + 号的问题
  • ✅ 添加 Excel 基础功能的测试方法
  • ✅ 添加导出时不写入头信息的单元测试用例

🔨 Dependency

  • ⬆️ hutool from 5.8.9 to 5.8.10
  • ⬆️ ip2region from 2.6.5 to 2.6.6
  • ⬆️ s3 from 2.18.6 to 2.18.20
  • ⬆️ spring-boot from 2.7.5 to 2.7.6
  • 📌 spring-authorization-server from 0.4.0-M2 to 0.4.0

[1.0.1] 2022-11-16

💛 Warning

此版本移除了 @EnableAccessLog@EnableOperationLog 注解,访问日志和操作日志将默认启用,用户可以使用 ballcat.log.access.enabled=falseballcat.log.operation.enabled=false 配置来进行关闭

⭐ Features

  • ✨ (Log) 使用配置替换注解来控制日志的开启和关闭
  • 🐛 修复 MdcTaskDecorator 清除子线程 MDC 上下文时机不对
  • 🐛 修复 LambdaAliasWrapper 构建嵌套条件时,生成的 SQL 条件对应值为 null 的问题
  • 🔥 删除 AbstractIdTreeNode,防止用户使用不当造成一些一场问题

[1.0.0] 2022-11-08

💛 Warning

  • ballcat-auth 相关组件标记为过期,授权服务器将于下个版本切换到 spring-authorization-server
  • OAuth2 授权码流程现在使用无状态登录,需要配合前端页面改动(注意升级前端页面)
  • OssClient 过期,现在推荐使用 OssTemplate 组件
  • oss 移除 domain 属性配置,可用 endpoint 属性配置替代,endpoint 属性配置兼容端点与自定义域名
  • oss endpoint 属性配置需配置协议头,例如:http://s3-cn-east-1.qiniucs.com
  • oss 移除 rootPath 属性配置(可用 object-key-prefix 属性配置替代)
  • xxl-job 相关配置添加前缀 ballcat
  • 日志组件的配置现在默认集成到 ballcat-admin-core 中,在不修改的默认实现的情况下无需自己添加配置类了
  • ballcat-common-security 组件移除,部分类的包名有变动
  • 验证码组件切换到了 tianai-captcha,如果想继续使用原 anji-captcha, 注意前后端验证码相关代码都不要改动

⭐ Features

全局优化

  • 🚨 fix some javadoc warning
  • 💚 移除 git 换行符配置避免, git 换行符处理导致的 jpg 文件损坏
  • 📌 统一使用 jakarta 替换 javax
  • ⚡ 优化 maven 依赖配置:
    • 移除 spring-boot-configuration-processor 的依赖传递
    • 清理 IDEA 自动生成的部分无用配置
    • 格式化 pom 文件,依赖、模块引入等按照字母顺序排列

业务模块

  • 🐛 (Notify) 修复可以查询到已删除公告的问题
  • 🐛 (System) 修复多管理员同时删除角色造成的空指针问题
  • (System) 对字典的新建修改添加校验
  • (System) 允许用户新建菜单时不指定 id, 而是使用自增的方式 (gh-220)
  • (System) 字典项修改时状态可以不传

ballcat-admin-core

✨ 内置默认的日志配置类,并根据当前使用的授权服务器注入不同的登陆处理器

Redis 组件

涉及模块:ballcat-common-redisballcat-spring-boot-starter-redis

  • @CacheDel 注解增强为可重复注解
  • RedisHelper 几个带过期时间的方法添加过期时间单位支持
  • @CacheDel 注解添加 allEntries 属性,支持删除同一个命名空间下所有相关key

mybatis-plus 相关

涉及模块:ballcat-extend-mybatis-plus

  • WrapperX 组件新增 lambdaUpdate 方法

OpenAPI 组件

涉及模块:ballcat-extend-openapi

  • 🐛 fix 在 webflux 环境下无法启动的问题

ballcat-common-core

  • ✨ 添加上下文组件, 以及上下文组件接入 spring
  • 🎨 现有线程顶级类使用上下文组件的方式接入 spring
  • SpringUtils 添加一个 publishEvent 发布事件方法
  • ✨ validate 注解支持使用 {} 替换非占位符的 default message

ballcat-common-model

  • 🎨 SystemResultCode 添加部分常用状态码
  • 🎨 修改 SelectData 属性 extendObj 为 attributes

ballcat-common-util

  • 🎨 修改 TreeNode 定义,使用 key 和 parentKey 做为父子节点的关联属性,更普适化
  • ✨ 添加 TreeUtils#forEachDFS 方法,深度优先遍历树节点

IP 组件

  • ✨ 添加 ballcat-spring-boot-starter-ip2region 模块,方便快速集成 Ip2region

定时任务组件

涉及模块:ballcat-spring-boot-starter-job

  • 💥 调整 xxl-job 配置添加 ballcat 前缀
  • ♻️ 优化 xxl-job 的自动配置
  • 🔥 移除 @EnableXxlJob 注解, 用户现在可以通过 ballcat.xxl.job.enabledfalse 来关闭 xxl-job 的使用

幂等组件

涉及模块:ballcat-common-idempotentballcat-spring-boot-starter-idempotent

  • ✨ 添加幂等组件 starter
  • ♻️ 抽象幂等 key 前缀生成器
  • ♻️ 优化幂等插件包结构
  • 🚚 KeyGenerator 接口修改为 IdempotentKeyGenerator, 防止自动配置和别的组件的 keyGenerator 重名导致的注册失败

OSS 组件

涉及模块:ballcat-spring-boot-starter-oss

  • 💥 重新实现的 OSS 操作,部分兼容老版API,并补全许多 S3 原生操作封装支持
  • 💥 oss 移除 domain 属性配置(可用 endpoint 属性替代, endpoint 兼容端点与自定义域名)
  • 💥 oss endpoint 属性配置需配置协议头
  • 💥 oss 移除rootPath属性配置 (可用 object-key-prefix 属性配置替代)
  • ✨ oss 新增enabled属性配置,用于控制oss是否启用
  • ✨ 新增 OssTemplate 组件,用以替代原 OssClient 组件
  • ✨ 新增 ObjectWithGlobalKeyPrefixOssTemplate 支持原 OssClient 中配置的全局 key 前缀

Security 相关

  • ♻️ 对 ballcat-common-security 模块进行拆分
  • ✨ 添加 ballcat-security-core 模块,验证码 validator 迁入此模块方便复用
  • 🔥 移除过时的忽略鉴权路径,使用 ballcat.security.oauth2.resourceserver.ignore-urls 配置
  • AuthenticationManager 交由授权服务器注册

ballcat-auth

  • ⚡ 密码解密判断在非密码模式下直接跳过
  • ✨ 使用 scope 来控制客户端是否跳过验证码以及密码解密
  • 🎨 客户端登录验证 client id 和 client secret
  • 🔥 移除弃用的测试客户端判断方法
  • ♻️ 表单登录的配置从资源服务器迁移到授权服务器
  • 🎨 缩小 auth 模块的包扫描范围
  • ✨ 对于授权码流程使用 STATELESS 无状态登录模式

Excel 模块

涉及组件:ballcat-spring-boot-starter-excel

  • DefaultAnalysisEventListener 添加 set 方法,便于 excel 导入时指定表头行数
  • @RequestExcel 注解添加 headRowNumber 属性方便指定 Excel Head 行数
  • 🩹 临时使用覆盖 class 的方式修复 easyexcel 导入 excel 时,在 Listener 的 invokeHead 中修改头信息不生效的问题

Web 相关

涉及模块:ballcat-spring-boot-starter-web

  • ⏪ 为了兼容部分客户端软件,回退使用 application/json;charset=UTF-8content-type
  • 💡 修复 PageParamArgumentResolverSupport 类中一个错误的注释
  • ✨ 异常通知支持同时发送给多个渠道, 旧配置方法过期
  • 🔥 移除无用的 additional-spring-configuration-metadata.json 文件
  • ⚡ 优化 SpringUtils 中的 ApplicationContext 注入时机

日志组件

涉及模块:ballcat-common-logballcat-spring-boot-starter-log

  • 🎨 提高 access log filter order,以便在 security filter chain 之前调用
  • ⚡ LoginLogUtils 抽取
  • ✨ 内置默认的日志配置类,并根据当前使用的授权服务器注入不同的登陆处理器
  • 🔥 移除 LogUtils 中无用代码

🔨 Dependency

  • 📌 使用 springdoc-openapi bom 进行相关依赖管理

  • 依赖:

    • 【修改】使用 jakarta 相关依赖替换 javax
    • 【升级】awssdk from 2.18.2 to 2.18.6
    • 【升级】easyexcel from 3.1.1 to 3.1.2
    • 【升级】flatten-maven-plugin from 1.2.5 to 1.3.0
    • 【升级】hutool from 5.8.5 to 5.8.9
    • 【升级】jsoup from 1.15.2 to 1.15.3
    • 【升级】swagger from 1.5.21 to 1.6.8
    • 【升级】swagger-v3 from 2.2.0 to 2.2.4
    • 【升级】spring-boot from 2.7.3 to 2.7.5
    • 【升级】spring-security-oauth2 from 2.3.8.RELEASE to 2.5.2.RELEASE
    • 【升级】springdoc-openapi from 1.6.11 to 1.6.12
  • 插件:

    • 【升级】spring-javaformat from 0.0.34 to 0.0.35
    • 【升级】maven-compiler-plugin from 3.8.0 to 3.10.1
    • 【升级】maven-source-plugin from 3.1.0 to 3.2.1
    • 【升级】maven-javadoc-plugin from 3.1.1 to 3.4.1
    • 【升级】nexus-staging-maven-plugin from 1.6.8 to 1.6.13

[0.9.0] 2022-08-31

⭐ Features

Common 相关

涉及模块:ballcat-common-core ballcat-common-util

  • 🐛 修复 AbstractQueueThread 中 getPollTimeoutMs 修饰符错误导致无法被子类覆写
  • 🌟 新增系统工具类, 完善多个工具类方法.
  • 🌟 新增 AbstractTimer 定时器线程
  • 🐛 修复部分情况下, 临时文件夹被删除导致文件处理失败

WebSocket 相关

涉及模块:ballcat-common-websocket ballcat-spring-boot-starter-websocket

  • ⚡ 减少获取 sessionKey 时发生 NPE 的可能性

  • 🌟 新增使用 RocketMQ 做为消息分发器的相关代码

Redis 相关

涉及模块:ballcat-common-redis ballcat-spring-boot-starter-redis

  • ⚡ 优化 CacheLock 的 RedisScript 使用单例模式,防止产生不同的 sha 值
  • RedisHelper 方法名重构,命名规则修改参考 redis 原生命令
  • 🌟 RedisHelper 添加 Stream 流相关使用方法以及其他数据结构的常用方法

OpenAPI 文档

涉及模块:ballcat-extend-openapi

  • 🐛 修复 swagger-ui 中分页查询 sort 参数无法添加多个的问题
  • 🐛 修复 sort 的正则中.未加转义字符,导致校验不严谨的问题
  • 🐛 修复使用 jar 包运行时无法正确显示分页参数的问题

Log 日志相关

涉及模块:ballcat-common-log ballcat-log-biz ballcat-spring-boot-starter-log

  • ⚡ 操作日志相关注解的 type 属性从枚举修改为 int,方便用户扩展
  • ⚡ 只在用户名密码方式鉴权失败时进行登录失败的日志记录

mybatis 相关

涉及模块:ballcat-extend-mybatis-plus

  • 🐛 修复 EnumNameTypeHandler 为默认枚举类型处理器时 处理实现IEnum的枚举值获取异常

🔨 Dependency

  • 【升级】spring-boot from 2.7.1 to 2.7.3
  • 【升级】jsoup from 1.14.3 to 1.15.2
  • 【升级】hutool from 5.8.3 to 5.8.5
  • 【升级】springdoc-openapi from 1.6.9 to 1.6.11
  • 【升级】spring-javaformat from 0.0.31 to 0.0.34
  • 【升级】mapstruct from 1.4.2.final to 1.5.2.final

[0.8.0] 2022-07-12

⚠ Warning

  • 分页参数的默认参数名修改为 page,前端注意对应更新, 也可以通过配置 ballcat.pageable.page-parameter-name 修改为之前版本的参数名 current
  • 验证码 anji-captch 相关的配置以及依赖移除,用户根据自己需求按需添加。(相关代码示例,在 ballcat-admin-sample 和 ballcat-boot 模板仓库中可以查看)
  • UpmsProperties 更名为 SystemProperties, ballcat.upms 下指定超级管理员的 id 和 username 的配置,移动到 ballcat.system 下了
  • 分页上限配置 ballcat.web.max-page-size 现在改为 ballcat.pageable.max-page-size

⭐ Features

全局调整

  • 🎨 使用 @SneakyThrows 注解使用时显示指定异常类型
  • 🌟 全局 starter 支持 spring-boot 2.7.x 后使用的 AutoConfiguration.imports 的方式进行自动配置的加载
    (目前依然兼容低版本 springboot 使用 spring.factories 的自动注册方法)

短信相关改动 ballcat-spring-boot-starter-sms

  • 🌟 整合 aliyun 短信服务
  • 🌟 调整腾讯云 sdk 版本,解决与 aliyun 依赖冲突问题

文件上传 ballcat-spring-boot-starter-file

  • 🎨 FTP 文件上传切换使用 hutool 工具类实现
  • 🐞 修复本地文件上传时返回的路径错误问题
  • ♻ 重构 File 模块的代码结构

国际化 ballcat-i18n

  • 🐞 修复 I18nData 的 resultMap 中,字段 remark 多加了一个 s 的问题
  • 🌟 @I18nField 注解的 code 值支持使用 SPEL 表达式
  • 🌟 添加 @I18nIgnore 注解,可以添加在 controller 的方法上,用于指定忽略 I18n 处理

数据权限 ballcat-spring-boot-starter-datascope

  • ⚡ 优化 DataPermissionRule 的构建方式,添加有参构造,以及支持链式调用
  • ⚡ 将编程式数据权限控制的方法从 DataPermissionHandler 的实例方法,抽取为 DataPermissionUtils 的一个静态方法,使用更加简单便捷
  • 🐞 修复在 DataScope 中执行 sql 导致嵌套执行拦截器,出现匹配计数空指针的问题
  • ✅ add jsqlparse table alias test

密码相关 ballcat-system ballcat-auth ballcat-common-security

  • 🌟 系统用户新建和修改密码时使用 PasswordEncoder 进行加密处理,方便使用者更换密码算法
  • 🌟 系统用户的密码正则规则支持使用 yml 配置进行自定义:ballcat.system.password-rule
  • 🔥 移除 PasswordUtilsencode 以及 matches 等方法,防止用户错误使用.
  • 🎨 PasswordUtils#createDelegatingPasswordEncoder 修改为 public 方法,方便外部调用
  • 🎨 优化下修改密码时,密码异常的错误提示

分页查询相关 ballcat-spring-boot-starter-web ballcat-common-model

  • 🌟 排序参数兼容使用尾缀 [] 的方式进行传参,例如 sortsort[] 都可以做为排序参数
  • 🎨 默认的当前页参数由 current 修改为 page,后续版本中将移除 PageParam 的 current 属性
  • 🌟 分页参数支持自定义参数名:
    yaml
    ballcat:
      pageable:
        page-parameter-name: page # 不想改动前端,这里可以修改为 current
        size-parameter-name: size
        sort-parameter-name: sort #同时会自动支持尾缀[]的参数形式,如 sort[]
        max-page-size: 100

OpenAPI 文档 ballcat-extend-openapi

  • 🌟 添加对于动态分页参数的支持,会自动根据配置进行切换文档中的分页查询属性
    (在引入了 ballcat-spring-boot-starter-web 的情况下)

Redis 相关

  • 🌟 缓存/缓存更新注解增强: 增加时长单位

mybatis-plus-extend

  • 🐞 修复 LambdaAliasQueryWrapperX 嵌套构建条件语句时别名丢失的问题
  • ✅ 添加 LambdaAliasQueryX 的测试用例
  • 🎨 OtherTableColumnAliasFunction 类更名为 ColumnFunction
  • 🌟 添加 ColumnFunction#create 方法,在进行连表查询时,构建第三方表的列名更方便

校验 Validator

  • 新增枚举以及值范围检验的自定义注解
    • @OneOfStrings 校验值是否是指定的字符串之一
    • @OneOfInts 校验值是否是指定的 int 值之一
    • @OneOfClasses 校验值是否是指定的 class 类型之一
    • @ValueOfEnum 校验值是否满足于指定的 Enum

Xss 防注入相关 ballcat-spring-boot-starter-xss

  • 🐞 修复反序列化时携带了错误的 json 可能出现的异常问题

系统管理相关

  • 🌟 添加用户新建和修改时的数据校验
  • 🐞 修复用户新建时无法指定为锁定状态的问题

OAuth2 ballcat-auth-biz

  • 🐞 修复客户端登录模式使用 from 传参不走自定义异常处理的问题
  • 🌟 验证码校验逻辑抽象,方便用户切换验证码的底层依赖
  • 🔥 移除了默认的 anji-captcha 相关的依赖以及配置,用户按需添加

🔨 Dependency

  • 【移除】移除了对 spring-boot-admin 的依赖管理
  • 【修改】取消 spring-boot-starter-web 强制剔除 tomcat 的配置,容器选择权交给用户
  • 【升级】spring-boot from 2.6.6 to 2.7.1
  • 【升级】kafka from 2.5.0 to 2.6.3
  • 【升级】dynamic-datasource-spring-boot-starter from 3.5.0 to 3.5.1
  • 【升级】hutool from 5.7.22 to 5.8.3
  • 【升级】fastjson from 1.2.79 to 1.2.80
  • 【升级】springdoc-openapi from 1.6.7 to 1.6.9
  • 【升级】 mybatis from 3.5.9 to 3.5.10
  • 【升级】 mybatis-plus from 3.5.1 to 3.5.2
  • 【升级】 xxl-job from 2.3.0 to 2.3.1
  • 【升级】easyexcel from 3.0.5 to 3.1.1

[0.7.1] 2022-04-19

依赖修复版本:主要修复了 v0.7.0 版本 OpenAPI 依赖冲突的问题

⭐ Features

OpenAPI 相关改动 ballcat-extend-openapi

  • 🐞 swagger-api 版本冲突,依赖管理 到 2.2.0,保持和 springdoc-openapi 一致

  • 🔥 弃用 ballcat.openapi.security-schemes 配置,现在使用 ballcat.openapi.components.security-schemes

  • 🔥 弃用 ballcat.openapi.global-security-requirements,现在使用 ballcat.openapi.security 属性替代

  • 🩹 修复部分属性 ide 中没有提示的问题

Web 相关改动 ballcat-spring-boot-starter-web

  • 🐞 修复 null 值序列化处理不支持 @JsonInclude 注解的问题
  • ✅ 添加 jackson null 值序列化器的测试用例
  • 🌟 异常通知消息添加 RequestURI 的信息输出
  • 🌟 全局异常日志打印请求URI

[0.7.0] 2022-04-13

⚠️ Warning

  • 此版本操作日志表有字段新增,升级前注意先执行对应的增量 SQL

  • 访问日志的忽略 url 现在只需填写 servlet 内的路径了,升级后请注意调整,防止失效

  • openapi 的配置文件调整:

    • 现在文档基本信息的属性添加了一个 info 的前缀

    • 安全相关配置 ballcat.openapi.global-security-requirements 弃用,使用 ballcat.openapi.components.security-schemes

  • WebSocket 组件中的 AbstractJsonWebSocketMessage 改名为 JsonWebSocketMessage,升级时如遇到 class import 失败,请注意对应修改类名

  • 由于 spring-javaformat 组件的升级,现在如果在 jdk8 环境下,请在项目跟目录新建一个名为 .springjavaformatconfig 的文件,文件内容如下:

    java-baseline=8

⭐ Features

日志相关改动 ballcat-common-log spring-boot-starter-log

  • 🌟 访问日志的忽略 url 现在只需填写 servlet 内的路径了
  • 🌟 操作日志注解增强:用户可以指定是否记录当前操作方法的参数和返回值
  • 🐞 抛 BusinessException 异常时,日志记录丢失 traceId 的问题
  • 🐞 CustomAccessLogHandler#getParams 改变不可变的 parameterMap 集合问题
  • 🐞 修复公告图片上传时的操作日志记录异常问题

国际化 ballcat-common-i18n

  • 🌟 优化下细节:在 i18n 处理失败时,也正常响应

web 服务 ballcat-spring-boot-starter-web

  • 🌟 actuator 拦截器现在只在引入了 actuator 时开启,且拦截地址跟随 actuator 的 base-path 配置
  • 🐞 修复默认配置下仅引入 ballcat-spring-boot-starter-web 时启动异常的问题

分页查询调整 ballcat-common-core

  • 🌟 分页参数 PageParam 的 valid 校验支持
  • 🌟 PageParam 分页条数上限可通过配置 ballcat.web.page-size-limit 动态修改,默认值 100
  • 🌟 所有分页接口,添加 PageParam 的入参校验
  • 🌟 支持带表别名的排序列
  • 🌟 分页查询新增参数 sort 设置排序规则,格式为:property(,asc|desc),支持传入多个排序字段

缓存工具 ballcat-spring-boot-starter-redis

  • 🌟 redis 相关 bean 添加 @ConditionalOnMissBean 注解,方便用户替换
  • 🌟 RedisHelper 工具类添加 zset 的基本操作
  • 🐞 修复在没有配置 ballcat.redis.key-prefix 属性时启动报错的问题

系统管理 ballcat-system

  • 🌟 组织机构树查询支持模糊查询名称
  • 🌟 新增组织机构列表查询
  • 🌟 菜单和组织机构的筛选都移交到前端处理了
  • 🎨 解耦 system 和 websocket 模块(notify 解耦未完成,后续重构通知时处理)

Tree 工具相关改动 ballcat-common-util

  • 🌟 TreeUtils 新增剪枝方法 pruneTree
  • 🌟 TreeUtils 泛型调整
  • 🎨 SimpleTreeNode.getChildren 方法重写,方便直接获取对应的类型数据

数据权限组件 ballcat-spring-boot-starter-datascope

  • 🐞 修复 DataPermissionAnnotationHolder 只清空了 deque,没有 remove 的问题
  • 🌟 添加编程式数据权限规则控制支持,可与 @DataPermission 注解嵌套使用

    数据权限规则优先级,由高到低:

    1. 编程式规则
    2. 当前方法的注解规则
    3. 当前类的注解规则
    4. 调用者使用的权限规则
    5. 全局默认规则 :::

长连接组件 ballcat-common-websocket ballcat-spring-boot-starter-websocket

  • 🌟 优化下 UserSessionKeyGenerator 的 Conditional 判断,方便用户替换
  • 🌟 WebSocket 的 session 存储角色,从 WebSocketSessionHolder 修改为 WebSocketSessionStore
  • 🌟 现在不再默认覆盖同一 sessionKey 的 wsSession 了,方便用户进行全客户端推送
  • 🌟 新增AbstractMessageDistributor, 将MessageDistributor的 default 方法下沉到该抽象类中
  • 🌟 跨域配置添加 allowed-origin-patterns 属性
  • 🌟 添加 SockJs 的支持
  • 🎨 优化下 RedisMessageListener 的注册方式,防止误扫描导致的 bean 注册异常
  • 🎨 优化 ballcat-spring-boot-starter-websocket 的配置类结构
  • 🎨 精简代码层级,将接口 JsonWebSocketMessage 删除,原抽象类 AbstractJsonWebSocketMessage 改名为 JsonWebSocketMessage

幂等组件 ballcat-common-idemptent

  • 🌟 幂等控制注解增强:可以指定消息单位以及幂等拦截时的错误提示了
  • 🌟 幂等组件允许用户控制是否再异常时删除幂等标识,方便有些不允许重试的方法进行幂等控制
  • ✅ 添加幂等组件的一些测试用例

接口文档 ballcat-extend-openapi

  • 🌟 添加部分 OpenAPI 配置
  • 🌟 文档信息的配置下沉到 info 前缀下
  • 🔥 属性 ballcat.openapi.global-security-requirements 弃用,可使用新增的 ballcat.openapi.components.security-schemes 进行配置

🐞 Bug Fix

  • 🐞 调整 ProviderManager 的层级,以解决错误的 token 会触发两次鉴权失败异常的问题
  • 🐞 修复 OSS 上传文件时不主动关闭临时的流. 导致大量文件上传时出现异常
  • 🐞 公告信息分页查询 bug
  • 🐞 fix jdk11 下打包异常的问题

🔨 Dependency Upgrades

  • 【升级】spring-boot from 2.6.2 to 2.6.6,且后续使用官方 dependencies 进行依赖管理
  • 【升级】spring-boot-admin from 2.6.0 to 2.6.6
  • 【升级】spring-javaformat from 0.0.29 to 0.0.31
  • 【升级】hutool from 5.7.12 to 5.7.19
  • 【升级】mybatis-plus from 3.5.0 to 3.5.1
  • 【升级】springdoc-openapi from 1.6.4 to 1.6.7
  • 【升级】software.amazon.awssdk from 2.16.61 tp 2.17.154

[0.6.0] 2022-01-20

⚠️ Warning

  • Swagger2 相关注解迁移到 OpenAPI3,由于使用了 springdoc-openapi,且该项目当前版本的一些问题,如果没有在 服务中引入 springdoc-openapi-ui 的依赖,或者配置中添加 springdoc.api-docs.enabled=false 的配置,则会导致启动报错
  • 删除了 knife4j-ui 的版本管理,对于 OpenAPI3,请使用 knife4j 的 3.x 版本
  • springfox 组件未适配 springboot 2.6.2 版本,如需继续使用 springfox,请添加 spring.mvc.pathmatch.matching-strategy=ant-path-matcher 配置,以及注册 SpringfoxHandlerProviderBeanPostProcessor 到 spring 容器中
  • springboot 2.6.x 默认禁止循环依赖,如有循环依赖启动将会报错,请注意修改代码,或者添加配置 spring.main.allow-circular-references = true ( 不建议)
  • IPageArgumentResolver 移除,如果直接使用 mybatisPlus 的 IPage 做为查询入参会有 SQL 注入风险,请注意修改!!!
  • IPageArgumentResolver 移除,如果直接使用 mybatisPlus 的 IPage 做为查询入参会有 SQL 注入风险,请注意修改!!!
  • IPageArgumentResolver 移除,如果直接使用 mybatisPlus 的 IPage 做为查询入参会有 SQL 注入风险,请注意修改!!!

⭐ New Features

  • 【修改】修改 jackson 脱敏支持的模块添加方式,使用为注册 JsonDesensitizeModule 的形式,以便复用 spring-boot 默认的 module 注册。
  • 【修改】调整 CustomJavaTimeModule 的注册方式,防止被 JSR310 的 JavaTimeModule 覆盖
  • 【删除】移除过时已久的 IPageArgumentResolver,让 starter-web 和 mybatis-plus 模块解耦。
  • 【删除】移除过时的 Lov 相关代码。
  • 【修改】Swagger2 相关注解迁移到 OpenAPI3
  • 【修改】文档底层支持从 springfox 迁移到 springdoc-openapi
  • 【添加】对于 GET 请求的入参封装类,如 xxQO,添加 @ParameterObject 注解,以便在文档上正确展示查询入参
  • 【修改】由于 springfox 长久不更新,弃用基于该框架的 ballcat-spring-boot-starter-swagger 组件
  • 【新增】添加 ballcat-extend-openapi,模块,基于 springdoc-openapi 做了部分扩展,参看文档
  • 【删除】删除 knife4j-ui 的版本管理
  • 【修改】代码优化,显示指定部分参数或返回值的泛型
  • 【修改】Sonarlint 部分代码警告处理
  • 【删除】移除 dependencies pom 中无用的 pluginManagement 部分
  • 【修改】hutool 依赖管理改为使用 hutool 官方提供的 bom
  • 【新增】添加 ballcat-extend-tesseract 扩展模块,用于 OCR 文字识别工具的调用封装
  • 【修改】字典相关逻辑调整
    • 去除字典只读/可写的属性控制
    • 字典项增加启用/禁用的状态属性
    • 字典现在在有字典项的情况下不允许删除(之前会自动级联删除)
  • 【修改】同步 mybtais-plus 升级 3.5.x 后,AbstractMethod 的方法名获取做的调整
  • 【修改】ballcat-spring-boot-starter-oss 更新 oss 相关方法与变量. 由 path 变为 key. 符合 oss 规范,原 rootPath 属性标记为过期,修改为 objectKeyPrefix
  • 【添加】ballcat-spring-boot-starter-oss 新增根据 File 直接上传的方法
  • 【修改】StreamUtils 克隆流方法优化. 使用 FileOutStream 保证不会因为文件过大而内存溢出
  • 【修改】OssDisabledException 父类由 Exception 修改为 RuntimeException
  • 【修改】ballcat-common-idempotent 幂等组件微调
    • RedisIdempotentKeyStore 的 stringRedisTemplate 属性,改为构造器注入
    • 取消 IdempotentAspect 切面的 @Component 注解,防止误注册

🐞 Bug Fixes

  • 【修复】修复删除字典项时没有将变动通知到前端的问题
  • 【修复】修复 FileUtils#updateTmpDir 方法中文件夹创建异常的问题

🔨 Dependency Upgrades

  • 【升级】spring-boot from 2.5.6 to 2.6.2
  • 【升级】lombok from 1.18.20 to 1.18.22
  • 【升级】spring-javaformat from 0.0.28 to 0.0.29
  • 【升级】hutool from 5.7.12 to 5.7.19
  • 【升级】dynamic-datasource from 3.4.1 to 3.5.0
  • 【升级】jasypt from 3.0.3 to 3.0.4
  • 【升级】jsoup from 1.14.2 to 1.14.3
  • 【升级】mybatis-plus from 3.4.3.4 to 3.5.0
  • 【升级】mybatis from 3.5.7 to 3.5.9
  • 【升级】jsqlparse from 4.2 to 4.3
  • 【升级】fastjson from 1.2.76 to 1.2.79
  • 【升级】spring-boot-admin from 2.5.4 to 2.6.0

[0.5.0] 2021-12-03

⚠️ Warning

  • 由于业务实体类的统一修改,其对应的表结构发生了变化
  • 批量方法从 saveBatchSomeColumn 切换到 saveBatch 后,注意项目中的 jdbcUrl 配置,需要添加 rewriteBatchedStatements=true 条件,否则插入效率降低

⭐ New Features

  • 【修改】 业务实体类添加父类 LogicDeletedBaseEntity,统一支持逻辑删除
  • 【修改】 业务实体类统一修改描述、备注等属性名为 remarks
  • 【修改】 业务代码批量插入部分方法从 saveBatchSomeColumn 切换到 saveBatch, 经实测,开启批处理事务以及 jdbcUrl 连接添加rewriteBatchedStatements=true 后, 循环 insert into 批量提交比 insert into values 语法速度更快。
  • 【新增】 ballcat-spring-boot-starter-file 组件,支持 local 本地 和 ftp 文件上传操作
  • 【添加】 TreeUtils#treeToList() 方法,支持将树平铺为列表
  • 【添加】 ImageUtils#mixResolveClone() 方法,先使用快速解析,若失败回退到正常解析方法
  • 【新增】 FileUtils 工具类
  • 【新增】 BaseEntityLogicDeletedBaseEntity 实体类基类
  • 【新增】 支持定制 Redis Key 前缀的生成规则
  • 【新增】 DistributeLock , 更加方便的进行分布式锁的使用
  • 【新增】 AbstractMessageEventListener 类,提供默认的消息序列化处理
  • 【添加】 ExtendService#saveBatch() 方法
  • 【新增】 多线程对同一 websocket session 进行发送操作的支持
  • 【修改】 默认提供的 MybatisPlusConfig 配置类中的自动填充处理类的条件注解修改,方便用户替换为自己的 MetaObjectHandler
  • 【新增】 线程池配置 @Async 异步线程日志支持 traceId 输出
  • 【添加】 TokenGrantBuilder#getAuthenticationManager() 方法,方便子类继承时获取 AuthenticationManager (#133)
  • 【修改】 FileService ,OssClient 不再为必须依赖,当没有配置 Oss 时,默认回退使用 FileClient,根据配置走本地存储或者FTP
  • 【修改】 MappedStatementIdsWithoutDataScopeWITHOUT_MAPPED_STATEMENT_ID_MAP 属性类型为 ConcurrentHashMap
  • 【修改】 TraceIdFilter 默认在响应头中返回 TraceId 参数,方便排查问题
  • 【修改】 UserInfoCoordinator 从类调整为接口,并提供默认实现 DefaultUserInfoCoordinatorImpl

🐞 Bug Fixes

  • 【修复】 数据权限使用 JDK动态代理或者桥接方法时无法正确找到 @DataPermission 注解的问题
  • 【修复】 数据权限在 SQL 右连接,内连接失效的问题
  • 【修复】 数据权限对于使用括号包裹的 sql 解析失效的问题
  • 【修复】 在仅使用 ballcat.swagger.enabled=false 的情况下,swagger 没有正常关闭的问题
  • 【修复】 由于跨域问题,导致 swagger 无法在聚合者 Aggregator 中对 文档提供者 Provider 进行调试的问题
  • 【修复】 WebSocket 在接收普通文本属性时的异常问题,现在会回退使用 PlanTextMessageHandler 进行处理
  • 【修复】 查询指定名称的组织时构建树失败的问题

🔨 Dependency Upgrades

  • 【升级】 spring-boot from 2.5.4 to 2.5.6
  • 【升级】 spring-boot-admin from 2.5.1 to 2.5.4

[0.4.0] 2021-10-15

Warning

  • mybatis-plus 升级,其对应一些 count 方法,返回值修改为了 Long 类型,项目中有使用的地方需要对应修改
  • 默认登录时返回的 token 属性有所变更,原 roles 修改为 roleCodes,前端注意对应升级
  • websocket 默认使用 local 进行分发,这将导致集群状态下的数据推送异常,如需集群部署,请修改对应配置
  • websocket 相关接口 MessageSender 移除,该接口并入 MessageDistributor ,注意修改对应依赖引入类型

Added

  • feat:ballcat-auth 授权服务器定制增强:
    • 允许用户自定义 AccessTokenConverter,修改自省端点 /check_token 的返回值
    • 允许用户定制授权处理器或者新增授权处理器,用户可以通过覆盖 TokenGrantBuilder 实现
    • 允许用户添加自己的 AuthenticationProvider 方便处理自定义的 grant_type
    • 添加 OAuth2ClientConfigurer 抽象接口,方便用户替换 ClientDetailsService 的配置方式
    • ballcat-system 模块解耦,方便复用 ballcat-auth 快速搭建一个授权服务器,例如 C 端用户 和 后台用户分离登陆系统,各搭建一套基于 OAuth2 的登录。
    • 根据 OAuth2 规范,调整 check_token 端点响应,在 token 不正确时响应 200,响应体为 { active: false },而不是返回 400
  • feat:数据权限对于 jsqlparse 4.2 后,连表使用尾缀多个 OnExpression 方式的 SQL 解析支持
  • feat:角色添加 scopeResource 属性,以便支持自定义数据权限设置一些信息
  • feat:默认的 jackson 时间序列化添加了 Instant 类型支持,防止在使用时出现异常 InvalidDefinitionException: Java 8 date/time type java.time.Instant not supported by default

Changed

  • refactor:资源服务器对于客户端凭证生产的token 解析支持,对应的 userdetails 为 ClientPrincipal

  • refactor:授权服务器自省端点的 scope 属性响应调整,根据 OAuth2 自省端点协议,scope 应返回字符串,用空格间隔

  • refactor:数据权限调整

    • 问题修复: fix 数据权限在表名使用 `` 转义字符时失效的问题
    • 性能优化:对于无需数据权限控制的 sql 在解析一次后进行记录,后续不再进行解析处理
    • 结构调整:防止误用以及避免歧义,DataScopeHolder 修改为 DataScopeSqlProcessor 的私有内部类
  • refactor:SelectData 试图对象中的 value 修改为 Object 类型,selected 和 disabled 修改为 Boolean 类型

  • refactor:系统用户相关的 service 和 mapper 层,修改使用 Collection 接收参数,方便使用

  • refactor:TokenAttributeNameConstants 常量类拆分

  • refactor:UserInfoDTO 属性调整,新增了 menus 用于存储用户拥有的菜单对象集合,修改 roles 属性用于存储用户拥有的角色对象集合,原 roles 属性修改为 roleCodes 存储角色标识集合

  • refactor:为避免歧义,登录和自省端点返回信息中的属性名称 roles 修改为 roleCodes

  • bug:修复使用 ballcat-spring-boot-starter-web 时,若没有引入 security 依赖则启动异常的问题

  • refactor: system 相关事件优化调整

    1. 用户组织变动时发布 UserOrganizationChangeEvent 事件
    2. 用户新建的事件由 UserChangeEvent 修改为 UserCreatedEvent
    3. system 的 event 类从 biz 迁移到 model 模块中
  • refactor:ballcat-common-websocket 移除 MessageSender 接口,将其并入消息分发器 MessageDistributor

  • refactor:ballcat-spring-boot-starter-websocket 与 redis 解耦,将默认注册的消息分发器由 redis 改为 local,基于内存分发。可通过 ballcat.websocket.message-distributor 属性修改为 redis 或者 custom,值为 custom 表示,用户自己定制 MessageDistributor(如修改为使用 mq,可用性更高)

    yaml
    ballcat:
    	websocket:
    		# 默认为 local 仅支持单节点使用,redis 基于 PUB/SUB 消息订阅支持了集群下的消息推送问题
    		message-distributor: redis # local | redis | custom
  • refactor:ballcat-spring-boot-starter-redis 调整 AddMessageEventListenerToContainer 的注册方式,防止用户配置包扫描导致的加载顺序异常

  • refactor:有用户绑定组织时,不允许删除组织

Dependency

  • Bump spring-boot from 2.4.8 to 2.5.5
  • Bump lombok from 1.18.16 to 1.18.20
  • Bump mybatis-plus 3.4.4 to 3.4.3.4
  • Bump mybatis 3.5.6 to 3.5.7
  • Bump jsqlparser 4.0 to 4.2
  • Bump flatten-maven-plugin from 1.2.5 to 1.2.7
  • Bump spring-javaformat from 0.0.27 to 0.0.28
  • Bump hutool from 5.7.3 to 5.7.12
  • Bump spring-boot-admin from 2.4.2 to 2.5.1
  • Bump dynamic-datasource-spring-boot-starter from 3.3.2 to 3.4.1

[0.3.0] 2021-09-09

Warning

  • 多个模块包名调整,注意重新 import 对应路径
  • 国际化重构,改动较大,注意对应代码调整。国际化使用文档参看:http://www.ballcat.cn/guide/feature/i18n.html
  • 由于 ballcat-common-conf 的删除,非 admin 服务中的 mybatis-plus 的相关配置,如分页插件,批量插入方法的注入,需要按需添加。
  • 操作日志优化,修改了 OperationLogHandler 的相关方法,如果有自定义 OperationLogHandler ,需要注意同步更新
  • 现在资源服务器默认关闭了表单登录功能,可通过配置开启表单登录并指定登录页地址

Added

  • feat: 国际化功能的默认支持,新增 ballcat-i18n 相关模块,以便提供默认的业务国际化实现方式

  • feat: 登录用户名密码错误时的错误消息国际化处理

  • feat: ballcat-common-redis 针对 PUB/SUB 新增 MessageEventListener 接口,ballcat-spring-boot-starter-redis 中会自动注册所有实现 MessageEventListener 接口的监听器

  • feat: ballcat-common-redis 中的 @CacheDel 注解,新增 multiDel 属性,方便批量删除缓存

  • feat: 新增 ballcat-common-idempotent 幂等模块

  • feat: 针对 hibernate-validation 校验的提示消息,支持使用 {},占位替代 defaultMessage

  • feat: ballcat-common-core 中默认新增了 CreateGroupUpdateGroup 接口,方便分组校验使用

  • feat: 新增 ballcat-spring-boot-starter-web 模块,该模块基于 spring-boot-starter-web, 并使用 undertow 作为默认的嵌入式容器,且将 ballcat-common-conf 中对 web 应用的配置增强,如全局异常管理,以及 Sql 防注入处理,jackson 的默认配置等配置移动到此项目中

  • feat: ballcat-extend-mybatis-plus 模块中,为了支持连表查询的条件构建,新增 OtherTableColumnAliasFunction ,方便使用 LambdaAliasQueryWrapperX 进行关联表查询条件的构建

  • feat: ballcat-spring-boot-starter-easyexcel 支持导出时进行 Excel 头信息的国际化处理,使用 {} 进行占位表示,使用示例可参看 I18nData 的导出使用

  • feat: ballcat-spring-boot-starter-swagger 配置的扫描路径 basePackage ,支持使用 , 进行多包名的分割扫描

  • feat: ballcat-spring-boot-starter-datascope 中的数据权限控制注解 @DataPermission 扩展支持在 Mapper 之外使用,且支持方法嵌套调用时使用不同的 @DataPermission 环境

  • feat: ballcat-common-security 中资源服务器配置不再默认开启表单登录,新增两个配置属性用于开启并指定登录页地址:

    yaml
    ballcat:
    	security:
    		oauth2:
    			resourceserver:
    				# 是否开启表单登录,默认 false
    				enable-form-login: true
    				# 登录页地址,开启表单登录时生效,不配置则默认为 /login
    				form-login-page: http://login-domin

Changed

  • refactor: ballcat-common-conf 内原先对于 mybati-plus 的自动填充、分页插件、以及批量插入方法注入的配置移动到 ** ballcat-admin-core** 中

  • refactor: SpELUtils 改名为 SpelUtils,并移动到 ballcat-common-util 模块中

  • refactor: ApplicationContextHolder 改名为 SpringUtils,并移动到 ballcat-common-util 模块中

  • refactor: ballcat-spring-boot-starter-log 中拆分出 ballcat-common-log 模块,解决在 log-biz 模块中需要引入 starter 的问题,部分代码的包名有变更

  • refactor: ballcat-spring-boot-starter-redis 中拆分出 ballcat-common-redis 模块

  • refactor: 重构原先的国际化 i18n 功能,新增 ballcat-common-i18n 模块,移除原先的 ballcat-extend-i18n 模块

  • pref: 取消 ballcat-spring-boot-starter-webspring-security-core 的传递依赖

  • fix: 修复当查询一个不存在的系统配置后,由于缓存空值,导致添加配置后依然查询不到的问题

  • pref: 菜单查询的返回类型修改为 SysMenuPageVO

  • fix: 修复 excel 导出的 content-type 和实际文件类型不匹配的问题

  • fix: 提高缓存切面的 Order,使其在事务提交后执行更新或删除操作,防止并发导致缓存数据错误

  • pref: 菜单支持删除 icon

  • fix: 修复当菜单 id 修改时,未级联修改其子菜单的父级 id 的问题

  • pref: 优化操作日志,改为在方法执行前获取方法参数信息,防止用户在执行方法时将方法入参修改了

  • pref: ballcat-admin-core 中默认扩展 springboot 默认的 TaskExecutor 配置,将拒绝策略从抛出异常修改为使用当前线程执行

  • refactor: 移动 TreeNode 模型到 common-util 包中,以便减少 common-util 包的依赖

  • refactor: ballcat-spring-boot-starter-xss 抽象出 XssCleaner 角色,用于控制 Xss 文本的清除行为,方便用户自定义

  • pref: 用户登陆时的错误信息返回原始的细节信息,而不是全部返回用户名密码错误

  • fix: ballcat-system-biz websocket 包名拼写错误修复

Removed

  • 移除 ballcat-common-conf,相关代码拆分入 ballcat-spring-boot-starter-webballcat-admin-core

Dependency

  • Bump jsoup from 1.13.1 to 1.14.2

[0.2.0] 2021-08-11

Added

  • feat: 新增 ballcat-extend-redis-module 模块,提供对布隆过滤器的操作
  • feat: 新建用户时可以直接绑定用户角色,而不必分两次操作了
  • feat: 支持修改菜单ID,方便转移菜单位置时,保持菜单 ID 规则
  • feat: 新增 ballcat-common-security 模块
    • 新增 CustomRedisTokenStore 用于在序列化异常时,直接清除缓存。避免每次修改 UserDetails 时都需要用户手动去删除所有缓存信息
    • 迁移 PasswordUtils 从 common-util 到 common-security,且 PasswordEncoder 使用 DelegatingPasswordEncoder, 方便未来切换密码加密算法
    • 迁移 OAuth 相关的异常处理,从 ballcat-oauth-controller 到 common-secutiy
    • 新增 ResourceServer 相关配置以及基础组件,基于 SpringSecurity 5.X
    • SysUserDetails rename to User, sysUser 中的相关属性,现在直接写在 User 类中,同时删除了 userResource 和 userAttributes 属性,新增了 attributes 属性。

Changed

  • refactor: 数据权限 dataScopes 通过 ThreadLocal 进行方法间传递
  • refactor: 拆分 admin-websocket 模块,方便用户剔除不需要的组件.
  • refactor: ballcat-spring-boot-starter-websocket 模块中 websocket 相关的封装代码抽取到 ballcat-commo-websocket 模块,starter 仅保留自动配置相关代码
  • pref: 菜单的逻辑删除属性使用 mybatis-plus 的自动填充功能,且当菜单 ID 已使用时提示详情
  • pref: 精简了一些 common 模块中不需要的依赖
  • refactor: OAuth2 ResourceServer 底层从 spring-security-oauth2 依赖迁移至 SpringSecurity 5.x
  • pref: common-conf 中现在默认注册 jackson 的脱敏序列化器了,用户可以通过注册 name 为 ”desensitizeCustomizer“ 的 Jackson2ObjectMapperBuilderCustomizer bean,覆盖默认配置
  • refactor: ballcat-spring-boot-starter-log 和业务解耦,操作日志的生产和存储全部交由业务项目自己处理,ballcat-log-biz 模块中提供了默认的操作日志实体类,以及 OperationLogHandler 的默认实现
  • refactor: 由于 common-security 的抽取, ballcat-oauth 模块只剩下了授权相关,故更名为 ballcat-auth,同时做了一些结构上的调整,方便后续独立部署授权服务器。
    • 配置 ballcat.upms.loginCaptchaEnabled 现在调整为 ballcat.security.oauth2.authorizationserver.loginCaptchaEnabled ,用以控制登录验证码的开关
    • 配置 ballcat.security.ignoreUrls 现在调整为 ballcat.security.oauth2.resourceserver.ignoreUrls 用以控制资源服务器对部分 url 的鉴权忽略
    • 配置 ballcat.security.iframeDeny 现在调整为 ballcat.security.oauth2.resourceserver.iframeDeny 用于开启资源服务器的嵌入 iframe 允许
    • 新增 @EnableOauth2AuthorizationServer 注解,用以开启授权服务器 (ballcat-admin-core 模块中默认开启)

Removed

  • 移除 ballcat-oauth-model,相关代码迁入 ballcat-common-security

Dependency

  • Bump spring-boot from 2.4.3 to 2.4.8
  • knife4j from 2.0.8 to 2.0.9
  • hutool from 5.5.8 to 5.7.3
  • fastjson from 1.2.75 to 1.2.76
  • dynamic-datasource from 3.3.1 to 3.3.2
  • spring-boot-admin from 2.4.1 to 2.4.2
  • anji-captcha from 1.2.8 to 1.2.9

[0.1.0] 2021-06-28

Warning

  • 此版本重构了前端路由部分,服务端权限表 sys_permission 改为 sys_menu,改动较大,迁移时建议先备份原始数据,执行增量 sql 后若出现问题,再进行比对处理
  • 调整了模块名,sys => system,后续包名也都尽量不再使用缩写,注意修改对应类的引用包路径
  • 项目部分配置添加 ballcat. 前缀
    • 文件存储现在修改为了对象存储(OssProperties.java),配置前缀为 ballcat.oss
    • 登录验证码开关和超级管理员指定的配置(UpmsProperties.java),前缀为 ballcat.upms
    • 登录密码的 AES 加解密密钥,忽略鉴权的 url 列表,iframe 嵌入配置开关等安全相关的配置 (SecurityProperties.java),前缀为 ballcat.security
  • 模块拆分重构,原 admin.modules 下的 logsystemnotify 相关代码,全部独立模块。目前拆分为 modelbizcontroller 三层,方便按需引入。ballcat-admin-core 依然默认集成所有模块
    • log 模块涉及的表名以及类名修改,原 AdminXXXLog 类,全部去除 Admin 开头。表名前缀由 admin_ 修改为 log_
    • log 中的登录日志也不再默认开启,需要登录日志,可手动注册 LoginLogHandler 类,代码示例可参考 ballcat-sample-admin 项目中的 LogHandlerConfig
    • 同样访问日志和操作日志也需对应注册 handler,且在启动类上添加 @EnableXXXLog 注解
    • mapper.xml 文件移动,由于模块拆分,目前各模块的 mapper.xml 直接放置在了 mapper 文件夹下,对应的文件扫描配置 mybatis-plus.mapper-locations 需要修改为 classpath*:/mapper/**/*Mapper.xml
      yml
      mybatis-plus:
        mapper-locations: classpath*:/mapper/**/*Mapper.xml

Added

  • feat: 新增了国际化插件 i18n extend 和 i18n starter
  • feat: BusinessException 的错误消息支持占位符了
  • feat: PageParam 分页查询参数对象,支持用户自定义其子类以便做额外的功能处理
  • feat: TreeUtils 现在构建树时,支持传入 Comprator,进行自定义排序
  • feat: 新增 SmsUtils,以及 GSMCharst 类,用于短信长度计算
  • feat: 新增了一个根据用户id查询 UserInfo 的接口
  • feat: ballcat-extend-mybatis-plus 模块中添加普通枚举类型处理. 根据 name() 返回值判断枚举值
  • feat: ballcat-spring-boot-starter-easyexcel 新增 @RequestExcel 注解,方便导入 excel 直接解析为实体对象
  • feat: 新增了一个接口用于组织机构树形层级和深度的错误数据校正

Changed

  • refactor: SysPermission 移除,新增 SysMenu 类,相关关联类同步修改,减少了大部分的配置属性,转交由前端处理
  • refactor: Lov 实体修改为 SysLov
  • refactor: 移除 AdminRuleProperties.java,adminRule 相关配置与登陆验证码开关控制一并合入 UpmsProperties, 密码加密密钥配置并入 SecurityProperties,并将其配置前缀统一添加 ballcat.
  • refactor: SysUserDetailsServiceImpl.getUserDetailsByUserInfo 方法调整为 public 级别, 便于以api方式登录的请求注入用户信息
  • refactor: 重构了 excel 自定义头生成器的使用方式
  • refactor: 修改 AbstractRedisThread.getObjType 默认实现, 使其更符合大多数情况(获取失败的情况下子类重写此方法)
  • refactor: 文件存储 starter-storage 重构,修改为对象存储,使用 S3 协议和云端交互,所有支持 S3 协议的云存储都可以使用,如亚马逊、阿里云、腾讯云、七牛云
  • refactor: 移除 userInfoDTO 中的 roleIds 属性
  • refactor: 系统配置添加缓存注解,提升查询效率,更新和删除修改为使用 confKey, 而不是 ID
  • pref: 根据 mapstruct 官方文档,调整了 lombok 和 mapstruct 的依赖引入方式
  • pref: 所有 @RequestParam 和 @PathVariable 注解,指定 value 值,避免因环境问题,编译未保存参数名称,导致的参数绑定异常
  • pref: 简化微信原生支付方法
  • pref: 前后端交互密码解密异常时的错误日志以及响应信息优化
  • fix: 禁止删除有子节点的组织,以及不能修改父组织为自己的子组织
  • fix: 修复由于 mapstruct 的引入方式修改,导致 yml 中配置信息不提示的问题
  • fix: 修复 easyexcel 添加 password 后会导致 excel 文件打开异常的问题
  • pref: starter-log 和 starter-oss 模块包名拼写错误修复,commom -> common
  • refactor: AccessLogSaveThread 不再默认启动,AbstractQueueThread 中对非活动状态的线程进行启动,避免重复启动异常
  • fix: 修复组织架构移动到子层级时,导致其他节点的层级和深度被错误修改的问题(之前的错误数据可用此版本新增的校正功能修复)
  • fix: 修复操作日志添加参数忽略类型的异常问题

Dependency

  • Bump spring-boot-admin from 2.3.1 to 2.4.1
  • Bump virtual-currency from 0.4.1 to 0.4.2

[0.0.9] 2021-04-28

Warning

Added

  • feat: RedisHelper 工具类新增 list 的 rightPush 和 leftPop 方法
  • feat: 新增了一个基于 Redis 的线程队列
  • feat: 新增解绑用户角色关联关系的功能
  • feat: ExtendService#saveBatchSomeColumn 现在支持分批批量插入了
  • feat: admin-websocket 新增了 Lov 弹窗选择器修改时的 websocket 推送

Changed

  • refactor: 用户属性和用户资源抽象出接口,不再使用 Map 存储,具体使用类交由使用方进行构造,类似于 UserDetails

  • refactor: common-desensitize 优化,支持自定义注解脱敏

  • refactor: 抽象 AbstractThread 类. 让下级自定义 poll 和 put 方法.

  • refactor: AbstractQueueThread 添加程序关闭时的处理方法,防止停机时的数据丢失问题

  • refactor: 简化了支付宝和微信的回调类,并添加了验签方法

  • refactor: 使用 Jackson2ObjectMapperBuilder 构造 ObjectMapper,保留使用配置文件配置 jackson 属性的能力,以及方便用户增加自定义配置

  • refactor: xss 防注入重构,抽取成一个 starter,限制基于 jsoup 的白名单过滤,可自定义排除路径和请求类型的配置,admin-core 包现在默认集成此 starter

  • refactor: 工具类添加 finnal 关键字和私有构造

  • refactor: 修改 extends 下的三个支付模块的类路径, 把 starter 修改为 extend

  • refactor: 优化 JsonUtils 的类型转换

  • fix: 修复 LambdaQueryWrapperX#inIfPresent 参数错误处理成流,导致的 sql 拼接异常

  • fix: 修复当没有字典项时,无法正常删除字典的 bug

  • fix: 修复几次版本更新导致的代码生成器的各种 bug,如目录项拖动,以及zip 文件流末端损坏等

  • fix: 操作日志记录时,参数为 null 导致的空指针问题

Removed

  • 移除新酷卡短信组件
  • 移除 mybatis-plus-extend 中的 selectByPage 方法,因为其无法真正修改返回类型,现在使用 page.convert 进行 数据转换

Dependency

  • Bump virtual-currency from 0.3.2 to 0.4.1
  • Bump spring-boot-admin from 2.4.0 to 2.3.1

[0.0.8] 2021-03-04

Warning

  • 更新了 Service 层的父类,现在无法直接使用 service 对象,进行 Wrapper 条件构造
  • 更新了分页查询的排序参数,前端需要对应升级
  • commom-model和common-util的抽离,导致部分工具类和部分通用实体包名修改, 请注意替换

Added

  • feat: Swagger3 支持,文档地址更新为 /swagger-ui/index.html
  • feat: 剥离全局异常捕获中请求方法和请求媒体类型不支持的异常,方便生产环境排查问题
  • feat: 新增 common-desensitize 脱敏模块,默认提供了部分常用脱敏类型,且支持SPI形式追加用户自定义脱敏处理器
  • feat: 新增 pay-ali 模块,用于支持支付宝支付
  • feat: 新增图形验证码开关配置,默认开启
  • feat: 分页查询出入参封装,提供 PageParam 作为入参,PageResult 作为出参,不再用 Page 贯穿
  • feat: 密码在日志中的存储脱敏
  • feat: 数据权限注解提供对于指定 Mapper类,或指定方法的数据权限关闭功能
  • feat: 添加 JsonUtils 根据依赖执行对应的json处理方法
  • feat: 添加 RedisHelper 提供对redis的常用方法支持
  • test: 对 client test 跳过登陆验证和密码解密,便于测试,注意生产环境不要开启 test client

Changed

  • refactor: 取消了项目文件格式化指定换行符使用 LF 的限制
  • refactor: 分页查询的排序参数属性修改,用于支持多列排序
  • refactor: mybatis-plus-extend 扩展包调整
    • 新增 LambdaQueryWrapperX ,提供 ifPresent 方法,用于简化条件判断
    • 新增 LambdaAliasQueryWrapperX 用于构造带别名的条件语句和查询sql
    • ExtendMapper 新增 selectByPage 方法,扩展自 selectPage 方法,支持查询数据直接转换为 VO 的映射
    • ExtendMapper 新增 insertBatchSomeColumn,使用 insert into 方式进行插入,提升批量插入效率
    • ExtendService 扩展自 IService,但是取消所有对外暴露 Wrapper 参数的方法,便于规范代码分层
  • refactor: 所有 Service 改为继承 ExtendService,所有 Mapper 改为继承 ExtendMapper,且所有查询 条件构造下沉入DAO 层
  • refactor: 部分方法名修改,查询方法返回结果为集合时,方法名使用 list 开头
  • refactor: 钉钉消息通知优化,每次通知使用新的 request 实例
  • refactor: 访问日志默认忽略验证码获取请求,操作日志忽略 MutipartFile 类型的参数记录
  • refactor: 用户密码在 service 使用明文密码交互,AES 加解密在 controller 或者过滤器中完成
  • refactor: 密码加解密密钥的配置添加 ballcat 前缀:ballcat.password.secret-key
  • refactor: hutool 改为按需引入
  • refactor: 取消代码文件换行符强制使用 LF 的限制
  • refactor: 取消 jackson 配置中,全局 Null 值转 '' 的处理,但是以下对 类型 Null 值特殊处理
    • String Null 转 ''
    • Array 和 Collection Null 转 []
    • Map Null 转 {}
  • refactor: 从 common-core 中剥离出 common-util 和 common-model

Removed

  • 移除 mybatis-plus-extend-mysql 扩展包,相关方法移入 mybatis-plus-extend 扩展中
  • 移除 model 的 AR 模式支持
  • 移除 hibernate-validator 的版本指定,改为跟随 spring-boot 的依赖版本
  • 移除 JacksonUtils

Dependency

  • Bump spring-boot from 2.4.1 to 2.4.3
  • Bump mapstruct from 1.4.1.final to 1.4.2.final
  • Bump spring-javaformat-maven-plugin 0.0.26 to 0.0.27
  • Bump hutool from 5.5.7 from 5.5.8
  • Bump mybatis-plus from 3.4.1 to 3.4.2
  • Bump dynamic-datasource from 3.2.0 to 3.3.1
  • Bump spring-boot-admin from 2.3.1 to 2.4.0
  • Bump oss.aliyun from 3.8.0 to 3.11.3
  • Bump anji-captcha 1.2.5 to 1.2.8

[0.0.7] 2021-01-19

Added

  • feat: 多页签导出支持每个页签不同头类型
  • feat: 新增创建人和更新人的自动填充支持
  • feat: 提供ExcelWriterBuilder,使用者可以复写此接口方法,来对excel导出做自定义处理
  • feat: 数据权限注解 @DataPermission 提供方法级别的忽略支持
  • add: 新增 HtmlUtil,方便快捷提取 html 中的纯文本,且保留换行结构
  • feat: 代码编辑器的模板编辑框提供全屏功能
  • feat: 新增用户成的发布事件
  • feat: 新增登陆时的图形验证码校验,提升安全性
  • feat: 新增虚拟货币的支付stater支持
  • feat: 新增基于 websocket-starter,方便系统集成 websocket 使用
  • feat: 新增系统公告,支持多种方式指定接收人,以及多种公告推送方式
  • feat: 新增 admin-websocket 插件包,引入此依赖,可获得实时的站内公告推送以及字典项更新推送能力,默认使用redis发布订阅进行集群支持,用户可通过自定义 MessageDistributor 来更换消息分发模式,比如使用专业的消息队列,也提供了 LocalMessageDistributor,在单节点时使用此分发器,更高效稳定

Changed

  • refactor: 代码格式化强制换行符使用 LF,保证跨系统协同开发的统一性
  • refactor: mail-stater 的结构微调,修改了部分类名
  • refactor:调整了系统的依赖结构,将 spring 相关依赖版本管理由父工程移动到 ballcat-dependencies 中

Bug

  • fix: 修复由于SpringMvc5.3版本后的跨域通配符使用方式导致 swagger 跨域配置 * 号无法生效的问题
  • fix: 修复字典项删除时未更新hashcode 导致的前台缓存问题
  • fix: 添加依赖,修复高版本 lombok 和 mapstruct 的冲突问题
  • fix: 修复代码生成器模板生成失败以及无法平移文件的问题
  • fix: 修复操作日志在记录入参时,若参数中含有 request 或 response 导致的堆栈溢出问题

Dependency

  • Bump spring-boot from 2.4.0 to 2.4.1
  • Bump mapstruct from 1.3.1.final to 1.4.1.final
  • Bump spring-javaformat-maven-plugin 0.0.25 to 0.0.26

[0.0.6] 2020-12-03

Warning

  • 更新了 UserDetail,缓存反序列化将会出现问题,更新版本前需要清除对应缓存
  • 返回体结构修改,属性 msg 修改为 message,可能影响前端信息展示,接入系统的第三方的响应数据接收,升级前需提前沟通

Added

  • feat: 新增组织机构(部门),用户与组织机构为一对一的关系
  • feat: 数据权限,利用 mybatis 拦截器对 sql 进行拦截约束,约束规则支持自定义,适用于大部分数据权限控制。
  • feat: 角色新增 scopeType,暂时支持全部,本人,本部门,本人及子部门等几种范围类型
  • feat: 新增短信发送 stater
  • feat: excel导出支持自定义头信息
  • feat: 新增 JacksonUtils,方便全局统一 objectMapper 配置

Changed

  • fix: 修复没有提供默认 profile,导致用户不指定 profile 时,全局异常处理无法正常初始化的问题
  • refactor: Lov 模块调整
  • refactor: lovBody 和 lovSearch 关联属性由 lovId 更改为 keyword
  • refactor: UserDetails 属性重构,抽象出用户资源(userResources)和用户属性(userAttributes),默认将用户的角色和权限作为资源存入userResources. 可以重写UserInfoCoordinator类,来根据业务调整用户资源和用户属性
  • refactor: kafka 消费者配置提供
  • refactor: 返回体结构修改,属性 msg 修改为 message
  • refactor: xss 和 monitor auth 过滤器提供开关,并调整了配置前缀
  • refactor: 用户角色,角色权限的关联,由 role_id 修改为使用 role_code
  • fix: 系统用户查询时组织机构ID为空不为null时导致的异常
  • refactor: 字典附加属性,value值修改为object类型
  • fix: 修复用户在容器初始化前使用缓存注解时,CacheLock未初始化导致的异常问题
  • fix: 移除 hutool json 的使用(该工具类部分情况下可能导致栈溢出)
  • refactor: 支持用户select数据查询接口使用 userTypes 进行多类型筛选,删除原先的地址栏占位符查询方式

Dependency

  • Bump spring-boot from 2.3.4 to 2.4.0

[0.0.5] 2020-09-18

Added

  • Lov 模块
  • 字典相关
    • feat: DictItemVO 新增 id 属性
    • feat: 字典项新增 attributes 属性,用于定制额外的非必须属性,如颜色等供前端使用

Changed

  • refactor: ApplicationContextUtil 更名为 SpringUtil

  • refactor: LogUtil#isMultipart 去除只判断 POST 请求的限制

  • 全局异常&异常通知

    • fix: 修复异常通知 message 为 null 时导致的异常

    • fix: 修复类校验失败时,无法正常返回错误信息的

    • feat: 异常通知添加 hostname 和 ip 信息

    • fix: 捕获空指针异常时,会导致异常通知空指针的问题

    • fix: 异常通知 cpu 占用过高问题

    • feat: 添加忽略指定异常类的配置

    • refactor: 优化钉钉通知的http请求方式

    • style: 通知信息中的英文冒号转为中文冒号

    • refactor: 除未知异常外,取消全局异常捕获时的异常打印,如需详细堆栈可以在异常处理类中进行处理

  • feat: AbstractQueueThread#preProcessor 修改为 public,便于子类重写

  • fix: 修复包装 RequestBody 导致,表单数据无法正常读取的bug

  • fix: 修复在前台页面新建权限时无法指定主键 Id 的异常

  • feat: extend-mybatis-plus 中批量插入方法,将生产的主键回填到实体中

  • refactor: 登陆日志和操作日志分离

  • fix: 修复用户登陆后将密文密码返回前台的安全隐患问题

  • style: 代码生成器样式微调

Dependency

  • Bump spring-boot from 2.3.1 to 2.3.4
  • Bump mybatis-plus from 3.3.2 to 3.4.0
  • Bump hutool from 5.3.10 to 5.4.1
  • Bump spring-java-format from 0.0.22 to 0.0.25

[0.0.4] 2020-08-14

Added

  • 新增 kafka stater 模块
  • 新增 mybatis-extends 扩展,添加批量插入方法
  • accesslog 提供 responseWrapper,方便记录响应数据
  • swagger stater 新增 additionalModelPackage 属性,用于扫描一些额外的 swaggerModel
  • 异常捕获新增对 MethodArgumentTypeMismatchException 的处理
  • 新增 Security 是否开启禁止 iframe 嵌入的配置控制

Changed

  • AbstractQueueThread 提高默认的批处理大小
  • 代码生成器移除加载动态数据源时指定的 driverClassName
  • 移除 admin-core 默认引入的 swagger 依赖,现在用户可以在自己的项目中选择引入
  • 移除 JacksonConfig#ObjectMapper 的 @Primary 注解,便于用户自定义
  • 数据字典优化,支持批量请求,接口地址调整
  • 调整前后端传输密码使用的 AES Padding mode 为 PKCS5Padding
  • 修复因 TokenStore 与 cachePropertiesHolder 加载顺序导致的启动异常
  • 修复 codegen 无法选择 master 之外的数据源进行代码生成的bug
  • 当使用 DingTalk 异常通知时,会 @所有人
  • 字典添加值类型字段,便于前端回显,以及后续校验控制

Dependency

  • swagger up to 1.5.21
  • dynamic-datasource up to 3.2.0
  • spring-boot-admin up to 2.2.4
  • easyexcel up to 2.2.6

[0.0.3] 2020-07-06

Added

  • 重构代码生成器

    • 前端使用 ant-design-vue 重构,支持单体应用以及前后端分离两种部署方式
    • 多数据源支持,动态添加删除,生成时选择对应数据源进行代码生成
    • 代码生成结构调整,支持自定义代码生成结构
    • 支持在线模板编辑
    • 支持自定义模板属性,定制模板
  • 提供 dingTalk-starter,简化 dingTalk 接入

  • 提供 kafka 扩展,以及kafka流式处理扩展包

  • 记录登陆登出日志

  • 自动填充(逻辑删除标识),新建时增加对字段名为 deleted 且 类型为Long的属性填充,填充值为 0

  • 超级管理员配置,可根据userid 或 username 指定当前项目的超级管理员(即最多可配置两个超级管理员),超级管理员默认拥有所有权限,不可删除,仅自己可以修改自己的信息 如下配置:指定了 userId 为 1 或者 username 为 admin 的用户为超级管理员

    yaml
    ballcat:
        admin:
            rule: 
                userId: 1  
                username: admin

Changed

  • 访问日志忽略路径修改为可配置

  • 角色新增类型属性,对于系统类型角色,不允许删除

  • 更新逻辑删除不能使用 unique key 的问题,逻辑删除使用时间戳,未删除为0,删除则为删除的时间戳,实体类字段同一使用Long,数据库使用bigint。

    • 配置文件添加如下配置:

      yaml
      mybatis-plus:
        global-config:
          db-config:
            logic-delete-value: "NOW()" # 逻辑已删除值(使用当前时间标识)
            logic-not-delete-value: 0 # 逻辑未删除值(默认为 0)

Dependency

  • mybatis-plus 版本升级至 3.3.2
  • spring-boot 版本升级至 2.3.1.RELEASE
  • spring-security-oauth2 升级至 2.3.8.RELEASE

[0.0.2] 2020-06-04

Added

  • 更新系统配置表,重命名为 sys_config, 并调整包位置,并入sys模块下。

  • 模块重构,调整部分common下的模块,修改放入starter

  • 合并 simple-cache,后续直接引入ballcat-spring-boot-starter-redis模块,即可开启全局key前缀,以及缓存注解功能

  • traceId跟踪,引入ballcat-spring-boot-starter-log,会自动为每个请求的日志上下文中注入TraceId

  • operation_log、admin_access_log表新增字段 trace_id,类型char(24).

  • logback-spring.xml 彩色日志模板中,加入%clr([%X{traceId}]){faint},文件日志模板加入[%X{traceId}],用于打印traceId

  • 移除api_access_log表,以及相关代码

  • 更新日志,追加追踪ID,操作类型

  • core项目更新为自动装配,可以删除项目Application中的 @ServletComponentScan("com.hccake.ballcat.admin.oauth.filter") 注解。

    @MapperScan("com.hccake.ballcat.**.mapper")@ComponentScan("com.hccake.ballcat.admin") 注解上的这两个包扫描也可去掉。