一、EventBus简介

EventBus是一个Android端优化的publish/subscribe消息总线,简化了应用程序内各组件间、组件与后台线程间的通信。

作为一个消息总线主要有三个组成部分:

事件(Event):可以是任意类型的对象。通过事件的发布者将事件进行传递。

事件订阅者(Subscriber):接收特定的事件。

事件发布者(Publisher):用于通知 Subscriber 有事件发生。可以在任意线程任意位置发送事件。

img

上图解释了整个EventBus的大概工作流程:事件的发布者(Publisher)将事件(Event)通过post()方法发送。EventBus内部进行处理,找到订阅了该事件(Event)的事件订阅者(Subscriber)。然后该事件的订阅者(Subscriber)通过onEvent()方法接收事件进行相关处理(关于onEvent()在EventBus 3.0中有改动,下面详细说明)。

二、EventBus的简单使用

1、把EventBus依赖到项目

build.gradle添加引用

  1. compile 'de.greenrobot:eventbus:3.0.0-beta1'

2、构造事件(Event)对象。也就是发送消息类
每一个消息类,对应一种事件。这里我们定义两个消息发送类。后面讲解具体作用。

  1. public class NewsEvent {
  2. private String message;
  3. public NewsEvent(String message) {
  4. this.message = message;
  5. }
  6. public String getMessage() {
  7. return message;
  8. }
  9. public void setMessage(String message) {
  10. this.message = message;
  11. }
  12. }
  1. public class ToastEvent {
  2. private String content;
  3. public ToastEvent(String content) {
  4. this.content = content;
  5. }
  6. public String getContent() {
  7. return content;
  8. }
  9. public void setContent(String content) {
  10. this.content = content;
  11. }
  12. }

3、注册/解除事件订阅(Subscriber)

  1. EventBus.getDefault().register(this);//注册事件 其中this代表订阅者

具体注册了对什么事件的订阅,这个需要onEvent()方法来说明。在EventBus 3.0之前,onEvent()方法是用来接收指定事件(Event)类型对象,然后进行相关处理操作。在EventBus 3.0之后,onEvent()方法可以自定义方法名,不过要加入注解@Subscribe

  1. @Subscribe
  2. public void onToastEvent(ToastEvent event){
  3. Toast.makeText(MainActivity.this,event.getContent(),Toast.LENGTH_SHORT).show();
  4. }

通过register(this)来表示该订阅者进行了订阅,通过onToastEvent(ToastEvent event)表示指定对事件ToastEvent的订阅。到这里订阅就完成了。

需要注意的是:一般在onCreate()方法中进行注册订阅。在onDestory()方法中进行解除订阅。

  1. @Override
  2. protected void onDestroy() {
  3. super.onDestroy();
  4. EventBus.getDefault().unregister(this);
  5. }

4 、发送消息
订阅已经完成,那么便可以发送订阅了。

  1. EventBus.getDefault().post(new ToastEvent("Toast,发个提示,祝大家新年快乐!"));

那么onToastEvent(ToastEvent event)会收到事件,并弹出提示。

EventBus的基础使用流程就是这样的。

其实,EventBus还有好多其他的功能。下面我们一个个介绍。

三、EventBus的进阶使用

1.线程模式ThreadMode

当你接收的的事件后,如果处于非UI线程,你要更新UI怎么办?如果处于UI线程,你要进行耗时操作,怎么办?等等其他情况,通过ThreadMode统统帮你解决。

用法展示:

  1. @Subscribe(threadMode = ThreadMode.MainThread)
  2. public void onNewsEvent(NewsEvent event){
  3. String message = event.getMessage();
  4. mTv_message.setText(message);
  5. }

使用起来很简单,通过@Subscribe(threadMode = ThreadMode.MainThread)即可指定。
下面具体介绍下ThreadMode。

关于ThreadMode,一共有四种模式PostThread,PostThread,BackgroundThread以及Async。

PostThread:事件的处理在和事件的发送在相同的进程,所以事件处理时间不应太长,不然影响事件的发送线程。

MainThread: 事件的处理会在UI线程中执行。事件处理时间不能太长,这个不用说的,长了会ANR的。

BackgroundThread:如果事件是在UI线程中发布出来的,那么事件处理就会在子线程中运行,如果事件本来就是子线程中发布出来的,那么事件处理直接在该子线程中执行。所有待处理事件会被加到一个队列中,由对应线程依次处理这些事件,如果某个事件处理时间太长,会阻塞后面的事件的派发或处理。

Async:事件处理会在单独的线程中执行,主要用于在后台线程中执行耗时操作,每个事件会开启一个线程。

2.priority事件优先级

事件的优先级类似广播的优先级,优先级越高优先获得消息。
用法展示:

  1. @Subscribe(priority = 100)
  2. public void onToastEvent(ToastEvent event){
  3. Toast.makeText(MainActivity.this,event.getContent(),Toast.LENGTH_SHORT).show();
  4. }

