EventBus3.0——基本使用

EventBus3.0——基本使用

EventBus在线程间通信有着明显的优势，普及度也非常的高，特别是升级到3.0后，使用起来更加方便、简洁，性能也得到了很好优化，并且加入了注解，其使用方式相对以前有了很大的变动，今天我就带大家来学习一下EventBus3.0的基本使用。这里针对的是以前有使用过EventBus的朋友，框架原理就不过多解释了，只贴重要部分源码。基本概念不多说，我这里以fragment之间通信为例，先上效果图：

左边为fragment1、右边为fragment2，使用方法如下：

第一步、注册观察者（订阅者）：

1、注册（唯一注册方法）

 @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        EventBus.getDefault().register(this);
        super.onCreate(savedInstanceState);
    }

2、解除注册

@Override
    public void onDestroyView() {
        EventBus.getDefault().unregister(this);
        super.onDestroyView();
    }

注：EventBus.getDefault()的作用是为了获取单例默认实例，register的作用是为了通过反射或者索引方式获取当前类中的注解方法，并存到Map集合中，以便post的时候使用,unregister则是释放Map集合中的缓存。

第二步、创建观察者（订阅者）：

一共有四种创建观察者的方法（3.0以前版本，方法名必须如下）：

onEvent:发布事件和接收事件在同一线程，不能做耗时操作，容易导致事件分发延迟。
onEventMainThread:不论事件在哪个线程中发布，接收事件只在UI线程中执行，也是最常用的订阅函数，不能做耗时操作。
onEventBackground:不论事件在哪个线程中发布，接收事件只在子线程中执行，如果事件是在子线程中发布，则接收事件直接在该子线程中执行。
onEventAsync：无论事件在哪个线程发布，都会创建新的子线程在执行onEventAsync。

相信用过EventBus的朋友对这四种观察者方法都非常熟悉，但遗憾了是到了3.0的版本他们就退休了，因为引进了注解@Subscribe，我们通过源码来看一下，这个注解是怎么定义的：

public @interface Subscribe {
    ThreadMode threadMode() default ThreadMode.POSTING;
    /**
     * If true, delivers the most recent sticky event (posted with
     * {@link EventBus#postSticky(Object)}) to this subscriber (if event available).
     */
    boolean sticky() default false;

    /** Subscriber priority to influence the order of event delivery.
     * Within the same delivery thread ({@link ThreadMode}), higher priority subscribers will receive events before
     * others with a lower priority. The default priority is 0. Note: the priority does *NOT* affect the order of
     * delivery among subscribers with different {@link ThreadMode}s! */
    int priority() default 0;
}

一共有三个成员变量：threadMode——线程模式（默认为ThreadMode.POSTING），sticky()——是否具备粘性，priority——优先级，相信这几个变量大家不陌生吧，3.0以前的注册函数传参是不是也有类似的参数，而且有了注解，我们在创建观察者的时候方法名也没有限制了。
那么3.0如何创建观察者呢，3.0版本通过注解描述观察者的信息，更加清晰直观的看到每个方法的线程模式、是否接受粘性消息、优先级，创建方式如下：

 @Subscribe(threadMode = ThreadMode.POSTING,priority = 1)
    public void pdmEvent(Student student) {
        if (student != null)
            tvContent.setText("onEvent " +student.getContent());
        Log.e(TAG,"onEvent: " + Thread.currentThread().getName());
    }
    @Subscribe(threadMode = ThreadMode.MAIN,priority = 2,sticky = true)
    public void pdmEventMainThread(Student student) {
        if (student != null)
            tvContent1.setText( "onEventMainThread " + student.getContent());
        Log.e(TAG,"onEventMainThread: " + student.getContent());
    }
    @Subscribe(threadMode = ThreadMode.BACKGROUND,priority = 3)
    public void pdmEventBackground(Student student) {
        Log.e(TAG,"onEventBackground: " + Thread.currentThread().getName());
    }
    @Subscribe(threadMode = ThreadMode.ASYNC,priority = 4)
    public void pdmEventAsync(Student student) {
        Log.e(TAG,"onEventAsync: " + Thread.currentThread().getName());
    }

