SpringBoot 事件框架

说明:所有的代码基于SpringBoot 2.0.3版本

SpringBoot 事件架构

SpringBoot事件整体框架

SpringBoot整个事件框架由四部分组成:事件(Event)、事件发布者(Publisher)、事件分发器(dispatcher)和事件监听器(Listener)。

事件(Event)

事件是事件发布者和事件监听器之间通信的载体,事件本身包括事件发布者信息、具体事件信息,在事件的消费流程中事件是有方向的,事件只能从事件发布者流向事件监听器,事件不可以反向传播。

  • 事件继承关系
    SpringBoot中事件都直接或间接继承自Java的EventObject类。EventObject类主要定义了事件源“source”,所有的事件都包含source的引用,source是最初产生事件的对象。ApplicationEvent是SpringBoot框架中的事件基类,系统预置事件和自定义事件必须继承ApplicationEvent.
  • 自定义事件
    通过继承ApplicationEvent可以轻松自定义事件。在自定义事件中可以根据业务需要添加必要的字段来详细的描述事件本身,方便事件监听者获取事件信息并根据信息做出响应。
    UserEvent.class
import org.springframework.context.ApplicationEvent;

public class UserEvent extends ApplicationEvent {
    private final String action;
    private final String userName;

    public UserEvent(Object source, String action, String userName) {
        super(source);
        this.action = action;
        this.userName = userName;
    }

    public String getAction() {
        return action;
    }

    public String getUserName() {
        return userName;
    }
}
  • 系统事件
    SpringBoot已经预置了多个与应用生命周期绑定的事件,下面将按照事件发生的先后顺序简单介绍
    • ApplicationStartingEvent
      Spring Application启动事件。事件产生的时机为ApplicationListeners注册之后,Environment或ApplicationContext可用之前,事件源为Spring Application自身,ApplicationStartingEvent在生命周期过程中可能会被修改,请谨慎使用。
    • ApplicationEnvironmentPreparedEvent
      事件产生的时机为Spring Application已经启动,Environment第一次可用。
    • ApplicationPreparedEvent
      事件产生的时机为Spring Application已经启动,Application Context已经完全准备好但是还没有进行刷新,在该阶段已经开始加载Bean定义并且Environment已经完全可用。
    • ApplicationStartedEvent
      事件产生的时机为Application Context已经完成刷新,ApplicationRunner application和CommandLineRunner调用之前。
    • ApplicationReadyEvent
      Spring Application已经准备好对外提供服务。
    • ApplicationFailedEvent
      应用启动失败

事件发布者(Publisher)

事件的发布主体,Publisher通过事件向事件监听器(Listener)发送信息触发业务处理逻辑。在SpringBoot中,事件的发布者通常为xxxContext,在SpringBoot的框架中Context有“父子”关系,子Contenxt发布的事件,父Context会重复发布一次,事件会被重复消费,如果对应的处理逻辑有副作用,则会影响业务的正确性,在使用的时候一定要根据自己的业务选择合适的Context发布事件。

事件分发器(dispatcher)

事件分发器的主要职责是:将事件准确的分发给该事件的监听器。通常事件分发器需要维护一个事件到监听器之间的映射关系,以方便快速、准确的分发事件。很多框架的事件分发机制都是通过类似的原理实现,比如Zookeeper,Java NIO中的WatchService,Apache Commons FileAlterationListener接口等。SpringBoot中的事件分发器的接口为ApplicationEventMulticaster,该接口共有7个方法,按照功能可以分为三类:增加监听器、移除监听器、事件多播

  • 增加监听器
void addApplicationListener(ApplicationListener<?> listener)
void addApplicationListenerBean(String listenerBeanName)
  • 移除监听器
void removeApplicationListener(ApplicationListener<?> listener)
void removeApplicationListenerBean(String listenerBeanName)
void removeAllListeners()
  • 事件多播
void multicastEvent(ApplicationEvent event)
void multicastEvent(ApplicationEvent event, @Nullable ResolvableType eventType)

事件监听器(Listener)

