一、概述
EventBus是针一款对Android的发布/订阅事件总线。它可以让我们很轻松的实现在Android各个组件之间传递消息,并且代码的可读性更好,耦合度更低。
二、使用
- 首先需要定义一个消息类,该类可以不继承任何基类也不需要实现任何接口。如:
public class MessageEvent {
......
}
- 在需要订阅事件的地方注册事件
EventBus.getDefault().register(this);
- 产生事件,即发送消息
EventBus.getDefault().post(messageEvent);
- 处理消息
@Subscribe(threadMode = ThreadMode.PostThread)
public void XXX(MessageEvent messageEvent) {
...
}
在3.0之前,EventBus还没有使用注解方式。消息处理的方法也只能限定于onEvent、onEventMainThread、onEventBackgroundThread和onEventAsync,分别代表四种线程模型。而在3.0之后,消息处理的方法可以随便取名,但是需要添加一个注解@Subscribe,并且要指定线程模型(默认为PostThread),四种线程模型,下面会讲到。
注意,事件处理函数的访问权限必须为public,否则会报异常。
- 取消消息订阅
EventBus.getDefault().unregister(this);
三、常用的四种线程模型
在EventBus中的观察者通常有四种线程模型,分别是PostThread(默认)、MainThread、BackgroundThread与Async。
PostThread:如果使用事件处理函数指定了线程模型为PostThread,那么该事件在哪个线程发布出来的,事件处理函数就会在这个线程中运行,也就是说==发布事件和接收事件在同一个线程==。在线程模型为PostThread的事件处理函数中==尽量避免执行耗时操作==,因为它会阻塞事件的传递,甚至有可能会引起ANR。
MainThread:如果使用事件处理函数指定了线程模型为MainThread,那么不论事件是在哪个线程中发布出来的,==该事件处理函数都会在UI线程中执====行==。==该方法可以用来更新UI,但是不能处理耗时操作。==
BackgroundThread:如果使用事件处理函数指定了线程模型为BackgroundThread,那么如果事件是在UI线程中发布出来的,那么该事件处理函数就会在新的线程中运行,如果事件本来就是子线程中发布出来的,那么该事件处理函数直接在发布事件的线程中执行。==在此事件处理函数中禁止进行UI更新操作。==
Async:如果使用事件处理函数指定了线程模型为Async,那么无论事件在哪个线程发布,==该事件处理函数都会在新建的子线程中执行==。同样,此事件处理函数中==禁止进行UI更新操作==。
四、黏性事件
1. 概念
简单讲,就是在发送事件之后再订阅该事件也能收到该事件,跟黏性广播类似。
2. 用法
- 订阅黏性事件:
EventBus.getDefault().register(StickyModeActivity.this);
- 黏性事件处理函数:
@Subscribe(sticky = true)
public void XXX(MessageEvent messageEvent) {
......
}
- 发送黏性事件:
EventBus.getDefault().postSticky(new MessageEvent("test"));
能够收到订阅之前发送的消息。但是它只能收到最新的一次消息,比如说在未订阅之前已经发送了多条黏性消息了,然后再订阅只能收到最近的一条消息。