当多个订阅者(Subscriber)对同一种事件类型进行订阅时,即对应的事件处理方法中接收的事件类型一致,则优先级高(priority 设置的值越大),则会先接收事件进行处理;优先级低(priority 设置的值越小),则会后接收事件进行处理。

除此之外,EventBus也可以终止对事件继续传递的功能。
用法展示:

  1. @Subscribe(priority = 100)
  2. public void onToastEvent(ToastEvent event){
  3. Toast.makeText(MainActivity.this,event.getContent(),Toast.LENGTH_SHORT).show();
  4. EventBus.getDefault().cancelEventDelivery(event);
  5. }

这样其他优先级比100低,并且订阅了该事件的订阅者就会接收不到该事件。

3.EventBus黏性事件

EventBus除了普通事件也支持粘性事件。可以理解成:订阅在发布事件之后,但同样可以收到事件。订阅/解除订阅和普通事件一样,但是处理订阅的方法有所不同,需要注解中添加sticky = true。
用法展示:

  1. @Subscribe(priority = 100,sticky = true)
  2. public void onToastEvent(ToastEvent event){
  3. Toast.makeText(MainActivity.this,event.getContent(),Toast.LENGTH_SHORT).show();
  4. EventBus.getDefault().cancelEventDelivery(event);
  5. }

这样,假设一个ToastEvent 的事件已经发布,此时还没有注册订阅。当设置了sticky = true,在ToastEvent 的事件发布后,进行注册。依然能够接收到之前发布的事件。

不过这个时候,发布事件的方式就改变了。

  1. EventBus.getDefault().postSticky(new ToastEvent("Toast,发个提示,祝大家新年快乐!"));

我们如果不再需要该粘性事件我们可以移除

  1. EventBus.getDefault().removeStickyEvent(ToastEvent.class);

或者调用移除所有粘性事件

  1. EventBus.getDefault().removeAllStickyEvents();
4.EventBus配置

EventBus在2.3版本中添加了EventBuilder去配置EventBus的各方各面。

比如:如何去构建一个在发布事件时没有订阅者时保持沉默的EventBus。

  1. EventBus eventBus = EventBus.builder()
  2. .logNoSubscriberMessages(false)
  3. .sendNoSubscriberEvent(false)
  4. .build();

通过上述设置,当一个事件没有订阅者时,不会输出log信息,也不会发布一条默认信息。

配置默认的EventBus实例,使用EventBus.getDefault()是一个简单的方法。获取一个单例的EventBus实例。EventBusBuilder也允许使用installDefaultEventBus方法去配置默认的EventBus实例。

注意:不同的EventBus 的对象的数据是不共享的。通过一个EventBus 对象去发布事件,只有通过同一个EventBus 对象订阅事件,才能接收该事件。所以以上使用EventBus.getDefault()获得的都是同一个实例。

四、源码解析

注册订阅

  1. EventBus.getDefault().register(this);

事件处理

  1. @Subscribe(threadMode = ThreadMode.MainThread)
  2. public void onNewsEvent(NewsEvent event){
  3. String message = event.getMessage();
  4. mTv_message.setText(message);
  5. }

发布事件

  1. EventBus.getDefault().post(new NewsEvent("我是来自SecondActivity的消息,你好!"));

以上是EventBus的基本使用。我们先从getDefault说起。

getDefault()

  1. static volatile EventBus defaultInstance;
  2. public static EventBus getDefault() {
  3. if (defaultInstance == null) {
  4. synchronized (EventBus.class) {
  5. if (defaultInstance == null) {
  6. defaultInstance = new EventBus();
  7. }
  8. }
  9. }
  10. return defaultInstance;
  11. }

通过上述代码可以得知,getDefault()中通过双检查锁(DCL)机制实现了EventBus的单例机制,获得了一个默认配置的EventBus对象。
下面我们继续看register()方法。

register()

在了解register()之前,我们先要了解一下EventBus中的几个关键的成员变量。方便对下面内容的理解。

  1. /** Map<订阅事件, 订阅该事件的订阅者集合> */
  2. private final Map<Class<?>, CopyOnWriteArrayList<Subscription>> subscriptionsByEventType;
  3. /** Map<订阅者, 订阅事件集合> */
  4. private final Map<Object, List<Class<?>>> typesBySubscriber;
  5. /** Map<订阅事件类类型,订阅事件实例对象>. */
  6. private final Map<Class<?>, Object> stickyEvents;

