Spring Framework核心JDBC操作指南：JdbcTemplate与NamedParameterJdbcTemplate详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01081/article/details/148324085

Spring Framework核心JDBC操作指南：JdbcTemplate与NamedParameterJdbcTemplate详解

spring-framework 项目地址: https://gitcode.com/gh_mirrors/spr/spring-framework

一、JDBC核心类概述

Spring Framework的JDBC模块提供了一套强大的抽象层，极大地简化了传统JDBC开发中的样板代码。核心类JdbcTemplate和NamedParameterJdbcTemplate是Spring JDBC的核心，它们封装了资源管理、异常处理等底层细节，让开发者能专注于SQL逻辑。

二、JdbcTemplate深度解析

2.1 核心功能特性

JdbcTemplate是JDBC核心包中的中心类，具有以下核心能力：

自动化资源管理：自动处理Connection、Statement和ResultSet的创建与释放
异常转换机制：将JDBC的SQLException转换为Spring的DataAccessException体系
简化操作流程：封装了查询、更新等常见操作，减少样板代码
灵活的扩展点：通过回调接口支持自定义处理逻辑

2.2 基础查询操作

简单标量查询

// 查询记录数
int rowCount = jdbcTemplate.queryForObject(
    "SELECT COUNT(*) FROM t_actor", Integer.class);

// 带参数的查询
int count = jdbcTemplate.queryForObject(
    "SELECT COUNT(*) FROM t_actor WHERE first_name = ?", 
    Integer.class, "Joe");

对象映射查询

// 查询单个对象
Actor actor = jdbcTemplate.queryForObject(
    "SELECT first_name, last_name FROM t_actor WHERE id = ?",
    (rs, rowNum) -> new Actor(
        rs.getString("first_name"),
        rs.getString("last_name")),
    1212L);

// 查询对象列表
List<Actor> actors = jdbcTemplate.query(
    "SELECT first_name, last_name FROM t_actor",
    (rs, rowNum) -> new Actor(
        rs.getString("first_name"),
        rs.getString("last_name")));

最佳实践：建议将RowMapper提取为类成员或独立类，避免重复代码。

2.3 数据更新操作

// 插入数据
jdbcTemplate.update(
    "INSERT INTO t_actor (first_name, last_name) VALUES (?, ?)",
    "Leonor", "Watling");

// 更新数据
jdbcTemplate.update(
    "UPDATE t_actor SET last_name = ? WHERE id = ?",
    "Banjo", 5276L);

// 删除数据
jdbcTemplate.update(
    "DELETE FROM t_actor WHERE id = ?",
    actorId);

2.4 其他操作

// 执行DDL语句
jdbcTemplate.execute("CREATE TABLE mytable (id INTEGER, name VARCHAR(100))");

// 调用存储过程
jdbcTemplate.update("CALL SUPPORT.REFRESH_ACTORS_SUMMARY(?)", unionId);

三、NamedParameterJdbcTemplate详解

3.1 命名参数的优势

相比传统的?占位符，命名参数提供了：

更好的可读性
更易于维护的SQL语句
支持重复使用参数

3.2 基本使用方式

// 使用MapSqlParameterSource
String sql = "SELECT COUNT(*) FROM t_actor WHERE first_name = :first_name";
SqlParameterSource params = new MapSqlParameterSource("first_name", firstName);
int count = namedParameterJdbcTemplate.queryForObject(sql, params, Integer.class);

// 使用Map
Map<String, String> params = Collections.singletonMap("first_name", firstName);
int count = namedParameterJdbcTemplate.queryForObject(sql, params, Integer.class);

3.3 高级参数绑定

Spring提供了BeanPropertySqlParameterSource，可以直接绑定JavaBean属性：

Actor actor = new Actor();
actor.setFirstName("John");
actor.setLastName("Doe");

SqlParameterSource params = new BeanPropertySqlParameterSource(actor);
namedParameterJdbcTemplate.update(
    "INSERT INTO t_actor (first_name, last_name) VALUES (:firstName, :lastName)",
    params);

四、最佳实践指南

线程安全：JdbcTemplate实例是线程安全的，建议配置为单例
依赖注入：通过Spring容器管理DataSource和Template实例
异常处理：利用Spring的异常体系处理数据访问异常
资源管理：无需手动关闭资源，由Template自动处理
日志记录：所有SQL操作都会在DEBUG级别记录日志

五、配置建议

5.1 XML配置方式

<bean id="dataSource" class="...DataSource"/>

<bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
    <property name="dataSource" ref="dataSource"/>
</bean>

<bean id="namedJdbcTemplate" class="org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate">
    <constructor-arg ref="dataSource"/>
</bean>

5.2 注解配置方式

@Repository
public class ActorRepository {
    private final JdbcTemplate jdbcTemplate;
    
    @Autowired
    public ActorRepository(DataSource dataSource) {
        this.jdbcTemplate = new JdbcTemplate(dataSource);
    }
    // ...DAO方法
}