# Changelog ![Maven Central](https://img.shields.io/maven-metadata/v.svg?metadataUrl=https://repository.mingliqiye.com/repository/maven-public/com/mingliqiye/utils/mingli-utils/maven-metadata.xml&label=Mingliqiye%20Maven%20Public) 本文件记录 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`;迭代器改为基于 `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 缩进并补全尾随逗号。