Gitea Actions Build / Build (push) Canceled after 0s
版本号升级至 5.5.4,CHANGELOG 记录 hash 哈希体系、springboot 注解 迁移、Log4j2 XSD、MediaType 格式化与 signing 笔误修复。
93 lines
4.5 KiB
Markdown
93 lines
4.5 KiB
Markdown
# Changelog
|
||
|
||

|
||
|
||
本文件记录 mingli-utils 各版本的主要变更。
|
||
|
||
## [5.5.4] - 2026-11-18
|
||
|
||
### 新增
|
||
|
||
- **hash**:新增 `HashCodec` 哈希编解码器接口——实现类只需重写 `hash(InputStream)` 一个方法,
|
||
字节数组/字符串/文件/路径重载、十六进制输出(`hashHex`)与基于 `MessageDigest.isEqual`
|
||
的常量时间校验(`verifyHash`)均由默认实现提供;新增 `MessageDigestCodec` 流式基类
|
||
(8KB 缓冲、恒定内存、不关闭调用方流)及 13 种 JDK 标准算法实现
|
||
(MD2、MD5、SHA-1、SHA-224/256/384/512、SHA-512/224、SHA-512/256、SHA3-224/256/384/512);
|
||
提供 `HashUtils` 懒加载单例(`MD2`~`SHA512256`)与 `HashType` 枚举;
|
||
新增 `TestHash` 测试覆盖已知向量、全部算法一致性、流生命周期与文件/路径重载。
|
||
- **test**:新增非官方 Log4j2 配置 XSD(覆盖 21 种 Appender、13 种 Layout、11 种 Filter、
|
||
滚动策略与清理条件等,未知插件元素以开放内容模型放行),`log4j2.xml` 接入 Schema 校验。
|
||
|
||
### 变更
|
||
|
||
- **springboot**:事件监听注解迁移为 Java 实现——新增 `ApplicationReadyEventListener`、
|
||
`ContextClosedEventListener`;`ApplicationStartedRunner`、`ApplicationDestroyedRunner`
|
||
标记为废弃;移除 Kotlin 版注解及 `ApplicationListener`、`ApplicationRunnerData`;
|
||
`Okhttp3AutoConfiguration` 改用 `@ContextClosedEventListener`。
|
||
- **http**:`MediaType` 枚举项之间补充空行(纯格式化,无内容变更)。
|
||
|
||
### 修复
|
||
|
||
- **build**:修正 `signing.secretKeyRingFile` 属性名笔误(误插入空格)。
|
||
|
||
### 文档
|
||
|
||
- hash 包全部接口、类、枚举与懒加载单例补全中文 KDoc;
|
||
4 个 Spring Boot 事件监听注解补全 Javadoc。
|
||
|
||
## [5.5.2] - 2026-11-17
|
||
|
||
### 新增
|
||
|
||
- **tuple**:实现 `Tuple.compareTo` 字典序比较——同类型可比较元素按自然顺序,
|
||
其余按字符串形式比较;公共前缀相等时元素个数较少的元组在前。
|
||
新增 `TestTuple` 测试覆盖 6 种比较场景。
|
||
|
||
## [5.5.1] - 2026-11-17
|
||
|
||
### 新增
|
||
|
||
- **json**:新增 `reader` / `witer` / `judgment` 三组抽象,为 Jackson2 与 Jackson3 分别提供
|
||
`JsonReader`、`JsonArrayReader`、`JsonObjectReader`、`JsonWriter`、`ArrayWriter`、`ObjectWriter`
|
||
与 `ReaderJudgment` 实现(`BaseJsonReader` / `BaseJsonWriter` / `BaseJsonJudgment` 等基类)。
|
||
- **exception**:新增 `JsonFormatException`,表示 JSON 格式错误,继承自 `JsonException`。
|
||
- **time**:`DateTime.now(zone)` 支持指定时区;新增 `DateTime.atZone(zoneId)` 时区转换方法,
|
||
`toString()` 输出包含 `zoneId`。
|
||
|
||
### 变更
|
||
|
||
- **json**:重构转换器体系——移除按类型划分的 `BaseJsonIntConverter`、`BaseJsonStringConverter`
|
||
等 10 个转换器及 `JsonConverter` 接口,统一由 `BaseJsonConverter` 与 `JsonConverterUtils` 处理;
|
||
简化 `DateTimeJsonConverter`、`UUIDJsonConverter`、`NetworkEndpointJsonConverter` 与
|
||
Jackson2/Jackson3 序列化/反序列化桥接实现;精简 `JSONA` 与 `JsonApi` 门面。
|
||
- **tuple**:`Tuple` 声明实现 `Comparable<Tuple>`;迭代器改为基于 `toMutableList()` 的简化实现。
|
||
- **springboot**:`JsonAutoConfiguration` 与 `JacksonJsonBuilder` / `JacksonJsonBuilderImpl`
|
||
同步适配新的 JSON 转换器体系。
|
||
|
||
### 文档
|
||
|
||
- 补全 src 下全部 Kotlin 文件的中文 KDoc 与 Java 文件的 Javadoc(约 1.3 万处),
|
||
覆盖 exception、json、springboot、mybatis/mybatisplus、thread/netty/http、
|
||
Tuple1~Tuple100 生成类、MediaType 全部枚举项及测试代码;已有文档保持不变。
|
||
|
||
## [5.4.4] - 2026-11-17
|
||
|
||
- 构建脚本调整(build.gradle.kts 发布配置完善)。
|
||
- SpringBoot 自动配置重构:新增 `JsonAutoConfiguration` 与 `JacksonBuilder`,
|
||
精简 Jackson2/Jackson3 JsonApi 自动配置。
|
||
|
||
## [5.4.3] - 2026-11-17
|
||
|
||
- 新增 `JacksonJsonBuilder` / `JacksonJsonBuilderImpl` 构建器。
|
||
- `DateTime`、`UUID` 小幅调整;补充 log4j2 测试配置。
|
||
|
||
## [5.4.2] - 2026-11
|
||
|
||
- 修复 `JSONA.jsonApi` 编译错误。
|
||
- **mybatisplus**:新增 `FastBaseIServiceNew3518`(适配 MyBatis-Plus 3.5.18)。
|
||
|
||
## [5.4.0] - 2026-11
|
||
|
||
- **mybatisplus**:新增 `FastBaseIService`。
|
||
- 全项目统一 Tab 缩进并补全尾随逗号。
|