22 ApplicationEvent
Spring允许我们在ApplicationContext中发布ApplicationEvent事件,然后对应的ApplicationListener可以用来监听对应的事件。当发布了一个ApplicationEvent后,在对应bean容器中实现了ApplicationListener接口的bean实例都会接收到对应的通知,即对应的ApplicationListener回调方法将会被调用。
22.1内置事件
Spring自身已经为我们提供了几个ApplicationEvent,它们会由Spring在相应的时间自动进行发布,用户如果有需要可以对它们进行监听。具体来说有如下几种类型。
22.1.1 ContextRefreshedEvent
ContextRefreshedEvent将在对应的ApplicationContext调用refresh()方法时进行发布,这也包括直接使用配置文件等进行对应的ApplicationContext初始化时,因为在这个时候也会调用对应的refresh()方法。而在refresh()方法中是在该方法的最后才进行ContextRefreshedEvent发布的,也就是说在发布ContextRefreshedEvent时对应ApplicationContext中的bean定义都已经加载完成,对应的BeanFactoryPostProcessor都执行过了,需要实例化的bean也都已经实例化了。
22.1.2 ContextStartedEvent
ContextStartedEvent将在对应的ApplicationContext调用start()方法时进行发布。此时已经对所有实现了LifeCycle接口的bean回调了对应的start()方法。
22.1.3ContextStoppedEvent
ContextStoppedEvent将在对应的ApplicationContext调用stop()方法时进行发布。此时已经对所有实现了LifeCycle接口的bean回调了对应的stop()方法。
22.1.4ContextClosedEvent
ContextClosedEvent将在对应的ApplicationContext调用close()方法时进行发布。此时所有的资源都已经销毁了。ContextRefreshedEvent、ContextStartedEvent、ContextStoppedEvent和ContextClosedEvent都继承自ApplicationContextEvent,因为它们都是针对ApplicationContext的事件。
22.1.5 ServletRequestHandledEvent
ServletRequestHandledEvent将在Spring处理了一个HttpRequest请求后进行发布,即对应的HttpRequest已经完成了。ServletRequestHandledEvent只能在使用DispatcherServlet时使用,当DispatcherServlet处理完一个HttpRequest请求后将发布一个ServletRequestHandledEvent。ServletRequestHandledEvent继承自RequestHandledEvent,所以当我们需要监听RequestHandledEvent时也可以监听ServletRequestHandledEvent。
22.2 自定义事件
Spring能够发布的事件是ApplicationEvent,其是一个继承了EventObject的抽象类。其源码如下所示,我们可以看到其只有一个构造方法,且必须传入一个对象作为当前事件发布的发布者。
public abstract class ApplicationEvent extends EventObject {
/** use serialVersionUID from Spring 1.2 for interoperability */
private static final long serialVersionUID = 7099057708183571937L;
/** System time when the event happened */
private final long timestamp;
/**
* Create a new ApplicationEvent.
* @param source the component that published the event (never {@code null})
*/
public ApplicationEvent(Object source) {
super(source);
this.timestamp = System.currentTimeMillis();
}
/**
* Return the system time in milliseconds when the event happened.
*/
public final long getTimestamp() {
return this.timestamp;
}
}
用户如果需要自定义事件则是自定义一个继承ApplicationEvent的类,除了提供构造父类必须要有的source对象以外,其它信息都可以由用户自定义。如下我们就简单的实现了一个自定义的ApplicationEvent,那么在之后进行事件发布时就可以使用自定义的MyApplicationEvent来作为ApplicationEvent进行发布了。
public class MyApplicationEvent extends ApplicationEvent {
private static final long serialVersionUID = 1L;
public MyApplicationEvent(Object source) {
super(source);
}
}
22.3 事件发布
事件的发布是由ApplicationEventPublisher接口中的publishEvent()方法定义的,其定义如下。
public interface ApplicationEventPublisher {
void publishEvent(ApplicationEvent event);
}
ApplicationContext接口继承了ApplicationEventPublisher接口,所以我们可以直接使用ApplicationContext来进行事件的发布。如下示例中我们就给Hello注入了一个ApplicationContext,然后在调用其doSomething()方法时通过注入的ApplicationContext发布了一个自定义的MyApplicationEvent。
@Component
public class Hello {
@Autowired
private ApplicationContext context;
public void doSomething() {
System.out.println("----do something....");
//发布一个自定义的MyApplicationEvent
context.publishEvent(new MyApplicationEvent(this));
}
}
除了直接使用ApplicationContext进行事件发布外,Spring还给我们提供了一个用于发布事件的ApplicationEventPublisher接口对应的Aware接口——ApplicationEventPublisherAware,该接口跟Spring提供的其它Aware接口一样,当一个bean实现了该接口以后,Spring在实例化对应的bean后将调用其中的回调方法以传入一个ApplicationEventPublisher,通常就是传递的当前的ApplicationContext对象。所以我们还可以让我们的bean实现ApplicationEventPublisherAware接口,然后使用Spring传入的ApplicationEventPublisher发布对应的事件。所以上述示例我们也可以把它改成实现ApplicationEventPublisherAware的方式,示例如下。
@Component
public class Hello implements ApplicationEventPublisherAware {
private ApplicationEventPublisher eventPublisher;
public void doSomething() {
System.out.println("----do something....");
//发布一个自定义的MyApplicationEvent
this.eventPublisher.publishEvent(new MyApplicationEvent(this));
}
public void setApplicationEventPublisher(
ApplicationEventPublisher applicationEventPublisher) {
this.eventPublisher = applicationEventPublisher;
}
}
22.4 事件监听
事件监听需要定义对应的监听器,Spring中用于监听ApplicationEvent的监听器是通过ApplicationListener来定义的。ApplicationListener是一个接口,其定义如下,我们可以看到该接口中使用了泛型,即可以指定只监听某种类型的ApplicationEvent。
public interface ApplicationListener<E extends ApplicationEvent> extends EventListener {
void onApplicationEvent(E event);
}
ApplicationListener每次监听到对应的ApplicationEvent后都将调用其onApplicationEvent()方法。所以如果我们想定义一个只监听之前自定义的MyApplicationEvent的监听器,则可以如下定义,如果想监听所有的ApplicationEvent,则可以将泛型指定为ApplicationEvent,即将如下的MyApplicationEvent改成ApplicationEvent。
public class MyApplicationListener implements ApplicationListener<MyApplicationEvent> {
public void onApplicationEvent(MyApplicationEvent event) {
System.out.println(event.getSource() + "****************" + event.getTimestamp());;
}
}
光实现了ApplicationListener接口,对应的监听器还监听不到对应的事件。我们需要把它们定义bean容器中的一个bean,这样当Spring发布了一个事件后就会将其传递给相匹配的监听器。所以针对于上述监听器,我们可以在基于XML进行配置时在对应的XML配置文件中进行如下配置。
<bean class="com.app.MyApplicationListener"/>
如果是基于注解的扫描则可以在MyApplicationListener上使用@Component等注解进行标注。
(注:本文是基于Spring4.1.0所写)