下面看具体的register()中执行的代码。

  1. public void register(Object subscriber) {
  2. //订阅者类型
  3. Class<?> subscriberClass = subscriber.getClass();
  4. //判断该类是不是匿名类,如果是匿名累要使用反射
  5. boolean forceReflection = subscriberClass.isAnonymousClass();
  6. //获取订阅者全部的响应函数信息(即上面的onNewsEvent()之类的方法)
  7. List<SubscriberMethod> subscriberMethods =
  8. subscriberMethodFinder.findSubscriberMethods(subscriberClass, forceReflection);
  9. //循环每一个事件响应函数,执行 subscribe()方法,更新订阅相关信息
  10. for (SubscriberMethod subscriberMethod : subscriberMethods) {
  11. subscribe(subscriber, subscriberMethod);
  12. }
  13. }

由此可见,register()第一步获取订阅者的类类型. 第二步,通过SubscriberMethodFinder类来解析订阅者类,获取所有的响应函数集合. 第三步,遍历订阅函数,执行 subscribe()方法,更新订阅相关信息。
关于 subscriberMethodFinder这里就不介绍了。先跟着线索,继续看subscribe()方法。
subscribe 函数分三步。

第一步:

  1. //获取订阅的事件类型
  2. Class<?> eventType = subscriberMethod.eventType;
  3. //获取订阅该事件的订阅者集合
  4. CopyOnWriteArrayList<Subscription> subscriptions = subscriptionsByEventType.get(eventType);
  5. //把通过register()订阅的订阅者包装成Subscription 对象
  6. Subscription newSubscription = new Subscription(subscriber, subscriberMethod);
  7. //订阅者集合为空,创建新的集合,并把newSubscription 加入
  8. if (subscriptions == null) {
  9. subscriptions = new CopyOnWriteArrayList<Subscription>();
  10. subscriptionsByEventType.put(eventType, subscriptions);
  11. } else {
  12. //集合中已经有该订阅者,抛出异常。不能重复订阅
  13. if (subscriptions.contains(newSubscription)) {
  14. throw new EventBusException("Subscriber " + subscriber.getClass() + " already registered to event "
  15. + eventType);
  16. }
  17. }
  18. //把新的订阅者按照优先级加入到订阅者集合中。
  19. synchronized (subscriptions) {
  20. int size = subscriptions.size();
  21. for (int i = 0; i <= size; i++) {
  22. if (i == size || subscriberMethod.priority > subscriptions.get(i).subscriberMethod.priority) {
  23. subscriptions.add(i, newSubscription);
  24. break;
  25. }
  26. }
  27. }

第二步:

  1. //根据订阅者,获得该订阅者订阅的事件类型集合
  2. List<Class<?>> subscribedEvents = typesBySubscriber.get(subscriber);
  3. //如果事件类型集合为空,创建新的集合,并加入新订阅的事件类型。
  4. if (subscribedEvents == null) {
  5. subscribedEvents = new ArrayList<Class<?>>();
  6. typesBySubscriber.put(subscriber, subscribedEvents);
  7. }
  8. //如果事件类型集合不为空,加入新订阅的事件类型
  9. subscribedEvents.add(eventType);

第三步:

  1. //该事件是stick=true。
  2. if (subscriberMethod.sticky) {
  3. //响应订阅事件的父类事件
  4. if (eventInheritance) {
  5. Set<Map.Entry<Class<?>, Object>> entries = stickyEvents.entrySet();
  6. //循环获得每个stickyEvent事件
  7. for (Map.Entry<Class<?>, Object> entry : entries) {
  8. Class<?> candidateEventType = entry.getKey();
  9. //是该类的父类
  10. if (eventType.isAssignableFrom(candidateEventType)) {
  11. //该事件类型最新的事件发送给当前订阅者。
  12. Object stickyEvent = entry.getValue();
  13. checkPostStickyEventToSubscription(newSubscription, stickyEvent);
  14. }
  15. }
  16. } else {
  17. Object stickyEvent = stickyEvents.get(eventType);
  18. checkPostStickyEventToSubscription(newSubscription, stickyEvent);
  19. }
  20. }

由此可见,第一步:通过subscriptionsByEventType得到该事件类型所有订阅者信息队列,根据优先级将当前订阅者信息插入到订阅者队列subscriptionsByEventType中;

第二步:在typesBySubscriber中得到当前订阅者订阅的所有事件队列,将此事件保存到队列typesBySubscriber中,用于后续取消订阅;
第三步:检查这个事件是否是 Sticky 事件,如果是则从stickyEvents事件保存队列中取出该事件类型最后一个事件发送给当前订阅者。

到此,便完成了订阅功能。下面是订阅的具体流程图:

img

