Spring Boot 事件机制详解：原理与示例

说明：

• 继承 ApplicationEvent
• 用于描述'用户已注册'这一事实
• 可携带任意业务数据

2. 发布事件（Publisher）

import org.springframework.context.ApplicationEventPublisher;
import org.springframework.stereotype.Service;

@Service
public class UserService {
    private final ApplicationEventPublisher publisher;

    public UserService(ApplicationEventPublisher publisher) {
        this.publisher = publisher;
    }

    public void register(String username) {
        System.out.println("✅ 用户注册成功：" + username);
        // 发布事件
        publisher.publishEvent(new UserRegisteredEvent(this, username));
    }
}

关键点：

• ApplicationEventPublisher 由 Spring 自动注入
• publishEvent() 只负责'发通知'
• 不关心谁来处理事件

3. 监听事件（Listener）

import org.springframework.context.ApplicationListener;
import org.springframework.stereotype.Component;

@Component
public class UserRegisteredListener implements ApplicationListener<UserRegisteredEvent> {
    @Override
    public void onApplicationEvent(UserRegisteredEvent event) {
        System.out.println("📩 监听到用户注册事件，发送欢迎消息：" + event.getUsername());
    }
}

核心代码是这一行：

implements ApplicationListener<UserRegisteredEvent>

含义是：

当 UserRegisteredEvent 被发布时，该监听器会自动执行

4. 启动时触发 Demo

import org.springframework.boot.CommandLineRunner;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class DemoRunner {
    @Bean
    CommandLineRunner run(UserService userService) {
        return args -> userService.register("alice");
    }
}

5. 启动类

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

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

四、运行结果

启动项目后，控制台输出如下：

说明：

• 事件成功发布
• 监听器被自动触发
• 业务逻辑成功解耦

五、事件机制的优点总结

1. 解耦业务逻辑

• 发布者无需知道监听者
• 新功能只需新增 Listener

2. 易扩展（企业非常常见）

@Component
public class LogListener implements ApplicationListener<UserRegisteredEvent> {}

@Component
public class PointListener implements ApplicationListener<UserRegisteredEvent> {}

👉 不修改注册逻辑即可扩展功能

3. 符合单一职责原则

• 一个类只做一件事
• 代码清晰、可维护性高

六、常见进阶用法

1. 使用 @EventListener（更简洁）

@EventListener
public void handle(UserRegisteredEvent event) {
    System.out.println(event.getUsername());
}

2. 异步事件（避免阻塞主流程）

@Async
@EventListener
public void handle(UserRegisteredEvent event) {}

并在启动类或配置类中开启异步：

@EnableAsync

七、什么时候适合用事件机制？

✅ 适合场景

• 用户注册 / 下单 / 支付完成
• 文件上传完成 / 处理完成
• 状态变更通知
• 多模块后置处理逻辑

❌ 不适合场景

• 强依赖返回结果的同步流程
• 强一致性事务场景（需谨慎）

八、总结

Spring 事件机制，本质上是一种轻量级的'服务内事件驱动架构'。

它非常适合用于：

• 单体应用
• 同一个 Spring Boot 应用的多模块
• 业务后处理解耦