plusone/simple-jdbc
1
0
Fork 1
Code Issues Pull Requests Packages Projects Releases 4 Wiki Activity

4 Releases 4 Tags

RSS Feed
  • 1.0.0-RC1 8dc762152c
    Compare

    1.0.0-RC1 Pre-Release

    zhouxy108 released this 2026-05-29 00:58:34 +08:00 | 40 commits to dev since this release

    项目首个正式发布的候选版本。

    新增

    核心框架

    • 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
    Downloads