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 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。
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,让初始化行为不依赖默认推断。
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.sqlsrc/main/resources/schema.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 固定两条账户数据,后续课时可以直接围绕它们做转账、回滚和异常注入。
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,同时验证数据源连接、表是否存在、记录数以及关键初始余额。
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")));
}
}在项目根目录执行测试。
mvn test预期结果
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS实际日志会包含更多 Spring Boot、HikariCP 和 Maven 输出,内容与机器环境有关;判断标准是测试通过且构建成功。到这里,依赖、数据源、建表脚本、初始化数据和验证查询已经形成一条可重复执行的基线,后续课时只需在此项目上增加 @Transactional、业务服务和故障注入代码。