Google-Guava-EventBus源码解读

Guava是Google开源的一个Java基础类库,它在Google内部被广泛使用。Guava提供了很多功能模块比如:集合、并发库、缓存等,EventBus是其中的一个module,本篇结合EventBus源码来谈谈它的设计与实现。

概要

首先,我们先来预览一下EventBus模块的全部类图:


类并不是多而且几乎没有太多继承关系。

下面,我们来看一下各个类的职责:

  • EventBus:核心类,代表了一个事件总线。Publish事件也由它发起。
  • AsyncEventBus:在分发事件的时候,将其压入一个全局队列的异步分发模式。
  • Subscriber:对某个事件的处理器抽象,封装了事件的订阅者以及处理器,并负责事件处理(该类的类名及其语义有些不明确,后续会谈到)。
  • SubscriberRegistry:订阅注册表,它用于存储Subscriber跟Event的对应关系,以便于EventBus在publish一个事件时,可以找到它对应的Subscriber。
  • Dispatcher:事件分发器,它定义了事件的分发策略。
  • @Subscribe:用于标识事件处理器的注解,当EventBus publish一个事件后,相应的Subscriber将会得到通知并执行事件处理器。
  • @AllowConcurrentEvents:该注解跟@Subscribe一同使用,标识该订阅者的处理方法为线程安全的,该注解还用于标识该方法将可能会被EventBus在多线程环境下执行。
  • DeadEvent:死信(没有订阅者关注的事件)对象。
  • SubscribeExceptionHandler:订阅者抛出异常的处理器。
  • SubscribeExceptionContext:订阅者抛出异常的上下文对象。
在对每个类进行分解之前,我们再来看一下各个类之间的关联关系:

分“类”解读

EventBus

它有这么几个字段:
  • identifier:事件总线的标识,这说明在一个应用里是可以有多个EventBus的。如果不指明它的值,它将以“default”作为其默认名称。
  • executor:它是Executor接口的实例,用于对订阅者处理事件方法的执行。这里需要注意的是,该字段的实例化是在EventBus内部构造器中,并不是从外部注入进来的,另外真正的执行订阅者方法的时机也不由EventBus负责,而是由Subscriber负责,因此该字段会被公开给外部访问。
  • exceptionHandler:它是SubscribeExceptionHandler的实例,用于处理订阅者在执行事件处理方法时抛出的异常。EventBus可以接收一个外部定义的异常处理器,也可以采用内部缺省的日志记录处理器。
  • subscribers:订阅者注册表,用于存储所有的事件以及事件处理器、订阅对象的对应关系。
  • dispatcher:事件分发器,用于分发事件给订阅对象的事件处理器,该对象在EventBus构造方法内部初始化,默认的实现是PerThreadQueuedDispatcher,该分发器将事件存入队列,并保证在同一个线程上发送的事件能够按照他们发布的顺序被分发给所有的订阅者。
EventBus提供了几个核心方法:
  • register:注册subscriber;
  • unregister:移除注册过的subscriber;
  • post:发布事件;

你可以将EventBus看做是一个代理,这些方法真正的实现者都是上面的这些对象。

AsyncEventBus

一个支持异步发布模式的EventBus,它覆盖了EventBus的默认构造方法,指定了一个异步的分发器:LegacyAsyncDispatcher,这个分发器基于一个全局的队列来暂存未发布的事件。

Subscriber

之前也提到Subscriber的名称是比较容易混淆的。这个类的名称看似表示一个订阅者对象,但其实是用来封装“一个订阅者的一个事件处理器”对象。因为当一个订阅者存在多个处理方法被标注为@Subscribe的时候,那么每个处理方法都对应于一个独立的Subscriber对象的实例。我个人觉得这个名称与其具体的实现语义有些混淆。当然也许实现者认为:一个对象以及一个事件处理器就是一个Subscriber的话,那是没有问题的。因此这里为了理解方便,你可以将其看做是一个封装了订阅者对象以及一个订阅者处理器方法的实体类。
Subscriber的访问级别是package的,它还承担了执行事件处理的责任。通过一个create静态工厂方法创建它:
static Subscriber create(EventBus bus, Object listener, Method method) {return isDeclaredThreadSafe(method)? new Subscriber(bus, listener, method): new SynchronizedSubscriber(bus, listener, method);}