unregister()

  1. public synchronized void unregister(Object subscriber) {
  2. // 获取该订阅者所有的订阅事件类类型集合.
  3. List<Class<?>> subscribedTypes = typesBySubscriber.get(subscriber);
  4. if (subscribedTypes != null) {
  5. for (Class<?> eventType : subscribedTypes) {
  6. unsubscribeByEventType(subscriber, eventType);
  7. }
  8. // 从typesBySubscriber删除该<订阅者对象,订阅事件类类型集合>
  9. typesBySubscriber.remove(subscriber);
  10. } else {
  11. Log.e("EventBus", "Subscriber to unregister was not registered before: "
  12. + subscriber.getClass());
  13. }
  14. }
  1. private void unsubscribeByEventType(Object subscriber, Class<?> eventType) {
  2. // 获取订阅事件对应的订阅者信息集合.
  3. List<Subscription> subscriptions = subscriptionsByEventType.get(eventType);
  4. if (subscriptions != null) {
  5. int size = subscriptions.size();
  6. for (int i = 0; i < size; i ++) {
  7. Subscription subscription = subscriptions.get(i);
  8. // 从订阅者集合中删除特定的订阅者.
  9. if (subscription.subscriber == subscriber) {
  10. subscription.active = false;
  11. subscriptions.remove(i);
  12. i --;
  13. size --;
  14. }
  15. }
  16. }
  17. }

unregister()方法比较简单,主要完成了subscriptionsByEventType以及typesBySubscriber两个集合的同步。

post()

  1. public void post(Object event) {
  2. // 获取当前线程的Posting状态.
  3. PostingThreadState postingState = currentPostingThreadState.get();
  4. // 获取当前线程的事件队列.
  5. List<Object> eventQueue = postingState.eventQueue;
  6. //将当前事件添加到其事件队列
  7. eventQueue.add(event);
  8. //判断新加入的事件是否在分发中
  9. if (!postingState.isPosting) {
  10. postingState.isMainThread = Looper.getMainLooper() == Looper.myLooper();
  11. postingState.isPosting = true;
  12. if (postingState.canceled) {
  13. throw new EventBusException("Internal error. Abort state was not reset");
  14. }
  15. try {
  16. // 循环处理当前线程eventQueue中的每一个event对象.
  17. while (!eventQueue.isEmpty()) {
  18. postSingleEvent(eventQueue.remove(0), postingState);
  19. }
  20. } finally {
  21. // 处理完知乎重置postingState一些标识信息.
  22. postingState.isPosting = false;
  23. postingState.isMainThread = false;
  24. }
  25. }
  26. }

post 函数会首先得到当前线程的 post 信息PostingThreadState,其中包含事件队列,将当前事件添加到其事件队列中,然后循环调用 postSingleEvent 函数发布队列中的每个事件。

  1. private void postSingleEvent(Object event, PostingThreadState postingState) {
  2. //分发事件的类型
  3. Class<?> eventClass = event.getClass();
  4. boolean subscriptionFound = false;
  5. //响应订阅事件的父类事件
  6. if (eventInheritance) {
  7. //找出当前订阅事件类类型eventClass的所有父类的类类型和其实现的接口的类类型
  8. List<Class<?>> eventTypes = lookupAllEventTypes(eventClass);
  9. int countTypes = eventTypes.size();
  10. for (int h = 0; h < countTypes; h ++) {
  11. Class<?> clazz = eventTypes.get(h);
  12. //发布每个事件到每个订阅者
  13. subscriptionFound |= postSingleEventForEventType(event, postingState, clazz);
  14. }
  15. } else {
  16. subscriptionFound = postSingleEventForEventType(event, postingState, eventClass);
  17. }
  18. ....................................
  19. }

调用 postSingleEventForEventType 函数发布每个事件到每个订阅者。

  1. private boolean postSingleEventForEventType(Object event, PostingThreadState postingState,
  2. Class<?> eventClass) {
  3. CopyOnWriteArrayList<Subscription> subscriptions;
  4. synchronized (this) {
  5. // 获取订阅事件类类型对应的订阅者信息集合.(register函数时构造的集合)
  6. subscriptions = subscriptionsByEventType.get(eventClass);
  7. }
  8. if (subscriptions != null && !subscriptions.isEmpty()) {
  9. for (Subscription subscription : subscriptions) {
  10. postingState.event = event;
  11. postingState.subscription = subscription;
  12. boolean aborted = false;
  13. try {
  14. // 发布订阅事件给订阅函数
  15. postToSubscription(subscription, event, postingState.isMainThread);
  16. aborted = postingState.canceled;
  17. } finally {
  18. postingState.event = null;
  19. postingState.subscription = null;
  20. postingState.canceled = false;
  21. }
  22. if (aborted) {
  23. break;
  24. }
  25. }
  26. return true;
  27. }
  28. return false;
  29. }

调用 postToSubscription 函数向每个订阅者发布事件。
postToSubscription 函数中会判断订阅者的 ThreadMode,从而决定在什么 Mode 下执行事件响应函数。这里就不贴源码了。后续还牵着到反射以及线程调度问题,这里就不展开了。
以上就是post的流程,下面是具体的post的流程图。

img