编辑“︁Spring JDBC简介”︁

= Spring JDBC简介 =

Spring JDBC 是 [[Spring Framework]] 提供的一个简化 [[JDBC]]（Java Database Connectivity）操作的核心模块，它通过封装底层的 JDBC API，减少了开发者编写大量重复代码的需求，同时提供了更优雅的异常处理和资源管理机制。本节将详细介绍 Spring JDBC 的核心组件、工作原理以及实际应用。

== 概述 ==

JDBC 是 Java 标准库中用于与关系型数据库交互的 API，但直接使用 JDBC 需要处理大量的样板代码（如连接管理、异常处理、资源释放等）。Spring JDBC 通过以下方式简化了这一过程：

* 提供模板类（如 `JdbcTemplate`）封装常见操作。
* 统一异常体系，将 JDBC 的受检异常转换为运行时异常。
* 支持声明式事务管理。
* 提供便捷的 DAO（Data Access Object）支持。

Spring JDBC 的核心思想是**"Don't Repeat Yourself" (DRY)**，通过抽象通用模式让开发者专注于业务逻辑。

== 核心组件 ==

Spring JDBC 的主要组件包括：

1. '''JdbcTemplate'''：核心类，提供执行 SQL 语句、处理结果集的方法。
2. '''NamedParameterJdbcTemplate'''：支持命名参数的扩展模板。
3. '''SimpleJdbcInsert'''：简化 INSERT 操作的辅助类。
4. '''DataSource'''：数据库连接池的抽象（如 HikariCP、Tomcat JDBC Pool）。

<mermaid>
classDiagram
    class JdbcTemplate {
        +queryForObject(String sql, RowMapper<T> rowMapper, Object... args) T
        +update(String sql, Object... args) int
    }
    class NamedParameterJdbcTemplate {
        +queryForMap(String sql, Map<String,?> paramMap) Map<String,Object>
    }
    class DataSource {
        +getConnection() Connection
    }
    JdbcTemplate --> DataSource
    NamedParameterJdbcTemplate --> JdbcTemplate
</mermaid>

== 基础用法示例 ==

以下示例展示如何使用 `JdbcTemplate` 执行基本操作：

=== 1. 配置数据源 ===
<syntaxhighlight lang="java">
@Configuration
public class AppConfig {
    @Bean
    public DataSource dataSource() {
        return new HikariDataSource(); // 实际使用需配置URL、用户名等
    }
    
    @Bean
    public JdbcTemplate jdbcTemplate(DataSource dataSource) {
        return new JdbcTemplate(dataSource);
    }
}
</syntaxhighlight>

=== 2. 执行查询 ===
<syntaxhighlight lang="java">
public class UserDao {
    private final JdbcTemplate jdbcTemplate;
    
    public UserDao(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }
    
    public String getUserNameById(long id) {
        return jdbcTemplate.queryForObject(
            "SELECT name FROM users WHERE id = ?", 
            String.class, 
            id
        );
    }
}
</syntaxhighlight>

=== 3. 处理结果集 ===
<syntaxhighlight lang="java">
public List<User> getAllUsers() {
    return jdbcTemplate.query(
        "SELECT id, name, email FROM users",
        (rs, rowNum) -> new User(
            rs.getLong("id"),
            rs.getString("name"),
            rs.getString("email")
        )
    );
}
</syntaxhighlight>

== 高级特性 ==

=== 命名参数 ===
使用 `NamedParameterJdbcTemplate` 替代位置参数：
<syntaxhighlight lang="java">
Map<String, Object> params = new HashMap<>();
params.put("userId", 1001);
params.put("status", "ACTIVE");

jdbcTemplate.query(
    "SELECT * FROM orders WHERE user_id = :userId AND status = :status",
    params,
    new OrderRowMapper()
);
</syntaxhighlight>

=== 批量操作 ===
<syntaxhighlight lang="java">
jdbcTemplate.batchUpdate(
    "INSERT INTO products (name, price) VALUES (?, ?)",
    List.of(
        new Object[]{"Laptop", 999.99},
        new Object[]{"Phone", 699.99}
    )
);
</syntaxhighlight>

== 异常处理 ==

Spring JDBC 将 JDBC 的 `SQLException` 转换为 `DataAccessException` 层次结构中的运行时异常。常见子类包括：
* `DuplicateKeyException` - 主键冲突
* `DataIntegrityViolationException` - 数据完整性违反
* `BadSqlGrammarException` - SQL语法错误

处理示例：
<syntaxhighlight lang="java">
try {
    userDao.insert(user);
} catch (DuplicateKeyException e) {
    logger.error("User already exists: " + user.getEmail());
}
</syntaxhighlight>

== 性能优化 ==

1. '''重用 JdbcTemplate'''：线程安全，应作为单例使用
2. '''使用批处理'''：对大量数据操作时效率显著提升
3. '''合理配置连接池'''：如设置合适的 `maxPoolSize`
4. '''启用缓存'''：对频繁查询的结果使用 Spring Cache

== 实际案例 ==

假设开发电商平台的订单管理系统：

<syntaxhighlight lang="java">
@Repository
public class OrderRepository {
    private final NamedParameterJdbcTemplate jdbcTemplate;
    
    public Order save(Order order) {
        var params = new HashMap<String, Object>();
        params.put("orderId", order.getId());
        params.put("userId", order.getUserId());
        params.put("totalAmount", order.getTotalAmount());
        
        jdbcTemplate.update("""
            INSERT INTO orders (id, user_id, total_amount, status)
            VALUES (:orderId, :userId, :totalAmount, 'CREATED')
            """, params);
            
        return order;
    }
    
    public List<Order> findByUserId(long userId) {
        return jdbcTemplate.query(
            "SELECT * FROM orders WHERE user_id = :userId",
            Map.of("userId", userId),
            new OrderRowMapper()
        );
    }
}
</syntaxhighlight>

== 数学表示 ==

Spring JDBC 的更新操作可以表示为：

<math>
\text{UpdateCount} = JdbcTemplate.update(sql, args_1, args_2, ..., args_n)
</math>

其中：
* <math>sql</math> 是参数化 SQL 语句
* <math>args_i</math> 是绑定参数
* 返回值表示受影响的行数

== 总结 ==

Spring JDBC 通过模板模式和合理的抽象，显著简化了传统 JDBC 编程的复杂度。关键优势包括：
* 减少 60%-70% 的样板代码
* 一致的异常处理机制
* 与 Spring 事务管理无缝集成
* 保持对底层 JDBC 的完全控制

对于需要更高抽象级别的场景，可以考虑 [[Spring Data JPA]]，但 Spring JDBC 仍然是需要精细控制 SQL 时的最佳选择。

[[Category:后端框架]]
[[Category:Spring]]
[[Category:Spring数据访问]]