Java 后端 / 系统课时

使用应用事件解耦模块

使用应用事件解耦模块

当订单模块完成业务操作后,库存、通知和审计模块往往都要响应。直接互相调用会扩大依赖范围。本课使用 ApplicationEventPublisher 发布领域事实,通过监听器完成模块内解耦,并辨析同步、异步与事务监听的执行边界。

学习目标

  • 定义并发布不可变的应用事件
  • 使用 @EventListener 订阅事件并验证执行顺序
  • 判断同步、异步和事务监听器的适用场景

为什么使用应用事件

应用事件适合表达“某件事已经发生”,例如“订单已创建”,而不是向另一个模块下达“扣减库存”这样的命令。发布者只依赖事件类型,不需要知道有多少监听器,也不需要持有监听器对象。

事件通常设计为不可变数据,只携带监听器完成工作所需的最小信息。不要直接放入可变实体或懒加载对象,否则监听器可能读取到被后续代码修改的状态。

发布与监听的执行链路

ApplicationEventPublisher 发布与监听执行链路

Spring 默认通过应用上下文中的事件多播器分发事件,普通监听器在发布线程中同步执行。因此,监听器抛出的运行时异常会影响发布调用,慢监听器也会拉长原业务方法的耗时。异步与否不是事件对象的属性,而由监听器或多播器的执行策略决定。

完成一个可运行示例

下面的类可直接放入已有的 Spring Boot 3 项目。事件机制来自 Spring Context,不需要额外引入消息中间件。

java
package com.example.eventdemo;

import java.time.Instant;

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;

@SpringBootApplication
public class EventDemoApplication {

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

    @Bean
    OrderService orderService(ApplicationEventPublisher publisher) {
        return new OrderService(publisher);
    }

    @Bean
    OrderEventListener orderEventListener() {
        return new OrderEventListener();
    }

    @Bean
    CommandLineRunner demo(OrderService orderService) {
        return args -> {
            System.out.println("1. 准备提交订单");
            orderService.placeOrder("A100");
            System.out.println("4. publishEvent 已返回");
        };
    }

    public record OrderCreatedEvent(String orderNo, Instant occurredAt) {
    }

    static final class OrderService {
        private final ApplicationEventPublisher publisher;

        OrderService(ApplicationEventPublisher publisher) {
            this.publisher = publisher;
        }

        void placeOrder(String orderNo) {
            System.out.println("2. 订单已保存:" + orderNo);
            publisher.publishEvent(new OrderCreatedEvent(orderNo, Instant.now()));
        }
    }

    static final class OrderEventListener {

        @EventListener
        void reserveInventory(OrderCreatedEvent event) {
            System.out.println("3. 库存模块收到事件:" + event.orderNo());
        }
    }
}

预期输出

text
1. 准备提交订单
2. 订单已保存:A100
3. 库存模块收到事件:A100
4. publishEvent 已返回

第 3 行出现在第 4 行之前,证明默认监听器在 publishEvent 返回前已经执行完毕。

选择异步或事务监听

当监听逻辑耗时较长且不要求调用方等待时,可以启用异步支持,并在特定监听器上添加 @Async。下面是片段示例,依赖 Spring 的异步方法执行能力。

java
@Configuration
@EnableAsync
class AsyncEventConfig {
}

@Component
class NotificationListener {

    @Async
    @EventListener
    public void sendNotification(EventDemoApplication.OrderCreatedEvent event) {
        // 在任务执行器线程中处理,异常不会直接抛回发布者
    }
}

异步监听器不能依赖发布线程中的 ThreadLocal、日志上下文或未提交事务。若监听动作必须在数据库事务成功提交后执行,应使用 @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT);若事务回滚,提交后监听器不会被调用。

明确使用边界

应用事件解决的是单个 Spring 应用内部的模块协作,不提供消息持久化、跨进程投递、消费确认或失败重放。监听器执行失败需要由应用自行设计异常处理与补偿。

当业务要求服务间通信、削峰、重试或可追溯消费时,应改用 Kafka 等消息中间件,而不是把应用事件当作可靠消息队列。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用应用事件解耦模块

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

登录哪都通