Android消息传递之EventBus 3.0使用详解

时间 2019-11-16

标签 android 消息传递 eventbus 3.0 使用详解栏目 Android 繁體版

原文原文链接

前言：

前面两篇不只学习了子线程与UI主线程之间的通讯方式，也学习了如何实现组件之间通讯，基于前面的知识咱们今天来分析一下EventBus是如何管理事件总线的，EventBus究竟是不是最佳方案？学习本篇知识以前建议先回顾一下前两篇知识：Android消息传递之Handler消息机制（一），Android消息传递之组件间传递消息（二）。html

消息传递相关文章地址：java

EventBus产生需求背景：

在作项目的时候每每须要应用程序内各组件间、组件与后台线程间的通讯。好比耗时操做，等耗时操做完成后经过Handler或Broadcast将结果通知给UI，N个Activity之间须要经过Listener通讯，以前的实现方式咱们在Android消息传递之组件间传递消息（二）中已经介绍过了，其实这些均可以经过EventBus轻松实现，EventBus经过发布/订阅(publish/subscribe)方式来管理事件总线。其实EventBus的实现方式更加接近上篇文章的方式二，不一样的是EventBus经过注解和反射机制将订阅者连同订阅函数保存起来，而后在发送订阅的时候遍历订阅函数数组进行调用，其实从这方面就能够EventBus执行效率多少会受到一点影响。android

EventBus介绍:

EventBus出自greenrobot，和以前大名鼎鼎的GreenDao出自同一家。以前一直使用的是2.4版本，今天咱们将学习分析最新的Event 3.0，EventBus 3.0 最新的特性就是加入了注解，经过注解的方式告知订阅函数运行在哪一个线程中。git

github地址：https://github.com/greenrobot/EventBusgithub

官方文档：http://greenrobot.org/eventbus/documentation数组

EventBus主要角色:

Event 传递的事件对象
Subscriber 事件的订阅者
Publisher 事件的发布者
ThreadMode 定义函数在何种线程中执行

官网给出的各类角色的协做图app

EventBus配置:

EventBus框架也是采用建造者模式设计的，能够经过EventBusBuilder来设置一些配置信息，例如设置debug模式下要抛出异常框架

EventBus eventBus=EventBus.builder().throwSubscriberException(BuildConfig.DEBUG).build();

EventBus示例:

以前作图片社交App的时候，须要处理一个点赞数据的同步，好比在做品的详情页点赞须要同时更新列表页该做品的点赞数量，这里仍是以此为例。异步

1.）build.gradle添加引用

compile 'org.greenrobot:eventbus:3.0.0'

2.）定义一个事件类型

public class DataSynEvent {
    private int count;

    public int getCount() {
        return count;
    }

    public void setCount(int count) {
        this.count = count;
    }
}

3.）订阅/解除订阅

订阅ide

EventBus.getDefault().register(this);//订阅

解除订阅

EventBus.getDefault().unregister(this);//解除订阅

4.）发布事件

EventBus.getDefault().post(new DataSynEvent());

5.）订阅事件处理

    @Subscribe(threadMode = ThreadMode.MAIN) //在ui线程执行
    public void onDataSynEvent(DataSynEvent event) {
        Log.e(TAG, "event---->" + event.getCount());
    }

ThreadMode总共四个：

NAIN UI主线程
BACKGROUND 后台线程
POSTING 和发布者处在同一个线程
ASYNC 异步线程

6.）订阅事件的优先级

事件的优先级相似广播的优先级，优先级越高优先得到消息

  @Subscribe(threadMode = ThreadMode.MAIN,priority = 100) //在ui线程执行 优先级100
    public void onDataSynEvent(DataSynEvent event) {
        Log.e(TAG, "event---->" + event.getCount());
    }

7.）终止事件往下传递

发送有序广播能够终止广播的继续往下传递，EventBus也实现了此功能

  EventBus.getDefault().cancelEventDelivery(event) ;//优先级高的订阅者能够终止事件往下传递

8.）处理代码混淆

