Java 后端 / 系统课时
使用领域事件解耦业务
使用领域事件解耦业务
本课通过“订单创建后触发风险检查”的最小示例,完成领域事件的定义、发布与处理,并验证同步监听器抛出异常时,业务写入为何会随当前事务一起回滚。
学习目标
- 能用不可变对象定义具有业务含义的领域事件。
- 能通过
ApplicationEventPublisher发布事件,并用@EventListener同步处理。 - 能判断监听器异常对当前事务和调用方的影响。
从直接调用到领域事件
如果订单服务直接调用风险、通知、积分等多个服务,核心用例会不断增加依赖。领域事件把“订单已经创建”表达为事实,订单服务只负责发布事实,后续处理者按需订阅,从而降低模块之间的编译期耦合。
事件名称应使用已经发生的业务事实,例如 OrderPlaced,并携带监听器完成处理所需的最小数据。不要把实体对象直接塞进事件,避免监听器依赖实体的延迟加载状态或可变字段。

可运行示例
项目需包含 spring-boot-starter-jdbc 与 H2。将以下代码保存为 DomainEventDemoApplication.java,启动后会创建临时表并执行一次失败场景。
java
package com.example.eventdemo;
import java.math.BigDecimal;
import org.springframework.boot.CommandLineRunner;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.ApplicationEventPublisher;
import org.springframework.context.annotation.Bean;
import org.springframework.context.event.EventListener;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Component;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@SpringBootApplication
public class DomainEventDemoApplication {
public static void main(String[] args) {
SpringApplication.run(DomainEventDemoApplication.class, args);
}
@Bean
CommandLineRunner demo(JdbcTemplate jdbcTemplate, OrderService orderService) {
return args -> {
jdbcTemplate.execute(
"create table orders(id varchar(32) primary key, amount decimal(10,2))");
jdbcTemplate.execute(
"create table audit_logs(id bigint generated by default as identity, message varchar(100))");
try {
orderService.place("ORD-1001", new BigDecimal("1200.00"));
} catch (RuntimeException ex) {
System.out.println("caught: " + ex.getMessage());
}
Integer orders = jdbcTemplate.queryForObject(
"select count(*) from orders", Integer.class);
Integer logs = jdbcTemplate.queryForObject(
"select count(*) from audit_logs", Integer.class);
System.out.printf("orders=%d, audit_logs=%d%n", orders, logs);
};
}
}
record OrderPlaced(String orderId, BigDecimal amount) {
}
@Service
class OrderService {
private final JdbcTemplate jdbcTemplate;
private final ApplicationEventPublisher eventPublisher;
OrderService(JdbcTemplate jdbcTemplate, ApplicationEventPublisher eventPublisher) {
this.jdbcTemplate = jdbcTemplate;
this.eventPublisher = eventPublisher;
}
@Transactional
public void place(String orderId, BigDecimal amount) {
jdbcTemplate.update(
"insert into orders(id, amount) values (?, ?)", orderId, amount);
// 默认发布方式会在当前线程同步调用监听器。
eventPublisher.publishEvent(new OrderPlaced(orderId, amount));
}
}
@Component
class RiskListener {
private final JdbcTemplate jdbcTemplate;
RiskListener(JdbcTemplate jdbcTemplate) {
this.jdbcTemplate = jdbcTemplate;
}
@EventListener
public void on(OrderPlaced event) {
System.out.println("listener handling " + event.orderId());
jdbcTemplate.update(
"insert into audit_logs(message) values (?)",
"checked " + event.orderId());
// 模拟风险规则失败,异常会返回到发布者。
if (event.amount().compareTo(new BigDecimal("1000.00")) >= 0) {
throw new IllegalStateException("risk check failed");
}
}
}预期输出
text
listener handling ORD-1001
caught: risk check failed
orders=0, audit_logs=0启动日志和时间戳可能不同,但两张表的计数都应为 0,说明监听器写入与订单写入处于同一事务中。
事务边界与设计选择
@EventListener 默认同步执行。监听器没有独立事务时,会参与发布方法已经开启的事务;未捕获的运行时异常会返回发布者,使 @Transactional 方法回滚。调用方因此能立即感知失败,但慢监听器也会延长主流程耗时。
只有必须与主业务同成同败的处理,才适合同步放在当前事务内。通知、搜索索引等允许最终一致的动作,可考虑 @TransactionalEventListener(phase = AFTER_COMMIT);它在提交后执行,失败不能再回滚已提交的订单。使用 @Async 时还会切换线程,原事务不会自动延伸到异步任务中,必须单独设计重试、幂等和失败补偿。
按自己的节奏,确认真正理解。