JDBC Template如何使用

发布时间：2021-12-22 12:01:32 作者：iii
来源：亿速云阅读：200

# JDBC Template如何使用

## 目录
1. [JDBC Template概述](#jdbc-template概述)
2. [环境准备与基础配置](#环境准备与基础配置)
3. [核心API详解](#核心api详解)
4. [CRUD操作实践](#crud操作实践)
5. [批量操作与事务管理](#批量操作与事务管理)
6. [高级特性与最佳实践](#高级特性与最佳实践)
7. [性能优化与常见问题](#性能优化与常见问题)
8. [整合Spring Boot实战](#整合spring-boot实战)
9. [总结与扩展阅读](#总结与扩展阅读)

---

## JDBC Template概述
（约1200字）

### 什么是JDBC Template
JDBC Template是Spring框架对JDBC API的高层封装，解决了原生JDBC的以下痛点：
- 繁琐的资源管理（Connection/Statement/ResultSet）
- 重复的异常处理逻辑
- 样板代码过多的问题

### 核心优势
1. **资源自动管理**：自动释放数据库连接
2. **异常体系转换**：将SQLException转换为DataAccessException体系
3. **简化开发**：减少约70%的样板代码
4. **灵活扩展**：支持自定义RowMapper等组件

### 架构原理
```java
// 典型执行流程
1. 获取数据源 → 2. 创建JdbcTemplate → 3. 执行SQL → 4. 处理结果 → 5. 释放资源

环境准备与基础配置

（约1500字）

Maven依赖

<dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-jdbc</artifactId>
    <version>5.3.18</version>
</dependency>
<!-- 根据实际需要添加数据库驱动 -->

数据源配置

// 基于Java Config的配置
@Bean
public DataSource dataSource() {
    DriverManagerDataSource ds = new DriverManagerDataSource();
    ds.setDriverClassName("com.mysql.cj.jdbc.Driver");
    ds.setUrl("jdbc:mysql://localhost:3306/test");
    ds.setUsername("root");
    ds.setPassword("123456");
    return ds;
}

@Bean 
public JdbcTemplate jdbcTemplate(DataSource dataSource) {
    return new JdbcTemplate(dataSource);
}

异常处理机制

Spring将SQL异常转换为： - DataAccessException（根异常） - BadSqlGrammarException（SQL语法错误） - DataIntegrityViolationException（数据完整性违反）

核心API详解

（约2000字）

主要方法分类

方法类型	代表方法
查询方法	query(), queryForObject()
更新方法	update(), batchUpdate()
存储过程调用	call()
通用执行	execute()

RowMapper深度解析

public class UserRowMapper implements RowMapper<User> {
    @Override
    public User mapRow(ResultSet rs, int rowNum) throws SQLException {
        User user = new User();
        user.setId(rs.getLong("id"));
        user.setName(rs.getString("name"));
        return user;
    }
}

// 使用示例
jdbcTemplate.query("SELECT * FROM users", new UserRowMapper());

ResultSetExtractor vs RowCallbackHandler

对比两种结果处理方式： 1. ResultSetExtractor：集中处理整个ResultSet 2. RowCallbackHandler：逐行处理

CRUD操作实践

（约2500字）

完整示例：用户管理模块

public class UserDaoImpl implements UserDao {
    
    private final JdbcTemplate jdbcTemplate;
    
    // 构造器注入
    public UserDaoImpl(JdbcTemplate jdbcTemplate) {
        this.jdbcTemplate = jdbcTemplate;
    }
    
    @Override
    public User findById(Long id) {
        String sql = "SELECT * FROM users WHERE id = ?";
        return jdbcTemplate.queryForObject(sql, new UserRowMapper(), id);
    }
    
    @Override
    public int insert(User user) {
        String sql = "INSERT INTO users(name,email) VALUES(?,?)";
        return jdbcTemplate.update(sql, 
            user.getName(), user.getEmail());
    }
    
    // 其他方法实现...
}

复杂查询示例

// 分页查询
public List<User> findUsersByPage(int pageNum, int pageSize) {
    String sql = "SELECT * FROM users LIMIT ? OFFSET ?";
    return jdbcTemplate.query(sql, 
        new UserRowMapper(), 
        pageSize, 
        (pageNum-1)*pageSize);
}

批量操作与事务管理

（约1800字）

批量更新

public int[] batchInsert(List<User> users) {
    return jdbcTemplate.batchUpdate(
        "INSERT INTO users(name,email) VALUES(?,?)",
        new BatchPreparedStatementSetter() {
            @Override
            public void setValues(PreparedStatement ps, int i) throws SQLException {
                ps.setString(1, users.get(i).getName());
                ps.setString(2, users.get(i).getEmail());
            }
            
            @Override
            public int getBatchSize() {
                return users.size();
            }
        });
}

事务配置

@Transactional
public void transferMoney(Long fromId, Long toId, BigDecimal amount) {
    // 扣款
    jdbcTemplate.update("UPDATE accounts SET balance = balance - ? WHERE id = ?", 
        amount, fromId);
    
    // 存款
    jdbcTemplate.update("UPDATE accounts SET balance = balance + ? WHERE id = ?", 
        amount, toId);
}

高级特性与最佳实践

（约1500字）

命名参数支持

NamedParameterJdbcTemplate template = new NamedParameterJdbcTemplate(dataSource);

Map<String, Object> params = new HashMap<>();
params.put("status", "ACTIVE");
params.put("createDate", LocalDate.now());

template.query(
    "SELECT * FROM users WHERE status = :status AND created_at > :createDate", 
    params, 
    new UserRowMapper());

与JPA混合使用策略

使用JPA处理复杂对象关系
使用JDBC Template处理：
- 批量操作
- 报表查询
- 存储过程调用

性能优化与常见问题

（约1200字）

调优建议

合理设置fetchSize
使用批处理代替单条操作
启用预编译语句缓存

jdbcTemplate.setFetchSize(100);
jdbcTemplate.setCachePreparedStatements(true);

常见错误排查

空结果集异常：使用queryForObject时处理EmptyResultDataAccessException
类型不匹配：确保SQL类型与Java类型对应
资源泄漏：避免在RowMapper中保留ResultSet引用

整合Spring Boot实战

（约1000字）

自动配置原理

Spring Boot自动配置： 1. 自动创建DataSource 2. 配置JdbcTemplate 3. 支持HikariCP连接池

典型配置

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/demo
    username: root
    password: 123456
    hikari:
      maximum-pool-size: 20

总结与扩展阅读

（约800字）

技术选型对比

技术	适用场景
原生JDBC	需要极致控制
JDBC Template	常规数据库操作
MyBatis	复杂SQL管理
JPA	对象关系映射场景