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 时还会切换线程,原事务不会自动延伸到异步任务中,必须单独设计重试、幂等和失败补偿。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用领域事件解耦业务

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

登录哪都通