Java 后端 / 系统课时
配置数据源与事务管理器
配置数据源与事务管理器
本课解决两个容易混淆的问题:DataSource 决定数据库连接从哪里获得,事务管理器负责事务如何开始、提交和回滚。通过一个 JDBC 主示例,你将配置 JdbcTransactionManager,并用正常提交与异常回滚验证它确实管理了业务使用的数据源。
学习目标
- 解释
DataSource与事务管理器的职责边界 - 根据 JDBC 或 JPA 数据访问方式选择合适的事务管理器
- 配置并验证 JDBC 事务的提交与回滚
先分清两个角色
DataSource 是数据库连接的来源,Spring JDBC 通过它获得 Connection。数据库地址、账号、连接池大小等属于数据源职责,但 DataSource 本身并不决定业务方法何时提交或回滚。
事务管理器位于业务事务边界与底层资源之间。对于单个 JDBC DataSource,JdbcTransactionManager 会让同一事务中的 Spring JDBC 操作共享绑定到当前线程的连接,并负责提交、回滚以及事务完成阶段的 JDBC 异常转换。
| 数据访问方式 | 主要事务资源 | 常用事务管理器 |
|---|---|---|
Spring JDBC / JdbcTemplate |
JDBC Connection |
JdbcTransactionManager |
Spring Data JPA / EntityManager |
JPA EntityManager |
JpaTransactionManager |
| 多个需要原子协调的事务资源 | 多资源事务 | JTA 事务管理器 |
选择事务管理器时应看真正参与事务的资源。只使用 JDBC 的项目没有必要为了事务管理额外引入 JPA。
配置 JDBC 事务管理器
下面的项目内配置片段假设 Spring Boot 已经创建可用的 DataSource,并且 H2 中存在 account 表。这里显式声明事务管理器,让它明确绑定到业务实际使用的数据源。注意配置类本身必须被 Spring 注册,不能只有孤立的 @Bean 方法。
package com.example.transactionlab.config;
import javax.sql.DataSource;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jdbc.support.JdbcTransactionManager;
import org.springframework.transaction.PlatformTransactionManager;
@Configuration(proxyBeanMethods = false)
public class TransactionConfig {
@Bean
public PlatformTransactionManager transactionManager(DataSource dataSource) {
// 事务管理器必须绑定业务实际使用的 DataSource。
return new JdbcTransactionManager(dataSource);
}
}这段配置不会单独产生控制台输出。应用能够成功创建 transactionManager Bean,并且后面的 @Transactional JDBC 方法能够进入事务上下文,即说明绑定关系已经生效。
用一次主示例验证提交与回滚
验证代码由业务服务和启动检查器两部分组成,它们依赖同一个 Spring Boot 应用上下文,不作为单文件独立运行。deposit 正常返回时事务提交;depositThenFail 更新后抛出运行时异常,按照 Spring 默认回滚规则撤销本次事务中的修改。
package com.example.transactionlab.service;
import java.math.BigDecimal;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@Service
public class AccountService {
private final JdbcTemplate jdbcTemplate;
public AccountService(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
@Transactional
public void deposit(long id, BigDecimal amount) {
jdbcTemplate.update(
"UPDATE account SET balance = balance + ? WHERE id = ?",
amount, id);
}
@Transactional
public void depositThenFail(long id, BigDecimal amount) {
jdbcTemplate.update(
"UPDATE account SET balance = balance + ? WHERE id = ?",
amount, id);
// 未捕获的 RuntimeException 默认使当前事务回滚。
throw new IllegalStateException("simulate failure");
}
}启动检查器也必须作为配置类注册,否则其中的 @Bean CommandLineRunner 不会被 Spring 创建,更不会执行验证逻辑。
package com.example.transactionlab.config;
import java.math.BigDecimal;
import com.example.transactionlab.service.AccountService;
import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jdbc.core.JdbcTemplate;
@Configuration(proxyBeanMethods = false)
public class VerifyRunnerConfig {
@Bean
CommandLineRunner verify(JdbcTemplate jdbcTemplate, AccountService accountService) {
return args -> {
accountService.deposit(1L, new BigDecimal("100.00"));
System.out.println("after commit=" + balanceOf(jdbcTemplate, 1L));
try {
accountService.depositThenFail(1L, new BigDecimal("50.00"));
} catch (IllegalStateException ignored) {
System.out.println("transaction rolled back");
}
System.out.println("after rollback=" + balanceOf(jdbcTemplate, 1L));
};
}
private BigDecimal balanceOf(JdbcTemplate jdbcTemplate, long id) {
return jdbcTemplate.queryForObject(
"SELECT balance FROM account WHERE id = ?",
BigDecimal.class,
id);
}
}假设 id = 1 的初始余额为 1000.00,启动应用后的预期输出如下;实际控制台还会包含 Spring Boot 自身的启动日志。
after commit=1100.00
transaction rolled back
after rollback=1100.00第一次更新后的 1100.00 证明事务正常提交。第二次虽然执行了加款 SQL,但异常使该事务回滚,因此最终余额仍为 1100.00。这同时验证了 DataSource、JdbcTransactionManager、JdbcTemplate 与 @Transactional 使用的是同一套事务资源。
什么时候改用 JpaTransactionManager
当数据访问层主要通过 EntityManager 或 Spring Data JPA Repository 持久化实体时,事务的核心资源变成 JPA EntityManager,通常应改用 JpaTransactionManager。下面是 JPA 项目中的配置片段,不应与前面的 JDBC transactionManager 同名配置直接同时放入本实验项目。
package com.example.transactionlab.config;
import jakarta.persistence.EntityManagerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.orm.jpa.JpaTransactionManager;
import org.springframework.transaction.PlatformTransactionManager;
@Configuration(proxyBeanMethods = false)
public class JpaTransactionConfig {
@Bean
public PlatformTransactionManager transactionManager(
EntityManagerFactory entityManagerFactory) {
return new JpaTransactionManager(entityManagerFactory);
}
}这段 JPA 配置的生效行为是让声明式事务围绕 EntityManager 建立事务边界,可通过 JPA Repository 或 EntityManager 的持久化操作验证提交和回滚。对于本课的单数据源 JDBC 场景,保留 JdbcTransactionManager 即可;只有切换持久化技术时,才需要让事务管理器随实际事务资源一起调整。