-keepattributes *Annotation*
-keepclassmembers class ** {
    @org.greenrobot.eventbus.Subscribe <methods>;
}
-keep enum org.greenrobot.eventbus.ThreadMode { *; }

# Only required if you use AsyncExecutor
-keepclassmembers class * extends org.greenrobot.eventbus.util.ThrowableFailureEvent {
    <init>(java.lang.Throwable);
}

EventBus黏性事件

EventBus除了普通事件也支持粘性事件，这个有点相似广播分类中的粘性广播。自己粘性广播用的就比较少，为了方便理解成订阅在发布事件以后，但一样能够收到事件。订阅/解除订阅和普通事件同样，可是处理订阅函数有所不一样，须要注解中添加sticky = true

  @Subscribe(threadMode = ThreadMode.MAIN,sticky = true) //在ui线程执行
    public void onDataSynEvent(DataSynEvent event) {
        Log.e(TAG, "event---->" + event.getCount());
    }

发送粘性事件

  EventBus.getDefault().postSticky(new DataSynEvent());

对于粘性广播咱们都比较清楚属于常驻广播，对于EventBus粘性事件也相似，咱们若是再也不须要该粘性事件咱们能够移除

  EventBus.getDefault().removeStickyEvent(new DataSynEvent());

或者调用移除全部粘性事件

  EventBus.getDefault().removeAllStickyEvents();

EventBus processor使用：

EventBus提供了一个EventBusAnnotationProcessor注解处理器来在编译期经过读取@Subscribe()注解并解析,
处理其中所包含的信息,而后生成java类来保存全部订阅者关于订阅的信息,这样就比在运行时使用反射来得到这些订阅者的
信息速度要快.

1.)具体使用：在build.gradle中添加以下配置

buildscript {
    dependencies {
        classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'
    }
}
apply plugin: 'com.neenbedankt.android-apt'

dependencies {
    compile 'org.greenrobot:eventbus:3.0.0'
    apt 'org.greenrobot:eventbus-annotation-processor:3.0.1'
}
apt {
    arguments {
        eventBusIndex "com.whoislcj.eventbus.MyEventBusIndex"
    }
}

2.)使用索引

此时编译一次，自动生成生成索引类。在\build\generated\source\apt\PakageName\下看到经过注解分析生成的索引类，这样咱们即可以在初始化EventBus时应用咱们生成的索引了。

自动生成的代码

/** This class is generated by EventBus, do not edit. */
public class MyEventBusIndex implements SubscriberInfoIndex {
    private static final Map<Class<?>, SubscriberInfo> SUBSCRIBER_INDEX;

    static {
        SUBSCRIBER_INDEX = new HashMap<Class<?>, SubscriberInfo>();

        putIndex(new SimpleSubscriberInfo(com.whoislcj.testhttp.MainActivity.class, true, new SubscriberMethodInfo[] {
            new SubscriberMethodInfo("onDataSynEvent", com.whoislcj.testhttp.eventBus.DataSynEvent.class,
                    ThreadMode.MAIN, 100, false),
            new SubscriberMethodInfo("onDataSynEvent1", com.whoislcj.testhttp.eventBus.TestEvent.class, ThreadMode.MAIN,
                    0, true),
        }));

    }

    private static void putIndex(SubscriberInfo info) {
        SUBSCRIBER_INDEX.put(info.getSubscriberClass(), info);
    }

    @Override
    public SubscriberInfo getSubscriberInfo(Class<?> subscriberClass) {
        SubscriberInfo info = SUBSCRIBER_INDEX.get(subscriberClass);
        if (info != null) {
            return info;
        } else {
            return null;
        }
    }
}

添加索引到EventBus默认的单例中

EventBus.builder().addIndex(new MyEventBusIndex()).installDefaultEventBus();

3.）对比添加先后注册效率对比

分别EventBus.getDefault().register(this);

添加以前：先后用了9毫秒

添加以后：先后用了2毫秒

EventBus优缺点：

优势：简化组件之间的通讯方式，实现解耦让业务代码更加简洁，能够动态设置事件处理线程以及优先级

