Spring监听器不同的注册方式下带来的监听范围的变化

news2025/11/5 0:25:08

事件监听注册的几种方式

ApplicationContext下面简称AC

1.构建SpringApplication时注册（可以监听AC启动阶段事件）

// 方式一:
//写法1
SpringApplication application = new SpringApplicationBuilder().listeners(new ApplicationPidFileWriter()).build(args);
//写法2
SpringApplication springApplication = new SpringApplication();
        application.addListeners(new ApplicationPidFileWriter());

2.在META-INF/spring.factories中注册（可以监听AC启动阶段事件）

org.springframework.context.ApplicationListener=org.springframework.boot.context.ApplicationPidFileWriter

3.bean扫描（部分AC启动阶段事件无法监听）

@Component
public class ApplicationAvailabilityExporter {

    @EventListener
    public void onStateChange(AvailabilityChangeEvent event) {
        AvailabilityState state = event.getState();
        if (state.equals(ReadinessState.ACCEPTING_TRAFFIC)) {
            System.out.println("应用程序已经可以接受外部请求");
        } else if (state.equals(ReadinessState.REFUSING_TRAFFIC)) {
            System.out.println("应用程序拒绝接受外部请求");
        } else if (state.equals(LivenessState.BROKEN)) {
            System.out.println("应用程序不可用");
        } else if (state.equals(LivenessState.CORRECT)) {
            System.out.println("应用程序正常");
        }
    }
}

监听时机问题

springboot里面有部分事件是在ApplicationContext创建之前发布的。所以这就有有了上面的前两种注册方式，第三种注册方式，是我们最常见，也是业务中最常用的一种方式。

比如:

ApplicationStartingEvent 在SpringApplication的run方法内，它发布的时间会很早，在SpringApplicationRunListeners里面就包含着通过方法一和方法二注册的监听器，但是这个时候不包含第三种。
在这里插入图片描述

监听器注册演示

@SpringBootApplication
public class Study03Application {

    public static void main(String[] args) {
        try {
            SpringApplication application = new SpringApplicationBuilder(Study03Application.class)
                    .bannerMode(Banner.Mode.OFF)
                    // 指定web应用程序类型，SERVLET,REACTIVE,NONE
                    // NONE  就是表示不对外提供web服务
                    .web(WebApplicationType.SERVLET)
                    .allowCircularReferences(true) // 是否允许循环引用
                    .build();
            // ApplicationListener 分为两种，一种是在spring容器初始化完成之前就需要监听事件的，一种是在spring容器初始化完成之后监听事件的
            // 第一种比如: 应用程序的pid写入文件，当程序启动后spring会发送ApplicationPreparedEvent事件，但是这个时候，spring还没有扫描所有组件进行初始化。
            // 这个时候就无法监听
            //application.addListeners(new ApplicationPidFileWriter());
            application.addListeners(new WebServerPortFileWriter());
            // 第二种是比较常见的，这里就不演示了
            application.run(args);
        } catch (Exception ex){
            ex.printStackTrace();
        }
}

在resources目录下的META-INF/spring.factories中添加下面内容

org.springframework.context.ApplicationListener=org.springframework.boot.context.ApplicationPidFileWriter

启动后会自动生成这两个内容
在这里插入图片描述

ApplicationContext初始化过程中发布的事件

ApplicationStartingEvent是在DefaultBootstrapContext 和SpringApplicationRunListeners刚初始化完
ApplicationEnvironmentPreparedEvent是在环境信息初始化完成
ApplicationContextInitializedEvent是在ApplicationContext初始化完成之后