Java 后端 / 系统课时

搭建事务实验项目

搭建事务实验项目

本课建立一个可重复运行的 Spring Boot 3 事务实验基线:固定 Java、Maven、Spring JDBC 与 H2 依赖,显式配置建表和初始数据脚本,再用集成测试验证数据源、表结构与数据内容,为后续提交、回滚和异常实验提供统一起点。

学习目标

  • 创建可直接构建的 Spring Boot 3 Maven 事务实验项目
  • 配置 H2 与 Spring Boot SQL 初始化机制,固定每次实验的数据起点
  • 用集成测试验证数据源连接、表结构和初始数据是否正确

固定实验基线

本课使用 Spring Boot 3.4.13、Java 17、Maven、Spring JDBC 和 H2。spring-boot-starter-jdbc 提供 JdbcTemplate,并引入 Spring Framework 的 JDBC 与事务基础设施;H2 使用内存数据库,适合反复重置数据并观察事务行为。

建立项目与依赖

项目根目录的 pom.xml 使用 Spring Boot parent 管理依赖版本。下面的 POM 是完整 XML,命名空间和 Schema URL 都保持原始 URL,不混入 Markdown 链接语法。

xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.4.13</version>
        <relativePath/>
    </parent>

    <groupId>com.example</groupId>
    <artifactId>transaction-lab</artifactId>
    <version>0.0.1-SNAPSHOT</version>

    <properties>
        <java.version>17</java.version>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>com.h2database</groupId>
            <artifactId>h2</artifactId>
            <scope>runtime</scope>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

应用入口保持最小,只负责创建 Spring 容器。文件路径为 src/main/java/com/example/transactionlab/TransactionLabApplication.java。

java
package com.example.transactionlab;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class TransactionLabApplication {

    public static void main(String[] args) {
        SpringApplication.run(TransactionLabApplication.class, args);
    }
}

配置并初始化数据库

在 src/main/resources/application.yml 中显式声明数据源与 SQL 初始化脚本位置。即使 H2 属于嵌入式数据库,也把 mode 写为 always,让初始化行为不依赖默认推断。

yaml
spring:
  datasource:
    url: "jdbc:h2:mem:transactionlab;DB_CLOSE_DELAY=-1"
    username: sa
    password: ""
    driver-class-name: org.h2.Driver
  sql:
    init:
      mode: always
      schema-locations: classpath:schema.sql
      data-locations: classpath:data.sql

src/main/resources/schema.sql 负责建立实验表。先删除同名表,可保证新的应用上下文执行初始化时回到一致结构。

sql
DROP TABLE IF EXISTS account;

CREATE TABLE account (
    id BIGINT PRIMARY KEY,
    owner VARCHAR(64) NOT NULL,
    balance DECIMAL(12, 2) NOT NULL
);

src/main/resources/data.sql 固定两条账户数据,后续课时可以直接围绕它们做转账、回滚和异常注入。

sql
INSERT INTO account(id, owner, balance) VALUES (1, 'Alice', 1000.00);
INSERT INTO account(id, owner, balance) VALUES (2, 'Bob', 500.00);

Spring Boot 启动应用上下文时会先执行 schema.sql,再执行 data.sql。是否初始化成功应通过实际查询验证,而不是只看启动日志是否报错。

用集成测试验证基线

在 src/test/java/com/example/transactionlab/TransactionLabApplicationTests.java 中加入集成测试。测试直接查询 account,同时验证数据源连接、表是否存在、记录数以及关键初始余额。

java
package com.example.transactionlab;

import java.math.BigDecimal;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.jdbc.core.JdbcTemplate;

import static org.junit.jupiter.api.Assertions.assertEquals;

@SpringBootTest
class TransactionLabApplicationTests {

    @Autowired
    private JdbcTemplate jdbcTemplate;

    @Test
    void shouldInitializeAccountTable() {
        Integer count = jdbcTemplate.queryForObject(
                "SELECT COUNT(*) FROM account",
                Integer.class
        );
        BigDecimal aliceBalance = jdbcTemplate.queryForObject(
                "SELECT balance FROM account WHERE id = 1",
                BigDecimal.class
        );
        BigDecimal bobBalance = jdbcTemplate.queryForObject(
                "SELECT balance FROM account WHERE id = 2",
                BigDecimal.class
        );

        assertEquals(2, count);
        assertEquals(0, aliceBalance.compareTo(new BigDecimal("1000.00")));
        assertEquals(0, bobBalance.compareTo(new BigDecimal("500.00")));
    }
}

在项目根目录执行测试。

bash
mvn test

预期结果

text
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

实际日志会包含更多 Spring Boot、HikariCP 和 Maven 输出,内容与机器环境有关;判断标准是测试通过且构建成功。到这里,依赖、数据源、建表脚本、初始化数据和验证查询已经形成一条可重复执行的基线,后续课时只需在此项目上增加 @Transactional、业务服务和故障注入代码。

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

目录与阅读设置

记录一个想法

搭建事务实验项目

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

登录哪都通