simple-jdbc/CHANGELOG.md

Changelog

[1.1.0] - Unreleased

⚠️ 破坏性变更

• DefaultBeanRowMapper.of() 不再抛出 SQLException：工厂方法在反射异常时改为抛出非受检异常 IllegalStateException。调用方如果 catch (SQLException e) 包裹 of() 调用，该捕获将失效，需移除相关 catch 块或改为捕获 IllegalStateException。

新增

• queryValueOrDefault(sql, params, Class<T>, T defaultValue)：查询单行单列，结果为空时返回指定默认值
• queryValueOrDefault(sql, Class<T>, T defaultValue)：无参数重载
• 补充 QueryTest 中 queryValueOrDefault 单元测试 6 个

重构

将单列查询方法标记为过时，消除 Class 参数重载歧义

• queryList(sql, params, Class<T>) → 已过时，请使用 queryValues(sql, params, Class<T>) 语义明确为"多行单列 → 值列表"，不与整行 RowMapper 重载混淆
• queryFirst(sql, params, Class<T>) → 已过时，请使用 queryValue(sql, params, Class<T>) 语义明确为"单行单列 → 单值"，不与整行 RowMapper 重载混淆
• 同时将对应的无参数重载标记为过时：
  • queryList(sql, Class<T>) → 请使用 queryValues(sql, Class<T>)
  • queryFirst(sql, Class<T>) → 请使用 queryValue(sql, Class<T>)
• 旧方法将在后续版本中移除

文档

• 优化 DefaultBeanRowMapper 类注释，明确性能限制和使用建议

---

[1.0.0] - 2026-06-17

重构

• 移除 plusone-commons 及 Guava 依赖，内化 AssertTools、NamingTools、ThrowingConsumer、ThrowingPredicate 工具类
• 将 batchUpdate 中断时对 BatchUpdateResult 的变更逻辑内化到 BatchUpdateResult 中

测试

• 添加 ParamBuilderTest#buildParamsTemporal 测试方法验证时间类型参数构建
• 添加 TransactionTest 事务异常测试用例
• 补充测试数据库初始化脚本注释

文档

• 新增 CHANGELOG.md 文件记录各版本更新内容
• 优化 README 文档结构与内容
• 补充 ParamBuilder 和 SimpleJdbcTemplate 的文档注释
• 更新 DefaultBeanRowMapper 类文档注释，强调使用场景

---

[1.0.0-RC3] - 2026-06-05

新增

• ResultHandler 新增静态工厂方法 mapToList(RowMapper)，消除各处 ResultSet 遍历重复代码

重构

• JdbcOperationSupport 中无参数 SQL 统一改用 Statement 执行，避免创建空参数 PreparedStatement
• ParamBuilder#buildParams 为常用数据类型（CharSequence/Number/Boolean/Temporal）添加短路处理，优化参数构建性能

测试

• 重构 UpdateTest，补全 Statement 路径覆盖

文档

• 更新 README.md 使用说明和示例
• 更新 DefaultBeanRowMapper 类文档以避免歧义
• 更新项目简介

---

[1.0.0-RC2] - 2026-05-31

新增

• TransactionTemplate 从 SimpleJdbcTemplate 中分离为独立类，封装事务生命周期管理（开启/提交/回滚/恢复自动提交）
• SimpleJdbcTemplate.transaction() 暴露 TransactionTemplate 实例
• 新增 ParamBuilderTest 单元测试
• 新增 Instant 类型参数端到端测试

重构

• 简化 ParamBuilder 参数构建逻辑
• 优化批量更新批次内索引计算逻辑

文档

• 完善 SimpleJdbcTemplate 类文档注释
• 更新批量更新相关类（BatchUpdateResult/BatchUpdateStatus/BatchUpdateErrorInfo）的 JavaDoc
• 更新 README 使用说明和示例

其他

• 版权年份由固定范围更新为包含当前时间的表述

---

[1.0.0-RC1] - 2026-05-29

项目首个正式发布的候选版本（2023-07 从 plusone-commons 独立开发）。

新增

核心框架

• SimpleJdbcTemplate 核心模板类，封装 JDBC 连接管理、异常处理和资源释放
• JdbcOperations 接口规范，定义统一的数据库操作 API
• JdbcOperationSupport 静态工具类，封装底层 PreparedStatement / Statement 操作

查询

• query + ResultHandler：自定义 ResultSet 处理
• queryList：返回列表（支持 RowMapper、Class、Map<String, Object> 三种变体）
• queryFirst：返回 Optional<T>（支持 RowMapper、Class、Map<String, Object> 三种变体）
• queryBoolean：返回 boolean，结果集为空时返回 false
• 全部查询方法提供无参数重载

更新

• update：执行 INSERT / UPDATE / DELETE，返回影响行数
• updateAndReturnKeys：执行 DML 并返回自动生成的主键，支持 RowMapper 映射
• batchUpdate：分批执行 DML，支持非静默模式（遇错中断）和静默模式（遇错继续）

批量更新结果

• BatchUpdateResult：封装批次级粒度的执行结果（总数据量、批次计数、成功/失败/剩余批次）
• BatchUpdateStatus 枚举（SUCCESS / COMPLETED_WITH_ERRORS / INTERRUPTED）
• BatchUpdateErrorInfo：封装错误批次的异常详情

参数构建

• ParamBuilder.buildParams：构建 Object[] 参数数组，支持 Optional / OptionalInt / OptionalLong / OptionalDouble 自动拆箱
• ParamBuilder.buildBatchParams：批量构建 List<Object[]> 参数列表

映射策略

• RowMapper 函数式接口：ResultSet 单行映射
• RowMapper.HASH_MAP_MAPPER：将行数据映射为 Map<String, Object>
• DefaultBeanRowMapper：默认 Bean 映射实现，自动匹配 属性名（小驼峰）↔ 列名（小写蛇形），通过反射调用 setter
• RowMapper.beanRowMapper(Class) / beanRowMapper(Class, Map) 静态工厂方法

事务

• TransactionException：包装事务执行中的原始异常
• commitIfTrue 方法：根据业务逻辑返回值（true 提交 / false 回滚）控制事务

测试

• 基于 H2 内存数据库的集成测试体系
• 覆盖查询 / 更新 / 批量 / 事务 / RowMapper 全场景

许可

• Apache License 2.0