它接收三个参数:
  • bus:EventBus的实例,通过它来获取事件的执行器(executor)
  • listener:真实的订阅者对象
  • method:订阅对象的事件处理方法的Method实例
在实现中,它会先判断该处理器方法上是否被标注有@AllowConcurrentEvents注解,如果有,则实例化Subscriber类的一个实例;如果没有,则不允许eventbus在多线程的环境中调用处理器方法,所以这里专门为此提供了一个同步的订阅者对象:SynchronizedSubscriber来保证线程安全。
该类的两个关键方法之一:
dispatchEvent:
final void dispatchEvent(final Object event) {executor.execute(new Runnable() {@Overridepublic void run() {try {invokeSubscriberMethod(event);} catch (InvocationTargetException e) {bus.handleSubscriberException(e.getCause(), context(event));}}});}

它调用一个多线程执行器来执行事件处理器方法。
另一个方法:invokeSubscriberMethod以反射的方式调用事件处理器方法。
另外,该类对Object的equals方法进行了override并标识为final。主要是为了避免同一个对象对某个事件进行重复订阅,在SubscriberRegistry中会有相应的判等操作。当然这里Subscriber也override并final了hashCode方法。这是最佳实践,不必多谈,如果不了解的可以去看看《Effective Java》。
该类还有个内部类,就是我们上面谈到的SynchronizedSubscriber,它继承了Subscriber,与Subscriber唯一的不同就是在invokeSubscriberMethod的执行上做了同步。

SubscriberRegistry

针对单个EventBus的订阅与事件的关系维护。在内部用来存储订阅者关系的对象是java并发包下的并发Map:ConcurrentMap,该map以Class对象为键,值的类型是CopyOnWriteArraySet<Subscriber>集合类型。
SubscriberRegistry直接依赖EventBus对象,所以在构造器中需要注入EventBus的实例。
SubscriberRegistry里有两个关键的实例方法:register/unregister。

register

接收订阅者对象作为参数并建立Event跟Subscriber的关联关系。
我们来看看它的实现:
void register(Object listener) {Multimap<Class<?>, Subscriber> listenerMethods = findAllSubscribers(listener);for (Map.Entry<Class<?>, Collection<Subscriber>> entry : listenerMethods.asMap().entrySet()) {Class<?> eventType = entry.getKey();Collection<Subscriber> eventMethodsInListener = entry.getValue();CopyOnWriteArraySet<Subscriber> eventSubscribers = subscribers.get(eventType);if (eventSubscribers == null) {CopyOnWriteArraySet<Subscriber> newSet = new CopyOnWriteArraySet<Subscriber>();eventSubscribers = MoreObjects.firstNonNull(subscribers.putIfAbsent(eventType, newSet), newSet);}eventSubscribers.addAll(eventMethodsInListener);}}

它首先获得一个Multimap实例(它是Google Guava集合框架提供的一个多值Map类型,也就是说一个key可以对应多个value),该Multimap用于存储事件类型对应的该订阅者内所有关于该事件的处理器方法集合,其key为事件的Class类型。这里在for循环的中通过asMap获取其map视图,即可将Multimap对应的多个值存储到一个Collection中。
也就是说这里for循环的每个entry,表示的是一个事件的Class实例对应的一组Subscriber的集合,即eventMethodsInListener。
然后根据该事件的Class对象从注册表中获取对应的存储Subscriber实例的集合,如果不存在则创建该集合,然后将该订阅者内所有的事件处理器方法都加入到注册表中去。

unregister

unregister的实现跟register有些类似,先查找该订阅者所有的事件类型与处理器的对应关系。然后,遍历所有的事件类型,移除针对当前订阅者的所有Subscriber实例。

findAllSubscribers

