Google Guava EventBus(事件总线)

Myth丶恋晨 2021-12-10 19:49 465阅读 0赞

EventBus是Guava的事件处理机制，是设计模式中的观察者模式（生产/消费者编程模型）的优雅实现。对于事件监听和发布订阅模式，EventBus非常优雅使用起来也非常的简单,这个可不是吹的是真的非常的简单。

EventBus内部实现原理不复杂(**源码不复杂，强烈推荐大家去看下**)。我们简单的概况下EventBus内部的实现：EventBus内部会维护一个Multimap<Class<?>, Subscriber> map(你可以认为是一个消息队列样的东西)，key就代表消息对应的类(消息不同类不同，区分不同的消息)、value是一个Subscriber，Subscriber其实就是对对应消息处理的一个封装。如果有消息发布就去这个map里面找到这个消息对应的处理方法在执行。

EventBus里面的相关术语。

<table> 
 <thead> 
  <tr> 
   <th>EventBus术语</th> 
   <th>解释</th> 
   <th>备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>事件(消息)</td> 
   <td>可以向事件总线发布的对象</td> 
   <td>通常是一个类，不同的消息事件用不同的类来代替，消息内容就是类里面的属性</td> 
  </tr> 
  <tr> 
   <td>订阅</td> 
   <td>向事件总线注册监听者以接受事件的行为</td> 
   <td>EventBus.register(Object)，参数就是监听者</td> 
  </tr> 
  <tr> 
   <td>监听者</td> 
   <td>提供一个处理方法，希望接受和处理事件的对象</td> 
   <td>通常也是一个类，里面有消息的处理方法</td> 
  </tr> 
  <tr> 
   <td>处理方法</td> 
   <td>监听者提供的公共方法，事件总线使用该方法向监听者发送事件；该方法应该用Subscribe注解</td> 
   <td>监听者里面添加了Subscribe注解的方法，就可以认为是消息的处理方法</td> 
  </tr> 
  <tr> 
   <td>发布消息</td> 
   <td>通过事件总线向所有匹配的监听者提供事件</td> 
   <td>EventBus.post(Object)</td> 
  </tr> 
 </tbody> 
</table>

# 一 EventBus的使用 #

EventBus的使用很简单。笼统来说分为以下几个步骤。不过在说EventBus使用之前，先把EventBus里面常用的函数列出来。

/**
         * 创建EventBus对象, identifier为“default”
         */
        public EventBus() {
            this("default");
        }
    
        /**
         * 创建EventBus对象, identifier就是用一个字符串来标识EventBus
         */
        public EventBus(String identifier);
    
        /**
         * 创建EventBus对象，exceptionHandler是异常处理类(消息处理过程中有异常，统一处理)
         * ps: identifier为“default”
         */
        public EventBus(SubscriberExceptionHandler exceptionHandler);
        
    
        /**
         * EventBus对象标识
         */
        public final String identifier();
        
    
        /**
         * 取消监听者的注册
         */
        public void unregister(Object object);
    
        /**
         * 发布一个消息
         *
         * @param event 可以认为是消息
         */
        public void post(Object event);

> EventBus简单吧，给我们用的函数都没几个。

## 1.1 EventBus对象创建 ##

EventBus对象需要根据实际情况来创建，你想全局只用一个EventBug。你可以用单例。你也可以根据不同的模块，每个模块一个EventBus对象。这些你都可以随意处理。当中缘由也很好理解，EventBus是中央处理器。你的监听者在哪个EventBus里面注册，你的消息就发布到这个对应的EventBus里面去。不能乱来。

EventBus对象创建就没什么说的了。

EventBus eventBus = new EventBus("test");

## 1.2 创建消息类 ##

消息，我们通常会封装成一个类。消息不同类也不同。如果是带参数的消息，这些参数就可以作为类的属性。比如如下一个实例，我们定义一个OrderMessage消息类，来接受某个命令，对应的命令内容orderContent。

