我们知道观察者模式可以实现代码的解耦,而spring的event模型就是这种设计模式的极佳体现。一个事件包含:事件发布、监听、和事件源。在spring中我们可以通过ApplicationContext的publishEvent方法去发布事件;通过实现ApplicationListener接口来自定义自己的监听器;继承ApplicationEvent类来实现事件源。下面以一个实例来说明:
1.spring下使用event模型
1.1 定义event
/**
* event的基类
*
* @author 94977
* @create 2018/7/22
*/
public abstract class BaseEvent extends ApplicationEvent {
public BaseEvent(Object source) {
super(source);
}
}
public class FaceEvent extends BaseEvent {
/**
* @author 94977
* @time 2018/7/22 15:50
* @param * @param null
* @return
* @description 必须要实现的构造方法
*/
public FaceEvent(User user) {
super(user);
}
}
1.2 event的监听处理类。监听类实现ApplicationListener 里onApplicationEvent方法即可
@Component
public class FaceEventListener implements ApplicationListener {
@Override
public void onApplicationEvent(ApplicationEvent event) {
if(event instanceof FaceEvent){
User user = (User) event.getSource();
LOGGER.info("===> 收到人脸事件: {}",user);
// .....
System.out.println("人脸事件处理结束。。。");
}
}
}
当然通过event instanceof FaceEvent判断事件源来处理的方式不是很优雅。有更好的方式,接口ApplicationListener支持泛型,可以通过泛型来判断处理的事件源。如下只处理FaceEvent源。
@Component
public class FaceEventListener extends BaseEventListener implements ApplicationListener
@Override
public void onApplicationEvent(FaceEvent event) {
User user = (User) event.getSource();
LOGGER.info("===> 收到人脸事件: {}",user);
// .....
System.out.println("人脸事件处理结束。。。");
}
}
如果要实现有序的监听,实现SmartApplicationListener 接口即可
1.3 发布事件
@Service
public class FaceHandler {
@Autowired
private ApplicationContext applicationContext;
public void handle(){
User user = new User();
user.setAge(34);
user.setUsername("人脸事件");
user.setHobby("抓拍");
//发布事件
applicationContext.publishEvent(new FaceEvent(user));
//进行其他业务处理
}
以上即可。
2.evnet模型的注意点
事件没要处理的监听器,就会被抛弃。
一个事件可以同时被多个监听处理类监听处理。
以上处理事件都是同步的,如果发布事件处的业务存在事务,监听器处理也会在相同的事务中。这个一定要注意!如果对于事件的处理不想受到影响,可以onApplicationEvent方法上加@Aync支持异步(参考taskExecutor的使用)。
原理部分可以参考 博客 事件体系
3. 一种更优雅的方式——@EventListener
3.1 发布事件
我们可以通过工具类发布来避免在代码耦合注入ApplicationContext,工具类实现ApplicationEventPublisherAware 接口,具体可参考spring的aware学习。
这里有一个小细节,如果通过注入ApplicationContext的方式来发布事件,idea在代码左边会有一个类似耳机的小图标,点击可以跳到监听此发布事件的监听者位置,用工具类发布事件就没有此提示了。
3.2 定义事件源
public abstract class BaseEvent
private static final long serialVersionUID = 895628808370649881L;
protected T eventData;
public BaseEvent(Object source, T eventData){
super(source);
this.eventData = eventData;
}
public BaseEvent(T eventData){
super(eventData);
}
public T getEventData() {
return eventData;
}
public void setEventData(T eventData) {
this.eventData = eventData;
}
}
需要发布的事件继承此BaseEvent
public class FaceEvent extends BaseEvent
public FaceEvent(User user) {
super(user);
}
public FaceEvent(Object source, User user){
super(source,user);
}
}
如果代码结构较复杂,多处发布相同的事件,建议发布事件时将this作为source传递,便于通过分析日志确定发布源。
3.3 监听事件@EventListener
在spring4.2中我们可以以更加简洁的方式来监听event的发布,监听事件我们不必再实现ApplicationListener接口了,只要在方法上添加注解@EventListener即可:
@EventListener
public void onApplicationEvent(FaceEvent event) {
User user = (User) event.getSource();
String name = Thread.currentThread().getName();
LOGGER.info("===> 收到人脸事件: {},线程名为: {}",user,name);
}
这真的是很方便。
@EventListener还有一个属性,condition()里可以使用SPEL表达式来过滤监听到事件,即只有符合某种条件的才进行接收处理。暂时还用不到。
3.4 监听事件时的事务隔离
@TransactionalEventListener和@EventListener都可以监听事件,但前者可以对发布事件和监听事件进行一些事务上的隔离。@TransactionalEventListenerr指不和发布事件的方法在同一个事务内,发布事件的方法事务结束后才会执行本监听方法,监听逻辑内发生异常不会回滚发布事件方法的事务。
@Transactional(rollbackFor = Exception.class)
public void handle(){
User user = new User();
user.setAge(34);
user.setUsername("人脸事件");
user.setHobby("抓拍");
//处理完上面的逻辑后,发布事件
EventPublisherUtil.publishEvent(new FaceEvent(user));
//数据库添加操作
Integer integer = deviceAlarmService.addDevice();
}
可以看到发布事件的方法处在事务控制中,我们使用@TransactionalEventListener来监听事件:
@TransactionalEventListener(fallbackExecution = true)
public void onApplicationEvent(FaceEvent event) {
User user = event.getEventData();
LOGGER.info("===> A 收到人脸事件: {}}",user);
//@TransactionalEventListener指不和发布事件的在同一个事务内,发布事件的方法事务结束后才会执行本方法
// ,本方法发生异常不会回滚发布事件的事务,
throw new RuntimeException("监听事件抛出异常");
}
运行结果,addDevice正常在数据库插入数据,但是修改为@EventListener监听则插入数据失败。
@TransactionalEventListener有一个属性为fallbackExecution,默认为false,指发布事件的方法没有事务控制时,监听器不进行监听事件,此为默认情况! fallbackExecution=true,则指发布事件的方法没有事务控制时,监听方法仍可以监听事件进行处理。
/**
* Whether the event should be processed if no transaction is running.
*/
boolean fallbackExecution() default false;
刚才我们说到使用@TransactionalEventListener会在发布事件的方法事务结束后执行监听方法,但其实我们还可以进行细化的控制。它有一个属性为TransactionPhase,默认为TransactionPhase.AFTER_COMMIT,即事务提交后。还可以根据需要选择AFTER_COMPLETION、BEFORE_COMMIT、AFTER_ROLLBACK。
但仍需注意,如果fallbackExecution=false,且发布事件的方法没有事务控制时,监听器根本不会监听到事件,此处的TransactionPhase也就没有意义了。