EventBus3.1用法详解

EventBus介绍

EventBus是Android和Java的发布/订阅事件总线。从EventBus3.1开始支持普通Java(非android)项目。GitHub的地址

为何使用EventBus

• 简化了应用程序内各组件间、组件与后台线程间的通讯
• 解耦事件发送方和接收方
• 开销小、快、代码更优雅、体积小(~50k jar)
• 避免复杂和容易出错的依赖关系和生命周期问题

EventBus的三要素

• Event：事件，能够是任意类型的对象。
• Subscriber：事件订阅者，在EventBus3.0以前消息处理的方法只能限定于onEvent、onEventMainThread、onEventBackgroundThread和onEventAsync。而在EventBus3.0以后，事件处理的方法能够随便取名，可是须要添加一个注解@Subscribe，而且要指定线程模型（默认为POSTING），线程模型下面会讲到。
• Publisher：事件发布者，能够在任意线程任意位置发送事件，直接调用EventBus.getDefault().post(Object)，根据post函数参数的类型，会自动调用订阅相应类型事件的函数。

EventBus的五种线程模型

• POSTING（默认）：若是使用事件处理函数指定了线程模型为POSTING，那么该事件在哪一个线程发布出来的，事件处理函数就会在这个线程中运行，也就是说发布事件和接收事件在同一个线程。在线程模型为POSTING的事件处理函数中尽可能避免执行耗时操做，由于它会阻塞事件的传递，甚至有可能会引发ANR。
• MAIN: 事件的处理会在UI线程中执行。事件处理时间不能太长，长了会ANR的。
• BACKGROUND：若是事件是在UI线程中发布出来的，那么该事件处理函数就会在新的线程中运行，若是事件原本就是子线程中发布出来的，那么该事件处理函数直接在发布事件的线程中执行。在此事件处理函数中禁止进行UI更新操做。
• ASYNC：不管事件在哪一个线程发布，该事件处理函数都会在新建的子线程中执行，一样，此事件处理函数中禁止进行UI更新操做
• MAIN_ORDERED：在EventBus3.1以后新增长的，按照事件的发布顺序同步执行

EventBus经常使用Api

继承结构

java.lang.Object
    org.greenrobot.eventbus.EventBus
复制代码

经常使用方法

方法	说明
EventBus.getDefault()	获取EventBus的实例
EventBus.getDefault().register(this)	在须要的地方调用，订阅注册事件
EventBus.getDefault().post(messageEvent)	发布事件到事件总线
@Subscribe(threadMode = ThreadMode.MAIN)	指定线程模型处理事件
EventBus.getDefault().unregister(this)	取消订阅的事件

EventBus的使用，注册普通事件

添加依赖库

implementation "org.greenrobot:eventbus:3.1.1"
复制代码

自定义一个事件类

data class MessageEvent(val message:String)
复制代码

准备订阅器:声明和注释订阅方法，可选地指定线程模式

@Subscribe(threadMode = ThreadMode.MAIN)
fun onMessageEvent(event: MessageEvent){ /* Do something */ }
复制代码

在EventBus3.0以前消息处理的方法只能限定于onEvent、onEventMainThread、onEventBackgroundThread和onEventAsync，EventBus3.0以后消息处理的方法能够随便取名，可是须要添加一个注解@Subscribe，而且要指定线程模型（默认为POSTING）

注册和取消订阅事件

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    EventBus.getDefault().register(this)
}

override fun onDestroy() {
    super.onDestroy()
    EventBus.getDefault().unregister(this)
}
复制代码

发布事件

EventBus.getDefault().post(MessageEvent("发送MessageEvent"))
复制代码

EventBus的粘性事件

在EventBus中除了普通事件，还支持发送黏性事件，就是在发送事件以后再订阅该事件也能收到该事件

订阅者处理粘性事件

@Subscribe(threadMode = ThreadMode.POSTING, sticky = true)
fun onMessageEvent(event: MessageEvent){ /* Do something */ }
复制代码

发送黏性事件

EventBus.getDefault().postSticky(MessageEvent("发送MessageEvent"))
复制代码

在须要的地方调用，订阅注册事件

EventBus.getDefault().register(this)
复制代码

ProGuard 混淆规则

-keepattributes *Annotation*
-keepclassmembers class * {
    @org.greenrobot.eventbus.Subscribe <methods>;
}
-keep enum org.greenrobot.eventbus.ThreadMode { *; }
 
# Only required if you use AsyncExecutor
-keepclassmembers class * extends org.greenrobot.eventbus.util.ThrowableFailureEvent {
    <init>(java.lang.Throwable);
}
复制代码

参考资料

• ProGuard
• EventBus
• EventBus官方Api
• Android开发系列通讯篇之EventBus
• EventBus3.0用法全解析