这里源码是通过获取方法的注解来判断哪些函数是EventBus所需要的观察者方法，通过注解变量threadMode的值判断观察者的线程模式，不再需要根据方法名来判断了。源码用一个枚举来定义ThreadMode，跟原来的四种观察者函数一一对应，这样我们就不需要死死的记着那几个函数名了：

public enum ThreadMode {
    POSTING,
    MAIN,
    BACKGROUND,
    ASYNC
}

我们来看一下源码是怎么通过注解Subscribe中的属性值来决定观察者执行的线程：

 private void postToSubscription(Subscription subscription, Object event, boolean isMainThread) {
        switch (subscription.subscriberMethod.threadMode) {//注解Subscribe的ThreadMode属性
            case POSTING://当前线程
                invokeSubscriber(subscription, event);
                break;
            case MAIN://主线程
                if (isMainThread) {
                    invokeSubscriber(subscription, event);
                } else {
                    mainThreadPoster.enqueue(subscription, event);
                }
                break;
            case BACKGROUND://子线程
                if (isMainThread) {
                    backgroundPoster.enqueue(subscription, event);
                } else {
                    invokeSubscriber(subscription, event);
                }
                break;
            case ASYNC://新开子线程
                asyncPoster.enqueue(subscription, event);
                break;
            default:
                throw new IllegalStateException("Unknown thread mode: " + subscription.subscriberMethod.threadMode);
        }
    }

第三步、发布事件（fragment2）:

@Override
    public void onListItemClick(ListView listView, View view, final int position,
                                long id) {
//        new Thread(new Runnable() {
//            @Override
//            public void run() {
                EventBus.getDefault().post(getListView().getItemAtPosition(position));
                Log.e(TAG, "run: " + Thread.currentThread().getName());
//            }
//        }).start();
        super.onListItemClick(listView, view, position, id);
    }

到了这里，EventBus的基本使用就讲完，最后我们来验证下threadMode中的四个枚举值的设置，是不是跟以前版本的四种观察者方法能够一一对应，下面看日志打印信息：

明显符合，其他都没有异议，一个萝卜一个坑，但是threadMode = ThreadMode.PSTING是否跟发布事件所在线程一样，对应以前版本的onEvent方法，还有待确定，这里只能看出它在主线程运行，那么我们再将发布事件放到子线程中，来做进一步验证：

@Override
    public void onListItemClick(ListView listView, View view, final int position,
                                long id) {
        new Thread(new Runnable() {
            @Override
            public void run() {
                EventBus.getDefault().post(getListView().getItemAtPosition(position));
                Log.e(TAG, "run: " + Thread.currentThread().getName());
            }
        }).start();
        super.onListItemClick(listView, view, position, id);
    }

默认模式的观察者也要记得修改，因为它所在线程跟发布事件线程是一样的，记得注释掉UI操作部分：

 @Subscribe(threadMode = ThreadMode.POSTING,priority = 1)
    public void pdmEvent(Student student) {
//        if (student != null)
//            tvContent.setText("onEvent " +student.getContent());
        Log.e(TAG,"onEvent: " + Thread.currentThread().getName());
    }

再看打印日志：

发布事件的当前线程是Thread-146，threadMode = ThreadMode.PSTING所在方法线程也是Thread-146，到了这里最后一点疑虑也解决了，ThreadMode四个枚举值分别对应了以前版本的四种观察者方法。

下一章我会就EventBus注解（ @Subscribe ）中stick和priority的使用做讲解。（有时间也会专门针对3.0的源码做一下阐述）

最后给没用过EventBus的朋友提供一个小demo参考：http://download.csdn.net/detail/aiyh0202/9662495