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 方法。

java
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 默认回滚规则撤销本次事务中的修改。

java
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 创建,更不会执行验证逻辑。

java
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 自身的启动日志。

text
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 同名配置直接同时放入本实验项目。

java
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 即可;只有切换持久化技术时,才需要让事务管理器随实际事务资源一起调整。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

配置数据源与事务管理器

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通