美文网首页EventBus全解析系列
EventBus全解析系列(三)

EventBus全解析系列(三)

作者: 嘎啦果安卓兽 | 来源:发表于2017-03-30 19:53 被阅读181次

    EventBus 事件分发源码分析

    承接上篇我们讲了EventBus的注册和反注册,本篇我们来讲解EventBus的事件分发,即post一个事件之后怎么传达到对应的订阅者的。先简单的描述下大体过程:
    从EventBus的总线LIst中找出订阅了这个event的方法Subscription,然后根据Subscription中的method指定的不同线程信息,将这个方法放置在相应线程中调用。

    Post 源码分析

    一步一步进行源码解析,先从入口post方法看起:

    private final ThreadLocal<PostingThreadState> currentPostingThreadState = new ThreadLocal<PostingThreadState>() {
        @Override
        protected PostingThreadState initialValue() {
            return new PostingThreadState();
        }
    };
    /** Posts the given event to the event bus. */
    public void post(Object event) {
        //currentPostingThreadState是一个ThreadLocal,他的特点是获取当前线程一份独有的变量数据,不受其他线程影响。
        PostingThreadState postingState = currentPostingThreadState.get();
        //postingState就是获取到的线程独有的变量数据 
        List<Object> eventQueue = postingState.eventQueue;
        //把post的事件添加到事件队列
        eventQueue.add(event);
        // 如果没有处在事件发布状态,那么开始发送事件并一直保持发布状态
        if (!postingState.isPosting) {
            postingState.isMainThread = Looper.getMainLooper() == Looper.myLooper();
            postingState.isPosting = true;
            if (postingState.canceled) {
                throw new EventBusException("Internal error. Abort state was not reset");
            }
            try {
                while (!eventQueue.isEmpty()) {
                    postSingleEvent(eventQueue.remove(0), postingState);
                }
            } finally {
                postingState.isPosting = false;
                postingState.isMainThread = false;
            }
        }
    }
    
    /** For ThreadLocal, much faster to set (and get multiple values). */
    final static class PostingThreadState {
        //事件队列
        final List<Object> eventQueue = new ArrayList<Object>();
        boolean isPosting;
        boolean isMainThread;
        Subscription subscription;
        Object event;
        boolean canceled;
    }
    

    在 post方法中,大致流程为 :

    • 首先根据 currentPostingThreadState 获取当前线程状态 postingState 。currentPostingThreadState 其实就是一个 ThreadLocal 类的对象,不同的线程根据自己独有的索引值可以得到相应属于自己的 postingState 数据。
    • 然后把事件 event 加入到 eventQueue 队列中排队。
    • 循环遍历 eventQueue ,取出事件发送事件。发送单个事件是调用 postSingleEvent(Object event, PostingThreadState postingState) 方法。

    我们跟进去看postSingleEvent方法源码:

    private void postSingleEvent(Object event, PostingThreadState postingState) throws Error {
        // 得到事件的类型
        Class<?> eventClass = event.getClass();
        // 是否找到订阅者
        boolean subscriptionFound = false;
        // 如果支持事件继承,默认为支持
        if (eventInheritance) {
            // 查找 eventClass 的所有父类和接口
            List<Class<?>> eventTypes = lookupAllEventTypes(eventClass);
            int countTypes = eventTypes.size();
            for (int h = 0; h < countTypes; h++) {
                Class<?> clazz = eventTypes.get(h);
                // 依次向 eventClass 的父类或接口的订阅方法发送事件
                // 只要有一个事件发送成功,返回 true ,那么 subscriptionFound 就为 true
                subscriptionFound |= postSingleEventForEventType(event, postingState, clazz);
            }
        } else {
            // 发送事件
            subscriptionFound = postSingleEventForEventType(event, postingState, eventClass);
        }
        // 如果没有订阅者
        if (!subscriptionFound) {
            if (logNoSubscriberMessages) {
                Log.d(TAG, "No subscribers registered for event " + eventClass);
            }
            if (sendNoSubscriberEvent && eventClass != NoSubscriberEvent.class &&
                    eventClass != SubscriberExceptionEvent.class) {
                // 发送 NoSubscriberEvent 事件,可以自定义接收
                post(new NoSubscriberEvent(this, event));
            }
        }
    }
    

    在postSingleEvent方法中,事件发送根据 eventInheritance 分成两种,大致流程为:

    • eventInheritance 默认为true,支持事件继承:得到 eventClass 的所有父类和接口,然后循环依次发送事件;
    • eventInheritance 默认为false,不支持事件继承:直接发送eventClass 事件。
    • 若找不到订阅者,默认会发送 NoSubscriberEvent 事件。开发者可以自定义订阅方法接收这个事件。

    关于事件发送的具体操作进一步到 postSingleEventForEventType方法中去看:

    private boolean postSingleEventForEventType(Object event, PostingThreadState postingState, Class<?> eventClass) {
        CopyOnWriteArrayList<Subscription> subscriptions;
        synchronized (this) {
            // 得到订阅者
            subscriptions = subscriptionsByEventType.get(eventClass);
        }
        if (subscriptions != null && !subscriptions.isEmpty()) {
            // 依次遍历订阅者
            for (Subscription subscription : subscriptions) {
                postingState.event = event;
                postingState.subscription = subscription;
                boolean aborted = false;
                try {
                    // 发送事件
                    postToSubscription(subscription, event, postingState.isMainThread);
                    // 是否被取消了
                    aborted = postingState.canceled;
                } finally {
                    postingState.event = null;
                    postingState.subscription = null;
                    postingState.canceled = false;
                }
                // 如果被取消,则跳出循环
                if (aborted) {
                    break;
                }
            }
            return true;
        }
        return false;
    }
    

    postSingleEventForEventType方法主要做的事情:

    • 从订阅者注册列表中取出eventClass事件对应的订阅者列表,
    • 遍历了订阅者,然后依次调用 postToSubscription 方法发送事件。

    具体的事件发送操作又到了postToSubscription 方法中。

    private void postToSubscription(Subscription subscription, Object event, boolean isMainThread) {
        // 根据不同的线程模式执行对应
        switch (subscription.subscriberMethod.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);
        }
    }
    
    void invokeSubscriber(Subscription subscription, Object event) {
        try {
            // 通过反射执行订阅方法
            subscription.subscriberMethod.method.invoke(subscription.subscriber, event);
        } catch (InvocationTargetException e) {
            handleSubscriberException(subscription, event, e.getCause());
        } catch (IllegalAccessException e) {
            throw new IllegalStateException("Unexpected exception", e);
        }
    }
    

    postToSubscription 方法中,根据 threadMode 不同将事件按发送线程模式 共分为四种:

    • (POSTING)同一个线程:表示订阅方法所处的线程和发布事件的线程是同一个线程;
    • (MAIN)主线程:如果发布事件的线程是主线程,那么直接执行订阅方法;否则利用 Handler 回调主线程来执行;
    • (BACKGROUND)子线程:如果发布事件的线程是主线程,那么调用线程池中的子线程来执行订阅方法;否则直接执行;
    • (ASYNC)异步线程:无论发布事件执行在主线程还是子线程,都利用一个异步线程来执行订阅方法。
      这四种线程模式其实最后都会调用 invokeSubscriber(Subscription subscription, Object event) 方法通过反射来调用注册的方法,从而实现了将事件event发送的了对应的注册者方法里处理。

    至此,整个 EventBus 发布的源码解析就讲完了。整个代码流程整体是线性,最后附上流程图:

    post1.png

    相关文章

      网友评论

        本文标题:EventBus全解析系列(三)

        本文链接:https://www.haomeiwen.com/subject/hdvpottx.html