EventBus1.0.1源码解析

EventBus源码解析

很久没有更新过源码解析类文章，以下内容作为源码分析类的笔记。分析方法适用于其它源码分析。

分析工具说明

许久以来，阅读源代码最得力的工具就非Source Insight莫属了。然，后来微软出了一款轻量级但功能强大的IDE就没Source Insight什么事了。微软的这款IDE就是大名鼎鼎的VSCODE，全名叫：Visual Studio Code。它的强大之处这里就不过多描述了。我们转回到正题。

获取源码并导入IDE

我们在Github.com上搜索到EventBus的项目地址，然后进行克隆即可。

    git clone https://github.com/greenrobot/EventBus.git

克隆完成之后，导入IDE。打开VS CODE，在菜单栏中选择File -> Open，选择克隆后文件所在的目录，然后点击确认。这就完成了代码导入工作。

由于我们只是分析EventBus的骨架脉络，所以我们要选择EventBus的早期版本。这里我们将要选择V1.0.1版。这同样适用于Android源代码分析，适宜选择1.5版或1.6版。

切换版本的步骤为：先进入EventBus刚才的克隆目录，然后执行以下步骤：

    //列出EventBus项目的所有tag。
    sahadevs-MacBook-Pro:EventBus sahadev$ git tag
    V1.0.1
    V2.2.0
    V2.3.0
    V2.4.0
    V3.0.0
    //上面可以看出EventBus共发布了5个版本。我们切换到V1.0.1版。
    sahadevs-MacBook-Pro:EventBus sahadev$ git checkout V1.0.1

经过以上步骤，我们的代码就切换到了V1.0.1版本。VS CODE中的内容也会同步更新。接下来开始我们的代码分析。

事件监听注册

我们熟知EventBus的用法，其中最有代表性的入口为：

     EventBus.getDefault().register(this);

为了方便分析，上面这行代码放在Activity中执行。所以上面的this就是Activity的实例。EventBus采用了单例模式，在这个版本中，采用了最简便的实现方式：

public class EventBus {
    private static final EventBus defaultInstance = new EventBus();

    public static EventBus getDefault() {
        return defaultInstance;
    }
}

好，以上并不是我们的重点。我们要从register方法说起。

    public void register(Object subscriber) {
        register(subscriber, defaultMethodName, ThreadMode.PostThread);
    }

    public void register(Object subscriber, String methodName, ThreadMode threadMode) {
        List subscriberMethods = findSubscriberMethods(subscriber.getClass(), methodName);
        for (Method method : subscriberMethods) {
            Class eventType = method.getParameterTypes()[0];
            subscribe(subscriber, method, eventType, threadMode);
        }
    }

register(this)方法执行时调用了register(Object subscriber, String methodName, ThreadMode threadMode)，subscriber是Activity，methodName采用了defaultMethodName的值，这个值在EventBus中定义为：'onEvent'，threadMode为ThreadMode.PostThread。其中ThreadMode为一个枚举，它有两个值：

    public enum ThreadMode {
        /** Subscriber will be called in the same thread, which is posting the event. */
        PostThread,
        /** Subscriber will be called in Android's main thread (sometimes referred to as UI thread). */
        MainThread,
        /* BackgroundThread */
    }

PostThread用于标识发送线程，MainThread用于标识主线程。它们在后期执行的区别为：如果在注册时为PostThread，则事件发送后，会直接调起监听方法。而如果注册时为MainThread，则会经过主线程的消息队列调起。

好，回到刚才的地方，在register(Object subscriber, String methodName, ThreadMode threadMode)方法内先执行了findSubscriberMethods，我们移步看看这个方法内执行了什么工作：

    private List findSubscriberMethods(Class subscriberClass, String methodName) {
        ...
        List subscriberMethods;
        ...
        subscriberMethods = new ArrayList();
        Class clazz = subscriberClass;
        HashSet> eventTypesFound = new HashSet>();
        while (clazz != null) {
            String name = clazz.getName();
            ...
            Method[] methods = clazz.getDeclaredMethods();
            for (Method method : methods) {
                if (method.getName().equals(methodName)) {
                    Class[] parameterTypes = method.getParameterTypes();
                    if (parameterTypes.length == 1) {
                        if (eventTypesFound.add(parameterTypes[0])) {
                            // Only add if not already found in a sub class
                            subscriberMethods.add(method);
                        }
                    }
                }
            }
            clazz = clazz.getSuperclass();
        }
        ...
    }

这里面的代码比较长，将不必要的略去。这段代码主要做了以下工作：

根据给定的类，遍历该类及其父类所有的方法，如果遍历时发现与给定的方法名相等，并且该方法的参数只有一个，那么就将该方法加入到subscriberMethods中，最后返回。这里被找到的方法是同名的，但是参数类型不同，这里的参数类型决定了将来要监听的事件类型。

好，我们回到findSubscriberMethods之前被调用的地方，继续往下走。接下来的动作是将findSubscriberMethods方法返回的Method列表进行遍历。而这次遍历时，将Method的第一个参数类型作为参数传给了subscribe方法：

    private void subscribe(Object subscriber, Method subscriberMethod, Class eventType, ThreadMode threadMode) {
        CopyOnWriteArrayList subscriptions = subscriptionsByEventType.get(eventType);
        if (subscriptions == null) {
            subscriptions = new CopyOnWriteArrayList();
            subscriptionsByEventType.put(eventType, subscriptions);
        } 
        ...
        subscriberMethod.setAccessible(true);
        Subscription subscription = new Subscription(subscriber, subscriberMethod, threadMode);
        subscriptions.add(subscription);
        ...
    }

该方法首先做的就是根据eventType从subscriptionsByEventType对象中取出对应的subscriptions，然这里第一次肯定是null。所以先进行实例化，然后存放于subscriptionsByEventType中。而subscriptionsByEventType对象存放的就是根据eventType所对应的subscriptions。而subscriptions中存放的就是所有的观察者，待会有时间发生时，根据事件的类型，从subscriptionsByEventType中取出所有的观察者subscriptions逐一通知。

在创建了观察者列表subscriptions之后开始创建具体的观察者。Subscription是一个基本的类，它的示例只是持有了subscriber(Activity)，subscriberMethod(onEvent)，threadMode(ThreadMode.PostThread)三者的引用而已。

到这里，观察者Activity监听某一事件的注册工作就算完成了。

事件发送

接下来，我们将从事件发送入口post方法开始分析：

    public void post(Object event) {
        //这里的两个属性很重要，下面这个用于缓存事件，待下次事件执行时，一并执行。
        List