美文网首页
EventBus BackgroundPoster原理解析

EventBus BackgroundPoster原理解析

作者: 夜色流冰 | 来源:发表于2018-07-06 23:09 被阅读87次

    EventBus相信大家都不陌生,所以这里偷个懒就不说具体用法了,本篇讲解以下原理性的东西,不过在阅读本博客之前建议大家阅读博主的以下两篇博客,因为本篇是在这两篇的基础上写的:
    Otto源码解读
    EventBus源码解析开篇
    通过上面两篇博客,可以了解EventBus的工作原理,简单来说最核心就是:
    1、收集应用中所有标注了@Subscribe的Method方法(当然这些方法都是属于具体的注册者对象(Subscriber)的)
    2、收到事件后执行method.invoke(subscriber,event);

    上述两步就是EventBus的根本的核心所在。然后围绕着这两个核心不断的扩展功能过而已,当然具体的可参考文章开头的说的两篇博客。

    结合上面两条在EventBus 中设计了Subscription这个类:

    class Subscription {
        //EventBus.register的对象
        final Object subscriber;
        //对@Subscribe注解方法 Method对象的封装
        final SubscriberMethod subscriberMethod;
      }  
    

    在EventBus发送事件到注册者执行Subscribe方法的时候就有了如下方法:

    
     void invokeSubscriber(Subscription subscription, Object event) {
               subscription
               .subscriberMethod
               .method.//Method 对象
               invoke(subscription.subscriber, event);//反射调用
            
        }
    

    EventBus是事件总线模式,何谓事件,在面向对象的世界中就是个new 出来的对象而已。这个事件是要用EventBus 的post发送出去的,发送给谁?当然是发送给某个对象(面向对象的世界除了对象还有啥),且这个对象的某个方法必须标注@Subsrcribe注解,就像发送邮件的,总得门牌号,而@Subsrcibe就是这个门牌号。找到了事件接收方,怎么处理“邮件”就是接收者自己的事儿了,或者在被窝里看,或者坐客厅里看,反正爱怎么干怎么干。但是凡事总有个约束,EventBus允许事件接收者用如下几个模式来对事件进行处理,即:POSTING、MAIN、MAIN_ORDER、BACKGROUND、ASYNC。

    在本篇中之对BACKGROUND模式进行简单的讲解,用法如下:

    @Subscribe(threadMode = ThreadMode.BACKGROUND)
    public void onEventBackgroundThread(Integer event) {
               
    }
    

    BACKGROUND即后台模式,这个后台是相对于Android主线程而言的,也是就是在非UI线程中处理这个事件,在源码中看可以很好的理解:

      //EventBus 对BACKGROUND 模式的处理
      case BACKGROUND:
         if (isMainThread) {//如果是UI线程,则开启新线程执行之。
            backgroundPoster.enqueue(subscription, event);
         } else {//非UI线程则在直接在本线程中执行
             invokeSubscriber(subscription, event);
         }
          break;
    

    从源码上也能看出BACKGROUND和ASYNC的简单区别(当然这只是区别之一):

    case ASYNC:
        //该模式下不论是UI还是非UI线程下,都另起线程执行
        asyncPoster.enqueue(subscription, event);
    

    发送事件是一个具体的行为,为此EventBus抽象出来一个Poster接口出来;

    interface Poster {
      //subscription:事件接收者
      //event:具体的事件
       void enqueue(Subscription subscription, Object event);
    }
    

    在这里说一个题外话,通常我们都说面向抽象编程,什么是面向抽象呢?简单的来说就是面向接口(interface),而不是面向实现(class)去思考。优先考虑做什么,而不是如何做。比如你去打印文件,你要做的就是打印文件这件事。抽象一个PrintFile接口,而不是先考虑如何打印。

     interface PritFile{
        void print();
     }
    

    至于是用公司(CompanyPrinter)的打印机去打印,还是去打印店(ShopPrinter),这个具体实现就是后期具体设计的了。所以先设计一个接口来统筹行为方案,怎么去实现就有很大的扩展性。都是打印文件,只不过采取的方式不同,从这方面来看接口的不同实现有殊途同归的性质:都是为了实现一个具体的行为。就比如不同的打印实现都是为了打印文件来服务的。

    这在里Poster接口也是做了类似于PrintFile接口的事儿,在EventBus里面Poster的实现类:


    poster.png

    其中AsyncPoster处理的就是ThreadModel.ASYNC,HandlerPoster对应ThreadModel.MAIN和ThreadModel.MAIN_ORDER,至于BackgroundPoster则是处理的ThreadModel.BACKGROUND的了,也是本篇博文的主角。


    对象用来封装数据和行为,而对象之间往往是需要不断传递的。下面讲一下EventBus 中一个重要的类PendingPost,该类的结构也很简单:

    class PendingPost {
       
        private final static List<PendingPost> pendingPostPool = new ArrayList<PendingPost>();
        //具体的事件对象
        Object event;
        Subscription subscription;
        
        //next指针
        PendingPost next;
     }   
    

    可以看出PendingPost除了封装了事件对象event,事件接收者对象Subscription之外,还弄了个next引用,这明摆着就是构建一个链表结构,注意该类还有个静态的pendingPostPool集合,该集合包含了PendingPost对象,至于这个集合的作用后面再讲。首先所以我们来看看EventBus是怎么构建这个PendingPost链表的,具体的构建过程在PendingPostQueue类里面,先瞧瞧这个类有啥:

     class PendingPostQueue {
        //链表头部引用
        private PendingPost head;
        //链表尾部指针
        private PendingPost tail;
      } 
    

    注意该类算是EventBus的核心类之一,在AsyncPoster,BackgroundPost,HandlerPoster里都有用到,该类的强大作用就是构建具有head和tail引用的PendingPost链表结构。具体的构建行为在PendingPostQueue对象的enqueue方法里面:

    
    synchronized void enqueue(PendingPost pendingPost) {
             
            if (tail != null) {
                tail.next = pendingPost;
                tail = pendingPost;
            } else if (head == null) {//第一次执行是走这个分支
                head = tail = pendingPost;
            } 
            
            //唤醒等待的线程
            notifyAll();
        }
    

    上面的方法第一次执行的时候形成了下面的结果:


    e1.png

    多次调用的话,很明显形成的链表结构如下:


    e2.png

    其实也就是一个简单的链表结构,也就是说enqueue方法的作用就是将EventBus post的事件形成一个如上图所示的链表。那么我们怎么获取链表中的对象呢,对应的PendingPostQueue有了poll方法:

       synchronized PendingPost poll() {
            //返回head节点,并将head指针下移
            PendingPost pendingPost = head;
            if (head != null) {
                head = head.next;
                if (head == null) {
                    tail = null;
                }
            }
            return pendingPost;
        }
    
        synchronized PendingPost poll(int maxMillisToWait) throws InterruptedException {
           //列表为空,等待并释放锁
            if (head == null) {
                wait(maxMillisToWait);
            }
            return poll();
        }
    

    所以经过poll方法处理一次后,上图中的head引用会指向PendingPost2节点。一句话总结PendingPostQueue的作用就是构建上图链表和从列表中获取PendingPost的过程,且在构建的过程中如果构建完毕则调用notifyAll,取PendingPost的时候如果链表为null则wait ,可以说是一个简单的生产者消费者模式


    BackgroundPoster简单分析
    上面提到PendingPostQueue在EventBus Poster接口的三个实现类中都有使用,所以看看先BackgroundPoster这个类的具体实现:

    //注意BackgroundPoster是一个Runnable
    class BackgroundPoster implements Runnable, Poster {
        //事件链表
        private final PendingPostQueue queue;
        private final EventBus eventBus;
        //volatile确保可见性,但是不能保证原子性
        //判断事件是否得到执行
        private volatile boolean executorRunning;
    
        BackgroundPoster(EventBus eventBus) {
            this.eventBus = eventBus;
            queue = new PendingPostQueue();
        }
      }  
    

    BackgroundPoster是一个实现了Poster的Runnable, 且看poster的enqueue在BackgroundPoster的具体实现:

     @Override
        public void enqueue(Subscription subscription, Object event) {
            //1、获取一个pendingPost
            PendingPost pendingPost = PendingPost.obtainPendingPost(subscription, event);
            synchronized (this) {
                //2、构建事件链表
                queue.enqueue(pendingPost);
                //3、执行事件
                if (!executorRunning) {
                    executorRunning = true;
                    eventBus.getExecutorService().execute(this);
                }
            }
        }
    

    正如代码注释所示,上述方法所了三件事:
    1、根据事件event和事件接收者subscription获取一个PendingPost对象,
    2、讲获取到PendingPost对象交给queue.enqueue构成上图的链表结构
    3、调用eventBus.getExecutorService来处理事件,会调用BackgroundPoster的fun方法。

    下面详细说一下事件1:具体的是PendingPost的静态方法obtainPendingPost来构建一个PendingPost:

     //PendingPost集合
     final static List<PendingPost> pendingPostPool=new ArrayList<PendingPost>();
     
    static PendingPost obtainPendingPost(Subscription subscription, Object event) {
            //从pendingPostPool获取一个PendingPost
            synchronized (pendingPostPool) {
                int size = pendingPostPool.size();
                if (size > 0) {
                    //从集合末尾获取一个
                    PendingPost pendingPost = pendingPostPool.remove(size-1);
                    pendingPost.event = event;
                    pendingPost.subscription = subscription;
                    pendingPost.next = null;
                    return pendingPost;
                }
            }
            //如果pendingPostPool没有,则创建一个
            return new PendingPost(event, subscription);
        }
    

    逻辑很清晰,就是先从List集合的尾部中调用remove获取一个PendingPost对象,注意List集合中的PendingPost对象所封装的数据都为空,也就是:

            pendingPost.event == null;
            pendingPost.subscription == null;
            pendingPost.next == null;
    

    然后将obtainPendingPost方法里的参数赋值给该pendingPost对象并返回。如果list集合为空,则new 一个PendingPost返回,注意此时新创建的PendingPost的数据不为空,并没有调用list.add方法将对象放入进去。那么什么时候将PendingPost对象add进来呢?当然是事件处理完毕后,此时调用PendingPost的releasePendingPost静态方法:

       //处理完事件后将pendingPost数据指控,可比喻为空瓶回收
        static void releasePendingPost(PendingPost pendingPost) {
            //数据置空
            pendingPost.event = null;
            pendingPost.subscription = null;
            pendingPost.next = null;
            
            //数据指控后list回收,感觉跟空瓶回收一样
            //水喝完了,瓶子单独回收
            synchronized (pendingPostPool) {
                // Don't let the pool grow indefinitely
                if (pendingPostPool.size() < 10000) {
                    pendingPostPool.add(pendingPost);
                }
            }
        }
    

    所以list集合的作用就是有点类似空瓶回收的作用,在这里PendingPost就是瓶子,瓶子里的水(事件)喝完后,将瓶子回收过来等下次再装水(事件),好处PendingPost这个对象得到了复用,必须了对象的频繁创建

    e3.png

    说完了PendingPost的创建和回收,以及PendingPost链表的构建是时候看看事件的消费了,当然是在BackgroundPoster的run方法中对事件进行分发处理,所以看看run方法都怎么处理的:

     public void run() {
            try {
                try {
                    //循环获取链表,并处理直到链表为null
                    while (true) {
                        //1、从连表中获取一个PendingPost,链表为null则等待一秒
                        PendingPost pendingPost = queue.poll(1000);
    
                        if (pendingPost == null) {
                            synchronized (this) {
                                // Check again, this time in synchronized
                                //继续获取pendingPost
                                pendingPost = queue.poll();
                                //如果还为null,认定此时没有事件产生
                                if (pendingPost == null) {
                                    executorRunning = false;
                                    //退出run方法
                                    return;
                                }
                            }
                        }
    
                        //在这里会调用PendingPost.releasePendingPost
                        eventBus.invokeSubscriber(pendingPost);
                    }
                } catch (InterruptedException e) {
                    eventBus.getLogger().log(Level.WARNING, Thread.currentThread().getName() + " was interruppted", e);
                }
            } finally {
                executorRunning = false;
            }
        }
    

    可以看出run总体上来说就是循环PendingPost链表,然后调用eventBus.invokeSubscriber(pendingPost);该方法主要是将event交给@subsribe方法进行invoke调用。需要注意的是invokeSubscriber方法里面调用了PendingPost.releasePendingPost,该方法上面说过就是对pendingPost进行回收再利用(见上图)。

        void invokeSubscriber(PendingPost pendingPost) {
            Object event = pendingPost.event;
            Subscription subscription = pendingPost.subscription;
            //回收pendingPost对象,以后复用
            PendingPost.releasePendingPost(pendingPost);
            if (subscription.active) {
                //真正执行method.invoke的地方
                invokeSubscriber(subscription, event);
            }
        }
        
        //真正执行method.invoke的地方
        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);
            }
        }
    

    需要额外注意的是,在while循环中,先调用poll(1000)方法,如果事件链表为null,则wait(1000),等待事件产生;而后再次在用poll()获取,如果此时仍然为null,则EventBus认为现阶段没有事件,则run方法执行结束,直到下次事件来临后继续调用eventBus.getExecutorService().execute(this)执行。

    还需要注意的是因为在fun方法中循环便利事件链表,所以为了防止事件阻塞,在使用ThreadModel.BACKGROUND的时候,要求此@Subricebe 方法不要执行耗时的逻辑。比如网络请求等。就像官方注释所说:

     EventBus uses a single background thread, that will deliver all its events sequentially. Subscribers using this mode should try to  return quickly to avoid blocking the background thread
    

    那么耗时的逻辑在哪儿执行呢?耗时的逻辑用ThreadModel.ASYNC 模式,因为该模式很简单就是获取链表中的一个事件,执行之;而不像BackGround那样循环整个事件链表挨个执行之。

      //AsyncPoster的run方法
      public void run() {
            PendingPost pendingPost = queue.poll();
            if(pendingPost == null) {
                throw new IllegalStateException("No pending post available");
            }
            eventBus.invokeSubscriber(pendingPost);
        }
    

    到此为止BackgrounPoster讲解完毕,如有不当之处欢迎批评指正,共同学习

    相关文章

      网友评论

          本文标题:EventBus BackgroundPoster原理解析

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