事件监听器是对特定事件感兴趣的对象,在收到感兴趣的事件后通常执行特定的业务逻辑,从而达到业务流程或代码架构解耦的效果。

监听器的实现

  • 实现ApplicationListener接口
    接口只有一个方法用于在事件发生时执行特定的业务逻辑,一个简单的UserEvent事件监听器如下
import org.springframework.context.ApplicationListener;
@Component
public class UserEventService implements ApplicationListener<UserEvent> {
    @Override
    public void onApplicationEvent(UserEvent event) {
        System.out.println(event.getAction());
    }
}

一个监听器需要进行注册才能被dispatcher分发,在SpringBoot中注册监听器有两种方式,第一种调用SpringApplication的addListeners方法,第二种利用SpringBoot的自动管理Bean的功能,将监听器注册为一个普通的Bean,例子中使用第二种方法。

  • 使用@EventListener注解
import org.springframework.stereotype.Component;
@Component
public class UserEventListener {
    @EventListener
    public void execute(UserEvent event) {
        System.out.println("@"+event.getAction());
    }
}

异步调用

  • 自定义异步执行器Executor
    自定义异步执行器只需要实现AsyncConfigurer接口即可,同时可以自定义异常处理器,AsyncConfigurer如下
public interface AsyncConfigurer {
    @Nullable
    default Executor getAsyncExecutor() {
        return null;
    }
    @Nullable
    default AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
        return null;
    }
}

一个简单的实现如下:

@Configuration
@EnableAsync
public class AsyncConfigurerImpl implements AsyncConfigurer {
    private static final Logger log = LoggerFactory.getLogger(AsyncConfigurerImpl.class);
    ThreadFactory factory = new ThreadFactoryBuilder().setNameFormat("AsyncEexecutor-%d").build();

    @Override
    public Executor getAsyncExecutor() {
        Executor executor = new ThreadPoolExecutor(1, 1,
            0L, TimeUnit.MILLISECONDS,
            new LinkedBlockingQueue<Runnable>(), factory);
        return executor;
    }

    @Override
    public AsyncUncaughtExceptionHandler getAsyncUncaughtExceptionHandler() {
        return new AsyncUncaughtExceptionHandler() {
            @Override
            public void handleUncaughtException(Throwable throwable, Method method, Object... objects) {
                log.error("async exception {},method {}, args {}", throwable.getMessage(), method.getName(), objects);
            }
        };
    }
}

必须同时添加注解@Configuration和@EnableAsync

  • 使用@Async开启方法异步调用
    在类或方法上添加注解@Async即可实现方法的异步调用
import org.springframework.context.ApplicationListener;
@Component
@Async
public class UserEventService implements ApplicationListener<UserEvent> {
    @Override
    public void onApplicationEvent(UserEvent event) {
        System.out.println(event.getAction());
    }
}

总结

SpringBoot的事件机制整体非常的简介上手容易,但是一不小心可能会出现事件重复发布重复消费的问题给业务带来损害,另外业务和SpringBoot紧耦合,如果业务需要迁移平台对应的业务流程需要整改,如果不想和框架紧耦合可以考虑使用Google Guava中的EventBus或按照框架自己实现也是非常简单的。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,585评论 18 139
  • Spring Boot 参考指南 介绍 转载自:https://www.gitbook.com/book/qbgb...
    毛宇鹏阅读 46,724评论 6 342
  • 1、通过CocoaPods安装项目名称项目信息 AFNetworking网络请求组件 FMDB本地数据库组件 SD...
    阳明先生x阅读 15,967评论 3 119
  • 如果能去历史上的任何时间,你会选择去什么时候呢? 最近被问到这个问题,我有一点懵。因为从来没想过要回去改变自己的过...
    鱼鲜支阅读 896评论 16 27
  • 从今天开始叫我姐姐 我给你买大白兔 买薄荷糖买酸奶片 买一刻钟安魂曲 傍晚来时叫我洁洁 我戴上小白帽红手套 顺着丝...
    锄风少年阅读 243评论 1 3