Guava的EventBus

最新推荐文章于 2025-10-18 19:34:06 发布

原创最新推荐文章于 2025-10-18 19:34:06 发布 · 303 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#java #Guava

java 专栏收录该内容

108 篇文章

订阅专栏

Guava的EventBus

文章目录

Guava的EventBus

一、EventBus介绍和简单实用

EventBus允许发布订阅模式中组建不用明确的注册，就可以相互进行沟通。它专为使用显式注册替换传统的 Java 进程内事件分发而设计。它不是一个通用的发布-订阅系统，也不是用于进程间通信的。

示例：

// 监听者
public class EventBusChangeRecord {
    /**
     * 订阅消息
     * @param changeEvent
     */
    @Subscribe
    public void recordCustomerChange(ChangeEvent changeEvent) {
        System.out.println("Listener: " + changeEvent.getData());
    }
}

// 第二个监听者
public class EventListener02 {

    @Subscribe
    public void run(ChangeEvent changeEvent) {
        System.out.println("run: "+changeEvent.getData());
    }
}

// 主题
public class ChangeEvent {
    private String data;

    public void changeData(String data) {
        this.data = data;
    }

    public String getData() {
        return data;
    }
}

public class EventBusDemo {

    public static void main(String[] args) {
        EventBus eventBus = new EventBus();
        // 注册监听者
        eventBus.register(new EventBusChangeRecord());
        // 注册第二个监听者
        eventBus.register(new EventListener02());

        // 下面的代码必须在是最后调用 post()  方法
        ChangeEvent changeEvent = new ChangeEvent();
        // 改变主题的属性
        changeEvent.changeData("hello, EventBus");
        // 发布主题
        eventBus.post(changeEvent);
        // 改变主题的属性
        changeEvent.changeData("hello, EventBus2");
        eventBus.post(changeEvent);
    }
}

-- 运行上面代码将会输出
Listener: hello, EventBus
run: hello, EventBus
Listener: hello, EventBus2
run: hello, EventBus2

二、将基于EventListener的系统修改为基于EventBus

2.1 对于监听者：Listener

（1）为了监听到特殊类型的事件（例如：CustomerChangeEvent）：

在传统的Java事件：实现一个定义了带有事件的接口。例如CustomerChangeEventListener；
使用EventBus：创建一个方法它接收CustomerChangeEvent作为唯一的参数，并在上面用@Subscribe注解修饰；

（2）向事件生产者注册你的监听器方法

在传统的Java事件：传递你的对象到每个生产者的registerCustomerChangeEventListener方法中。这些方法很少被定义在公共的接口中，因此为了知道每个可能的生产者，你必须知道它们的类型；
使用EventBus：传递你的对象到EventBus的EventBus.register(Object) 方法中。你需要确保你的对象和生产者共享一个EventBus。

（3）监听公共事件超级类型

在传统的Java事件：不容易
使用EventBus：事件会自动分派给任何超类型的监听器。允许接口类型的监听器或Object的“通配符监听器”。

（4）监听和探测在没有监听器情况下分派的事件

在传统的Java事件：添加代码到每个事件分发方法（或者使用AOP）
使用EventBus：订阅DeadEvent。EventBus将通知您任何已发布但未交付的事件。

2.2 对于生产者：Producers

（1）为了追踪事件的听众：

在传统的Java事件：写代码管理一个监听器的列表到你的对象中。包含同步，或者使用工具类，像EventListenerList
使用EventBus：EventBus会为你做这些事情。

（2）发布一个事件给监听着

在传统的Java事件：写一个方法发布事件到每一个监听者，包括错误隔离和同步。
使用EventBus：将事件对象传递给EventBus的EventBus.post(Object)方法。

三、词汇表

EventBus系统和代码使用下面的术语讨论事件分发：

事件	能够传递到bus到对象
订阅（Subscribing）	向EventBus注册监听器行为，以便它的处理程序接收事件。
监听器（Listener）	一个希望接收事件的对象，通过暴露处理方法。
处理方法（Handler method）	一个公开的方法，EventBus应该用来发布事件。处理程序方法由`@Subscribe`注解标注
传递一个事件（Posting an event）	通过`EventBus`让事件对任何的监听器管用。