Under-Utils
stable 1.0.2 1.0.3-SNAPSHOT
docs/releases/v1.0.1.md

v1.0.1 发布说明

1.0.1 是 1.0.0 之后的兼容增强版本,重点补齐开源发布后的工程化能力、示例和文档。该版本不改变 Maven 坐标,不删除 public API,不调整 starter 的默认开关语义。

1.0.11.0.0 之后的兼容增强版本,重点补齐开源发布后的工程化能力、示例和文档。该版本不改变 Maven 坐标,不删除 public API,不调整 starter 的默认开关语义。

新增能力

  • under-utils-biz 新增异步导入任务模板、进度快照、进度监听器和行级错误 CSV 导出工具。
  • under-utils-redis 新增缓存观测 SPI,覆盖 cache-aside 与 logical-cache 的命中、未命中、加载、写入、重建锁和后台刷新事件。
  • under-utils-http 新增 RefreshingAccessTokenProvider,支持 access token 本地缓存、提前刷新和并发刷新收敛。
  • under-utils-samples 新增异步导入提交/查询/错误导出接口、OpenAPI token 刷新与业务错误解码示例,以及自定义 store/codec/observer profile。

文档与维护

  • README、Quick Start、模块 README、CHANGELOG 和 API Review 统一中文开源社区风格。
  • 新增兼容性策略文档,明确 1.x 版本的 public API 范围、破坏性变更定义和弃用流程。
  • 新增 patch/minor 发布说明模板,后续发布可直接复用。
  • MyBatis README 补充多数据源下 interceptor 与审计填充配置说明。

测试

  • 补充 Redis cache observer、starter observer 注入、OpenAPI token 刷新、导入异步任务和错误导出的单元测试。
  • GitHub Actions 覆盖默认编译、默认测试和 Testcontainers 集成测试。

兼容性

  • 源码兼容:是。
  • Maven 坐标:不变。
  • 配置 key:不变。
  • starter 默认行为:不变。
  • 迁移要求:无。

发布前验证

mvn test
mvn -Prelease -DskipTests package
mvn -Pintegration-tests -pl under-utils-test -am -DskipTests test-compile