​
背景与引言

在 Java 生态系统中，数据访问层一直是一个充满选择的领域。从最基础的 JDBC 到 JPA/Hibernate，从 MyBatis 到 Spring 的 JdbcTemplate，每种方案都有其特定的应用场景。然而，在实际开发中，我们经常会遇到这样的困境：
  • JPA/Hibernate 虽然功能强大，支持对象关系映射，但在某些场景下显得过于重量级。配置复杂，学习曲线陡峭，而且在处理简单查询时可能会产生过度优化的问题。
  • MyBatis 提供了灵活的 SQL 映射，但需要编写大量的 XML 配置或注解，对于简单的 CRUD 操作来说有些繁琐。
  • JdbcTemplate 作为 Spring 的经典数据访问方案，虽然简单直接，但存在以下问题：
    1. API 设计较为古老，不支持现代 Java 的链式调用
    2. 类型安全性不足，容易出现运行时错误
    3. 参数绑定和结果映射的方式比较笨重
    4. 缺乏与现代异步编程模型的整合
这就是为什么 Spring Framework 6.1 推出了全新的 JDBC Client。它是一个轻量级的、现代化的 JDBC 抽象层，完美平衡了简单性和功能性，特别适合那些需要直接使用 SQL 但又不想牺牲开发体验的场景。这是一个全新的、现代化的 JDBC 抽象层，为开发者提供了一种更简洁、更直观的方式来处理数据库操作。本文将深入探讨这个新特性的各个方面。

​
JDBC Client 的主要特性

​
1. 流畅的 API 设计

JDBC Client 采用了链式调用的方式，使得代码更加直观和易读： 
List<Product> products = jdbcClient
    .sql("SELECT * FROM product WHERE price > :price")
    .param("price", 300000)
    .query(Product.class)
    .list();

​
2. 强大的类型映射

支持自动的类型转换和映射，可以直接将查询结果映射到 Java 对象： 
Optional<Product> product = jdbcClient
    .sql("SELECT * FROM product WHERE id = :id")
    .param("id", 1)
    .query(Product.class)
    .optional();

​
3. 简化的批处理操作

提供了更简单的批处理操作方式： 
int[] updateCounts = jdbcClient
    .sql("INSERT INTO product(model, price) VALUES(:model, :price)")
    .paramSource(products.stream()
        .map(p -> Params.of("model", p.getModel(), "price", p.getPrice())))
    .batch();

​
实际应用示例

​
基本查询操作

// 单个结果查询
Product aitoM7 = jdbcClient
    .sql("SELECT * FROM product WHERE id = :id")
    .param("id", 1)
    .query(Product.class)
    .single();

// 列表查询
List<Product> aitoProducts = jdbcClient
    .sql("SELECT * FROM product WHERE brand = :brand")
    .param("brand", "AITO")
    .query(Product.class)
    .list();

​
更新操作

int updatedRows = jdbcClient
    .sql("UPDATE product SET price = :price WHERE model = :model")
    .param("price", 320000)
    .param("model", "M7")
    .update();

​
与现有代码的集成

JDBC Client 可以与现有的 Spring 应用程序无缝集成。你可以逐步迁移现有的 JdbcTemplate 代码，或者在新功能中使用 JDBC Client。 
@Configuration
public class DatabaseConfig {
    @Bean
    public JdbcClient jdbcClient(DataSource dataSource) {
        return JdbcClient.create(dataSource);
    }
}

​
最佳实践

  1. 使用命名参数而不是位置参数，提高代码可读性
  2. 利用类型安全的查询方法
  3. 适当使用批处理来提高性能
  4. 考虑使用 record 类作为结果映射对象