yexuejc-base/CHANGELOG.md

更新日志

所有 notable changes 将记录在此文件中。

格式基于 Keep a Changelog， 版本号遵循 Semantic Versioning。

[Unreleased]

Fixed - 代码质量全量审计修复 (2026-05-16)

• [Blocker#1] RSA.java: switch 表达式 → if-else（jre8/jre11 兼容）
• [Blocker#2] JwtUtil.java: var → 显式类型 + instace() → instance() 拼写修正
• [Blocker#3] RequestHeader.java: geRespTime() → getRespTime() 拼写修正
• [Blocker#4-5] ImgUtil/FileUtil: connectBytes() 数组拷贝参数 Bug 修正
• [Blocker#6] ObjUtil.java: System.out.println → 日志框架
• [Major] DateTimeUtil.java: 30+ 方法补全 @param/@return Javadoc
• [Major] FileInput.java: 12 方法 Javadoc + Scanner 改 try-with-resources
• [Major] AlgorithmUtil.java: Javadoc 规范化 + StringBuffer→StringBuilder
• [Major] MoneyUtil.java: Javadoc 补全 + toFen() 返回类型 int→long 防溢出
• [Major] FileUtil/JsonUtil/SysUtil: 日志统一、异常处理改进、线程安全优化
• [Major] 全部常量类 DateConsts/SymbolicConsts/RespConsts 注释补全
• [Minor] BaseVO: serialVersionUID @Serial + Mdfy→Modify(@Deprecated 过渡)
• ⚠️ 破坏性变更: JwtUtil.instace()→instance(), .geRespTime()→getRespTime(), MoneyUtil.toFen() 返回值 long

Added

• 添加 JaCoCo 代码覆盖率插件（目标 60%）
• 添加 Checkstyle 代码规范检查（Google Style）
• 添加 PMD 静态代码分析
• 添加 CONTRIBUTING.md 贡献指南
• 添加 CODE_OF_CONDUCT.md 行为准则
• 添加 SECURITY.md 安全政策
• CsvUtil 新增 Bean 转 CSV 数据行功能（beanToCsvData()）

Security

• [P0] AES CBC 模式使用随机 IV（S3）
• [P0] AES getKey/getIv 返回副本并标记 @Deprecated（S1/S2）
• [P0] 移除异常消息中的敏感数据（S6）
• [P0] 统一 Jackson 版本，排除 jjwt 传递依赖

[1.6.0-jre21] - 2026-04-16

Added

• 三个分支（jre8/jre11/jre21）架构对齐，统一类命名
• jre8 分支移植 jre11/jre21 新增功能（DES3、BaseException、MsgUtil、ZipUtil 等 15 个文件）
• 新增 @ToUeProperty 注解支持 ignore 属性
• 新增 MsgUtil 多语言消息工具（ServiceLoader SPI 机制）
• 新增 ZipUtil ZIP 压缩工具（基于 zip4j）
• 新增 FileInput 文件读取 POJO
• 新增统一的 Response 体系（BasicResponse/ListResponse/ObjectResponse/SignRequest/SignResponse）
• 新增单元测试（加密模块、异常模块、工具类测试）
• 新增 8 个模块功能说明文档（doc/）
• 新增 14 个功能改善建议文档（upgrades/）
• 新增 FEATURE_LIST.md 三分支功能对比列表
• 新增 MIT 开源协议

Changed

• jre8 废弃移除旧架构文件（ThreeDES、RespsConsts、Resps、ApiVO、ParamsPO）
• 重写 README.md（功能模块总览、多版本使用指引、分支说明）

[1.5.7-jre11] - 2024-XX-XX

Changed

• 优化 AES、DES3 和 RSA 加密实现并增强安全性

[1.5.6-jre11] - 2024-XX-XX

Changed

• 优化 response vo
• 单元测试完善

[1.5.5-jre11] - 2024-XX-XX

Added

• 删除 ApiVO，新增 BasicResponse/ObjectResponse/ListResponse 处理返回参数
• DateConsts 增加常量

Changed

• 优化常量命名

[1.5.4-jre11] - 2024-XX-XX

Changed

• 优化 RSA 加签验签部分

[1.5.3-jre11] - 2024-XX-XX

Added

• RSA 增加枚举（SignAlgorithm）

Changed

• 依赖库升级

[1.5.2-jre11] - 2024-XX-XX

Added

• FileInput 从 FileUtil 中提取为独立 POJO
• StrUtil 增加异常堆栈转字符串方法 printStackTrace

Changed

• 升级相关依赖

[1.5.1-jre11] - 2024-XX-XX

Added

• RSA 支持传入已初始化密钥对，避免重复生成
• RSA 支持证书模式（从证书文件加载公钥/私钥）

Changed

• 优化 RSA 密钥生成逻辑

[1.5.0-jre11] - 2024-XX-XX

Added

• 新增 RSA2 工具类（支持更灵活的密钥管理）
• 新增 DES3 工具类（三重 DES 加密）
• 新增多种加密模式支持（CBC/GCM/CFB/OFB/PCBC）

Changed

• 重构加密模块架构
• 优化异常处理机制

[1.4.0-jre8] - 2023-XX-XX

Added

• 初始版本发布
• 基础工具类（StrUtil、DateUtil、FileUtil 等）
• AES/DES 加密支持
• JSON 处理工具（基于 Jackson）

---

版本说明

版本号格式

主版本号.次版本号.修订号-分支标识

示例：1.6.0-jre21

分支对应关系

分支	Java 版本	说明
jre21	Java 21+	主开发分支，包含最新特性
jre17	Java 17+	LTS 版本支持
jre11	Java 11+	LTS 版本支持
jre8	Java 8+	兼容旧项目

更新类型

• Added: 新功能
• Changed: 功能变更
• Deprecated: 已废弃功能
• Removed: 已移除功能
• Fixed: 问题修复
• Security: 安全修复