缺点：目前发现惟一的缺点就是相似以前策略模式同样的诟病，每一个事件都必须自定义一个事件类，形成事件类太多，无形中加大了维护成本

EventBus 3.0 与2.x的区别

1.）代码更加简洁

EventBus 2.x 必须定义以onEvent开头的几个方法，代码中语境比较突兀，且有可能会致使拼写错误，例如数据同步事件

    public void onEvent(DataSynEvent event) {
        //事件在哪一个线程发布出来的，onEvent就会在这个线程中运行， 同 @Subscribe(threadMode = ThreadMode.POSTING）
    }

    public void onEventMainThread(DataSynEvent event) {
        // 不论事件是在哪一个线程中发布出来的，onEventMainThread都会在UI线程中执行，接收事件就会在UI线程中运行，同 @Subscribe(threadMode = ThreadMode.MAIN）
    }

    public void onEventBackgroundThread(DataSynEvent event) {
        //那么若是事件是在UI线程中发布出来的，那么onEventBackground就会在子线程中运行，若是事件原本就是子线程中发布出来的，那么onEventBackground函数直接在该子线程中执行,同 @Subscribe(threadMode = ThreadMode.BACKGROUND）
    }


    public void onEventAsync(DataSynEvent event) {
        //使用这个函数做为订阅函数，那么不管事件在哪一个线程发布，都会建立新的子线程在执行onEventAsync，同 @Subscribe(threadMode = ThreadMode.ASYNC）
    }

EventBus 3.0 函数名字再也不受到权限，并且能够在一个函数中体现出在哪一个线程执行，而且可指定接收事件的优先级

 /**
     * 普通事件
     * @param event
     */
    @Subscribe(threadMode = ThreadMode.MAIN, priority = 100) 
    public void onDataSynEvent(DataSynEvent event) {
       
    }

    /**
     * 粘性事件
     * @param event
     */
    @Subscribe(threadMode = ThreadMode.MAIN, priority = 100, sticky = true) 
    public void onDataSynEvent(DataSynEvent event) {
       
    }

EventBus 2.x 注册方式也比较繁琐

　 public void register(Object subscriber) {
　　register(subscriber, false, 0);
　　}
　　
　　public void register(Object subscriber, int priority) {
　　register(subscriber, false, priority);
　　}
　　
　　public void registerSticky(Object subscriber) {
　　register(subscriber, true, 0);
　　}
　　
　　public void registerSticky(Object subscriber, int priority) {
　　register(subscriber, true, priority);
　　}
　　private void subscribe(Object subscriber, SubscriberMethod subscriberMethod, boolean sticky, int priority) {
　　...
　　}

EventBus 3.0 注册方式只有一个

    public void register(Object subscriber) {
        Class<?> subscriberClass = subscriber.getClass();
        List<SubscriberMethod> subscriberMethods = subscriberMethodFinder.findSubscriberMethods(subscriberClass);
        synchronized (this) {
            for (SubscriberMethod subscriberMethod : subscriberMethods) {
                subscribe(subscriber, subscriberMethod);
            }
        }
    }

以上仍是在一个订阅者仅仅订阅一个事件的状况下，若是订阅多个事件，可想而知EventBus 2.x势必致使订阅者要写大量的多态函数，若是订阅多种类型事件，好比普通事件和粘性事件并存，估计要同时调用register，registerSticky两个函数。

2.）性能更优

EventBus 2.x 是采用反射的方式对整个注册的类的全部方法进行扫描来完成注册，固然会有性能上的影响。EventBus 3.0中EventBus提供了EventBusAnnotationProcessor注解处理器来在编译期经过读取@Subscribe()注解并解析、处理其中所包含的信息，而后生成java类来保存全部订阅者关于订阅的信息，这样就比在运行时使用反射来得到这些订阅者的信息速度要快

小结：

EventBus 3.0的使用基本上总结完了，以前一直担忧EventBus经过注解或者反射会影响太多性能，随着3.0的发布这部分影响已经很小了。