EventBus的基本使用

最新推荐文章于 2022-03-31 20:46:19 发布

stephen-shc

最新推荐文章于 2022-03-31 20:46:19 发布

阅读量211

点赞数

分类专栏： eventbus

本文链接：https://blog.csdn.net/qq_31101655/article/details/79256879

版权

eventbus 专栏收录该内容

1 篇文章 0 订阅

订阅专栏

基本的使用

定义events

Events通常是一个POJO(plain old Java object).可以根据需要，随便定义。可以定义多种类型的events，事件处理函数根据事件的类型实现重载。events除了自定义，还可以是Java中的基本类型(int, boolean等)。

public class MessageEvent{ public String message;

public MessageEvent(String message){
    this.message = message;
}

}

注册订阅者

只有需要接收events的地方，才需要注册订阅者。只是发送事件的话，不必注册。在Acitvity中注册和注销订阅者：

@Override
public void onStart() {
    super.onStart();
    EventBus.getDefault().register(this);
}

@Override
public void onStop() {
    EventBus.getDefault().unregister(this);
    super.onStop();
}

添加events处理函数

其实添加events处理函数也是注册订阅者的一部分，它们俩一起完成了注册任务。在注册了订阅者的地方，添加事件处理函数。

// This method will be called when a MessageEvent is posted
public void onEvent(MessageEvent event){
    Toast.makeText(getActivity(), event.message, Toast.LENGTH_SHORT).show();
}

// This method will be called when a SomeOtherEvent is posted
public void onEvent(SomeOtherEvent event){
    doSomethingWith(event);
}

有两点需要注意：

事件处理函数必须有参数，且只能有一个参数。函数根据这个参数的类型，实现重载的功能。事件处理函数的名字必须以onEvent开头，且必须是以下四种： onEvent onEventMainThread onEventBackgroundThread onEventAsync

发送events

可以在任何地方发送一个事件。所有注册了这个事件类型的订阅者都可以收到它。

EventBus.getDefault().post(new MessageEvent("Hello everyone!")); 这里有两点需要注意：

如果event是基本类型，发送时event会被自动装箱。因此事件处理函数（onEvent）的参数类型必须是基本类型对应的对象类型。所有注册了event对象的父类的订阅者，都可以收到这个event。也就是说，如果某个订阅者的某个事件处理函数的参数是Object类型

onEvent(Object object) 那么所有发出去的event，它都可以收到。

线程模型 EventBus可以自动处理线程问题，使我们从后台线程与UI线程的切换中解放出来。

在EventBus中，通过约定事件处理函数名称的方式，决定在哪个线程中执行事件处理方法。

onEvent 对应PostThread模型，事件处理函数将会在事件发送者的线程上执行。这种模式，不需要切换线程，是最快速的，推荐默认采用。 onEventMainThread 对应MainThread模型，事件处理函数将会在主线程上执行。 onEventBackgroundThread 对应BackgroundThread模型，如果发送线程不是主线程，那么事件处理函数将会直接在发送线程调用。如果发送线程是主线程，那么EventBus会启用一个后台线程执行事件处理函数。 onEventAsync 对应Async模型，EventBus会启用一个单独的线程(既不是发送线程，又不是主线程)执行事件处理函数。EventBus会使用线程池，重用线程。设定优先级可以在注册的时候,设置订阅者的优先级。

int priority = 1;  
EventBus.getDefault().register(this, priority);

高优先级的订阅者，可以先接收到事件。默认的优先级是0. 这里有一点需要注意，用官方文档的话说就是：

Note: the priority does NOT affect the order of delivery among subscribers with different ThreadModes! 也就是说，两个订阅者：subscribe1和subscribe2，subscribe1的优先级较高，那么subscribe1的onEvent函数肯定比subscribe2的onEvent函数先接收到事件，onEventBackgroundThread函数也肯定比subscribe2的onEventBackgroundThread优先。但是不能比较subscribe1的onEvent和subscribe2的onEventBackgroundThread，因为它们的线程模型不同，可能在不同的线程上。

取消events的传递高优先级的订阅者可以在事件处理函数中取消事件的传递。

// Called in the same thread (default)
public void onEvent(MessageEvent event){
    // Process the event 
    ...

    EventBus.getDefault().cancelEventDelivery(event) ;
}

Sticky Events Sticky Events可以用于需要延迟接收事件的情况。普通的事件发送出去以后，EventBus便不再持有了，因此后续注册的订阅者无法接收到它。但是sticky事件不同，EventBus会在内存中为每一种事件类型保存一个最新发送的事件，直到后续发送新的sticky事件，把它覆盖掉。因此后续注册的订阅者，依然可以从内存中得到这个已发送的sticky事件。发送sticky事件：

EventBus.getDefault().postSticky(new MessageEvent("Hello everyone!")); 注册sticky订阅者：

@Override
public void onStart() {
    super.onStart();
    EventBus.getDefault().registerSticky(this);
}

public void onEventMainThread(MessageEvent event) {
    textField.setText(event.message);
}

@Override
public void onStop() {
    EventBus.getDefault().unregister(this);
    super.onStop();
}