23.5. Application事件和监听器
除了常见的Spring框架事件,比如ContextRefreshedEvent,SpringApplication
也会发送其他的application事件。
注 有些事件实际上是在ApplicationContext
创建前触发的,所以你不能在那些事件(处理类)中通过@Bean
注册监听器,只能通过SpringApplication.addListeners(…)
或SpringApplicationBuilder.listeners(…)
方法注册。如果想让监听器自动注册,而不关心应用的创建方式,你可以在工程中添加一个META-INF/spring.factories
文件,并使用org.springframework.context.ApplicationListener
作为key指向那些监听器,如下:
org.springframework.context.ApplicationListener=com.example.project.MyListener
应用运行时,事件会以下面的次序发送:
- 在运行开始,但除了监听器注册和初始化以外的任何处理之前,会发送一个
ApplicationStartedEvent
。 - 在Environment将被用于已知的上下文,但在上下文被创建前,会发送一个
ApplicationEnvironmentPreparedEvent
。 - 在refresh开始前,但在bean定义已被加载后,会发送一个
ApplicationPreparedEvent
。 - 在refresh之后,相关的回调处理完,会发送一个
ApplicationReadyEvent
,表示应用准备好接收请求了。 - 启动过程中如果出现异常,会发送一个
ApplicationFailedEvent
。
注 通常不需要使用application事件,但知道它们的存在是有用的(在某些场合可能会使用到),比如,在Spring Boot内部会使用事件处理各种任务。