register/unregister方法都调用了findAllSubscribers方法,它有一些特别之处,这里需要单独拎出来提一下。
findAllSubscribers用于查找事件类型以及事件处理器的对应关系。查找注解需要涉及到反射,通过反射来获取标注在方法上的注解。因为Guava针对EventBus的注册采取的是“隐式契约”而非接口这种“显式契约”。而类与接口是存在继承关系的,所有很有可能某个订阅者其父类(或者父类实现的某个接口)也订阅了某个事件。因此这里的查找需要顺着继承链向上查找父类的方法是否也被注解标注,代码实现:
  private Multimap<Class<?>, Subscriber> findAllSubscribers(Object listener) {Multimap<Class<?>, Subscriber> methodsInListener = HashMultimap.create();Class<?> clazz = listener.getClass();for (Method method : getAnnotatedMethods(clazz)) {Class<?>[] parameterTypes = method.getParameterTypes();Class<?> eventType = parameterTypes[0];methodsInListener.put(eventType, Subscriber.create(bus, listener, method));}return methodsInListener;}

同样涉及这个问题的,还有根据事件类型获取Subscriber实例的方法:getSubscribers。

getSubscribers

  Iterator<Subscriber> getSubscribers(Object event) {ImmutableSet<Class<?>> eventTypes = flattenHierarchy(event.getClass());List<Iterator<Subscriber>> subscriberIterators =Lists.newArrayListWithCapacity(eventTypes.size());for (Class<?> eventType : eventTypes) {CopyOnWriteArraySet<Subscriber> eventSubscribers = subscribers.get(eventType);if (eventSubscribers != null) {// eager no-copy snapshotsubscriberIterators.add(eventSubscribers.iterator());}}return Iterators.concat(subscriberIterators.iterator());}

Dispatcher

dispatcher用于分发事件给Subscriber。它内部实现了多个分发器用于提供在不同场景下不同的事件顺序性。Dispatcher是一个抽象类,定义了一个核心抽象方法:

abstract void dispatch(Object event, Iterator<Subscriber> subscribers);

该方法用于将一个指定的事件分发给所有的订阅者。

另外在Dispatcher提供了三个不同的分发器实现:

PerThreadQueuedDispatcher

它比较常用,针对每个线程构建一个队列用于暂存事件对象。保证所有的事件都按照他们publish的顺序从单一的线程上发出。保证从单一线程上发出,没什么特别的地方,主要是在内部定义了一个队列,将其放在ThreadLocal中,用以跟特定的线程关联。

LegacyAsyncDispatcher

另一个异步分发器的实现:LegacyAsyncDispatcher,之前在介绍AsyncEventBus的时候提到,它就是用这种实现来分发事件。
它在内部通过一个ConcurrentLinkedQueue<EventWithSubscriber>的全局队列来存储事件。从关键方法:dispatch的实现来看,它跟PerThreadQueuedDispatcher的区别主要是两个循环上的差异(这里基于队列的缓存事件的方式,肯定会存在两个循环:循环取队列里的事件以及循环发送给Subscriber)。
PerThreadQueuedDispatcher:是两层嵌套循环,外层是遍历队列取事件,内存是遍历事件的订阅处理器。
LegacyAsyncDispatcher:是一前一后两个循环。前面一个是遍历事件订阅处理器,并构建一个事件实体对象存入队列。后一个循环是遍历该事件实体对象队列,取出事件实体对象中的事件进行分发。

ImmediateDispatcher

其实以上两个基于中间队列的分发实现都可以看做是异步模式,而ImmediateDispatcher则是同步模式:只要有事件发生就会立即分发并被立即得到处理。ImmediateDispatcher从感官上看类似于线性并顺序执行,而采用队列的方式有多线程汇聚到一个公共队列的由发散到聚合的模型。因此,ImmediateDispatcher的分发方式是一种深度优先的方式,而使用队列是一种广度优先的方式。

DeadEvent

它是一个实体对象,封装了没有订阅者的事件。DeadEvent由两个属性组成:
  • source:事件源(通常指发布事件的EventBus对象)
  • event:事件对象
DeadEvent对象的产生:当通过某个EventBus的实例发布一个事件的时候,没有找到事件订阅者并且它本身又不是一个DeadEvent的实例时,将由EventBus构建一个DeadEvent类的实例。

总结

Guava的EventBus源码还是比较简单、清晰的。从源码来看,它一番常用的Observer的设计方式,放弃采用统一的接口、统一的事件对象类型。转而采用基于注解扫描的绑定方式。
其实无论是强制实现统一的接口,还是基于注解的实现方式都是在构建一种关联关系(或者说满足某种契约)。很明显接口的方式是编译层面上强制的显式契约,而注解的方式则是运行时动态绑定的隐式契约关系。接口的方式是传统的方式,编译时确定观察者关系,清晰明了,但通常要求有一致的事件类型、方法签名。而基于注解实现的机制,刚好相反,编译时因为没有接口的语法层面上的依赖关系,显得不那么清晰,至少静态分析工具很难展示观察者关系,但无需一致的方法签名、事件参数,至于多个订阅者类之间的继承关系,可以继承接收事件的通知,可以看作既是其优点也是其缺点。


原文发布时间为:2015-06-01

本文作者:vinoYang

本文来自云栖社区合作伙伴CSDN博客,了解相关信息可以关注CSDN博客。

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.mzph.cn/news/392609.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

leetcode 1370. 上升下降字符串

给你一个字符串 s &#xff0c;请你根据下面的算法重新构造字符串&#xff1a; 从 s 中选出 最小 的字符&#xff0c;将它 接在 结果字符串的后面。 从 s 剩余字符中选出 最小 的字符&#xff0c;且该字符比上一个添加的字符大&#xff0c;将它 接在 结果字符串后面。 重复步骤…

mysql 设置事物自动提交_mysql事务自动提交的问题

1&#xff1a;mysql的aut0commit配置默认是开启的&#xff0c;也就是没执行一条sql都会提交一次&#xff0c;就算显示的开启事务也会导致多条SQL不在一个事务中&#xff0c;如果需要相关的SQL在同一个事务中执行&#xff0c;那么必须将autocommit设置为OFF&#xff0c;再显式开…

rest laravel_如何通过测试驱动开发来构建Laravel REST API

rest laravelby Kofo Okesola由Kofo Okesola 如何通过测试驱动开发来构建Laravel REST API (How to build a Laravel REST API with Test-Driven Development) There is a famous quote by James Grenning, one of the pioneers in TDD and Agile development methodologies:T…

python之numpy

numpy是一个多维的数组对象&#xff0c;类似python的列表&#xff0c;但是数组对象的每个元素之间由空格隔开。 一、数组的创建 1.通过numpy的array(参数)&#xff0c;参数可以是列表、元组、数组、生成器等 由arr2和arr3看出&#xff0c;对于多维数组来说&#xff0c;如果最里…

git 上传

转载于:https://www.cnblogs.com/benbentu/p/6543154.html

Liferay 部署war包时候的deployDirectory 细节分析

引入&#xff1a; 在上文中&#xff0c;我们从宏观上讲解了Liferay部署war包的动作是如何触发监听器并且完成部署过程的&#xff0c;但是其中最核心的一块deployDirectory我们没讲&#xff0c;它的作用是当有了临时目录并且已经把war包的内容展开到该目录之后&#xff0c;是如何…

leetcode 164. 最大间距(桶排序)

给定一个无序的数组&#xff0c;找出数组在排序之后&#xff0c;相邻元素之间最大的差值。 如果数组元素个数小于 2&#xff0c;则返回 0。 示例 1: 输入: [3,6,9,1] 输出: 3 解释: 排序后的数组是 [1,3,6,9], 其中相邻元素 (3,6) 和 (6,9) 之间都存在最大差值 3。 示例 2: …

批处理定时mysql备份数据库_定时备份mysql数据库的批处理

定时备份mysql数据库的批处理代码&#xff0c;保存为backup_mysql.bat&#xff0c;运行即可。复制代码 代码如下:echo offset txt1%date:~0,4%::当前年set txt2%date:~5,2%::当前月set txt3%date:~8,2%::当前日set txt4%time:~0,2%::当前小时set txt5%time:~3,2%::当前分钟set …

算法训练营 重编码_您在编码训练营期间可能面临的最大挑战

算法训练营 重编码by Joanna Gaudyn乔安娜高登(Joanna Gaudyn) 您在编码训练营期间可能面临的最大挑战 (The biggest struggles you might face during a coding bootcamp) You think that during a coding bootcamp nothing can be more challenging than learning programmi…

1449 砝码称重(思维)

题目链接&#xff1a;https://www.51nod.com/onlineJudge/submitDetail.html#!judgeId259281 题解&#xff1a;这题有一个技巧&#xff0c;毕竟是w^0,w^1,w^2....这样&#xff0c;必然会想到w进制&#xff0c;而且就只能用一次。 那么就简单了&#xff0c;把m拆成w进制&#xf…

leetcode 454. 四数相加 II(哈希表)

给定四个包含整数的数组列表 A , B , C , D ,计算有多少个元组 (i, j, k, l) &#xff0c;使得 A[i] B[j] C[k] D[l] 0。 为了使问题简单化&#xff0c;所有的 A, B, C, D 具有相同的长度 N&#xff0c;且 0 ≤ N ≤ 500 。所有整数的范围在 -228 到 228 - 1 之间&#xf…

“换标”Intel的穷则思变

成语有云“穷则思变”&#xff0c;用这个词来形容早先的Intel换标也最恰当不过。当然这里“穷”&#xff0c;不是说Intel很贫穷&#xff0c;而是说Intel在自己的产业到了尽头。Intel推产品概念的水平是一流的&#xff0c;虽然某些概念事后被认为是错误的&#xff08;如&#xf…

mysql开发中遇到的坑_mysql优化过程中遇见的坑(mysql优化问题特别注意)

单条查询最后添加 LIMIT 1&#xff0c;停止全表扫描。对于char(4) 或者vachar(4)&#xff0c;无论是中文还是英文都是存储四个字符&#xff0c;注意是字符而不是字节。如果一个字段未int类型&#xff0c;此类型只有0、1两个状态&#xff0c;需要为此建立索引吗&#xff1f;过度…

初级开发人员的缺点_在您作为初级开发人员的第一年获得此建议

初级开发人员的缺点Are you a junior developer embarking on your software development career?您是从事软件开发事业的初级开发人员吗&#xff1f; Or a recent computer science graduate who has recently started a new job?还是最近刚开始从事新工作的计算机科学专业…

Spark日志分析

根据tomcat日志计算url访问了情况&#xff0c;具体的url如下&#xff0c; 要求&#xff1a;区别统计GET和POST URL访问量 结果为&#xff1a;访问方式、URL、访问量 输入文件&#xff1a; 196.168.2.1 - - [03/Jul/2014:23:36:38 0800] "GET /course/detail/3.htm HTTP/1.…

进程、线程和协程的区别

首先&#xff0c;给出“进程、线程和协程”的特点&#xff1a; 进程&#xff1a;拥有自己独立的堆和栈&#xff0c;既不共享堆&#xff0c;也不共享栈&#xff0c;进程由操作系统调度&#xff1b;线程&#xff1a;拥有自己独立的栈和共享的堆&#xff0c;共享堆&#xff0c;不共…

leetcode 493. 翻转对(分治算法)

给定一个数组 nums &#xff0c;如果 i < j 且 nums[i] > 2*nums[j] 我们就将 (i, j) 称作一个重要翻转对。 你需要返回给定数组中的重要翻转对的数量。 示例 1: 输入: [1,3,2,3,1] 输出: 2 代码 class Solution {public int reversePairs(int[] nums) {return getR…

使用brew安装软件

brew 又叫Homebrew&#xff0c;是Mac OSX上的软件包管理工具&#xff0c;能在Mac中方便的安装软件或者卸载软件&#xff0c; 只需要一个命令&#xff0c; 非常方便 brew类似ubuntu系统下的apt-get的功能 阅读目录 安装brew 使用brew安装软件 使用brew卸载软件 使用brew查询软…

mysql 绕过select报错_MySQL注射绕过技巧(三)

在测试一次注入的时候发现过滤了逗号 所以找到这个思路第一次遇到的时候是看key哥挖洞 遇到后就想记录下来正文过滤了逗号 利用join来逐步查询select*from(select 1)a join (select 2)b join (select 3)c;例如下图逐步查询user()user() basediruser() basedir version()也可以…

深入理解javascript

深入理解JavaScript系列&#xff08;1&#xff09;&#xff1a;编写高质量JavaScript代码的基本要点 深入理解JavaScript系列&#xff08;2&#xff09;&#xff1a;揭秘命名函数表达式 深入理解JavaScript系列&#xff08;3&#xff09;&#xff1a;全面解析Module模式 深入理…