-
What
EventBus是一种在Java和Android中使用的基于发布/订阅的事件模型,可以广泛使用在Activity、Fragment和线程之间通信,由于它的简易、快速、轻便和可配置等特点被广泛使用。
-
How
在使用之前需在app/build.gradle文件下添加EventBus所需的依赖,EventBus的GitHub仓库地址。
首先需要定义事件类型,用于发布者发布出去。
public static class MessageEvent {
public String message;
public MessageEvent(String message) {
this.message = message;
}
}
准备订阅者,订阅者可以是Activity、Fragment或者线程,如果是Activity,需要在onStart和onStop方法中注册和解除注册事件总线,如果是Fragment,在onViewCreated和onDestroyView中注册和解除注册事件总线,还需要实现接收到事件的处理方法,通过@Subscribe注解,方法名没有要求,但是访问权限必须是public,参数必须是一个事件类型,而且只能有一个参数,返回类型必须是void。在相应的事件发出后,对应的处理方法会被调用。
@Subscribe(threadMode = ThreadMode.MAIN,sticky = true)
public void handleEventMessage(SecondFragment.MessageEvent messageEvent){
mFirstTextView.setText(messageEvent.message);
}
发布者可以在任何地方发出一个消息,消息通过事件总线传递,注册了的订阅者就会收到消息,对应的处理方法会被调用。
mSecondButton.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Log.d(TAG, "onClick: " + Thread.currentThread().getId());
EventBus.getDefault().post(new MessageEvent("hello,second fragment"));
}
});
-
threadMode
EventBus具有四种线程模式,用于对订阅者的事件处理方法执行在哪一个线程进行说明。默认使用的是POSTING,发布事件和处理事件方法执行在同一个线程,这种模式下,发布和订阅是同步完成的,一旦发布,所有订阅者都能收到事件消息,这个模式避免了线程切换,开销较小,但是需要快速返回,防止阻塞发布者所在线程;MAIN模式下订阅者处理方法会被主线程执行,需要避免处理方法过于耗时,导致ANR;MAIN_ORDERED相比与main,订阅者收到和执行的消息是有序的;BACKGROUND判断发布消息的线程是否在 UI 线程,如果不是的话直接反射调用,是的话通过backgroundPoster的enqueue()方法 将方法加入到后台的一个队列,最后通过线程池去执行;ASYNC逻辑实现类似于BACKGROUND,将任务加入到后台的一个队列,最终由Eventbus 中的一个线程池去调用。
-
strickEvent
粘性事件,普通事件需要订阅者注册以后才能收到发布者发出的事件,而粘性事件可以将最新的事件保存在内存中,将来注册的订阅者也可以接收到之前最新的事件。发送的粘性事件会保存在一个 map 中,这样才能实现后订阅也能接收到的功能,同时会保留最后一个粘性事件。对于某些只处理一次的事件,会造成重复处理最后一个粘性事件的情况,有时这是不符合预期的,需要在处理完粘性事件后手动将其删除,使用 removeStickyEvent()方法进行移除。