/**
     * @name: OrderMessage
     * @author: tuacy.
     * @date: 2019/7/9.
     * @version: 1.0
     * @Description: 命令消息
     */
    public class OrderMessage {
        
        /**
         * 命令对应的内容
         */
        private String orderContent;
    
    
        public String getOrderContent() {
            return orderContent;
        }
    
        public void setOrderContent(String orderContent) {
            this.orderContent = orderContent;
        }
    }

这里也建议，消息对应的类不用搞的太复杂。最好不要各种继承，各种实现。除非到了万不得已的情况。

## 1.3 创建监听者类 ##

监听者也是一个类，不过在这个类里面需要确定我们需要处理哪些消息(可以是多个)，每个消息的处理对应一个函数，而且这个函数需要添加@Subscribe注解。比如我们定义一个OrderEventListener的监听类，处理我们上面的OrderMessage消息，代码如下：

/**
     * @name: OrderMessage
     * @author: tuacy.
     * @date: 2019/7/9.
     * @version: 1.0
     * @Description: 命令监听者
     */
    public class OrderEventListener {
    
        /**
         * 如果发送了OrderMessage消息，会进入到该函数的处理
         * @param event 消息
         */
        @Subscribe
        public void dealWithEvent(OrderMessage event) {
            // TODO: 收到EventTest消息之后，做相应的处理
            System.out.println("我收到了您的命令，命令内容为：" + event.getOrderContent());
        }
    
    }

## 1.4 注册监听者 ##

监听者类我们已经创建好了，这个时候我们需要把这个监听者注册到EventBus里面去。让他可以去匹配发布的消息。注册监听者就掉一个函数就行。

// 注册监听者
            eventBus.register(new OrderEventListener());

## 1.4 发布消息 ##

当有对应的消息产生的时候，需要发布出去让监听者处理的时候。很简单。掉个函数就Ok了。

// 发布消息
            eventBus.post(new OrderMessage());

@Test
        public void eventBus() {
            // 定义一个EventBus对象，因为我这里是测试，才这样写的。实际你应该定义一个单例获取其他的方式
            EventBus eventBus = new EventBus("test");
            // 注册监听者
            eventBus.register(new OrderEventListener());
            // 发布消息
            eventBus.post(new OrderMessage());
    
        }

# 二 异步消息处理AsyncEventBus #

AsyncEventBus是继承EventBus异步消息，准确来讲是我们可以指定消息的处理在哪里执行。比如我们可以把他们都放到一个线程池里面去执行。

public class AsyncEventBus extends EventBus {
    
        /**
         * 创建AsyncEventBus对象
         *
         * @param identifier EventBus标识
         * @param executor 消息在哪里执行，EventBus里面默认的是MoreExecutors.directExecutor()
         */
        public AsyncEventBus(String identifier, Executor executor) {
            super(identifier, executor, Dispatcher.legacyAsync(), LoggingHandler.INSTANCE);
        }
    
        /**
         * 创建AsyncEventBus对象
         *
         * @param executor 消息在哪里执行，EventBus里面默认的是MoreExecutors.directExecutor()
         * @param subscriberExceptionHandler 异常处理
         * @since 16.0
         */
        public AsyncEventBus(Executor executor, SubscriberExceptionHandler subscriberExceptionHandler) {
            super("default", executor, Dispatcher.legacyAsync(), subscriberExceptionHandler);
        }
    
        /**
         * 创建AsyncEventBus对象
         *
         * @param executor 消息在哪里执行，EventBus里面默认的是MoreExecutors.directExecutor()
         */
        public AsyncEventBus(Executor executor) {
            super("default", executor, Dispatcher.legacyAsync(), LoggingHandler.INSTANCE);
        }
        
    }

--------------------

Guava EventBus里面的东西比较简单，所以上面讲的也很简单。有什么疑问欢迎留言。关于Guava EventBus个人觉得要是有以下功能就跟好了，纯属个人观点。

*  要是消息支持优先级就好了。
 *  要是可以主动中断消息就好了。比如有多个监听者。有一个处理了我不希望继续往下传递了。
 *  要是消息要是能支持存活时间就好了。比如多长时间没有处理。消息失效。