EventBus 3.0的用法詳解(一)
EventBus 3.0的用法詳解(二)
EventBus介紹
EventBus是Android和Java的發(fā)布/訂閱事件總線践剂。從EventBus3.1開始支持普通Java(非android)項(xiàng)目格了。GitHub的地址
為什么使用EventBus
- 簡(jiǎn)化了應(yīng)用程序內(nèi)各組件間、組件與后臺(tái)線程間的通信
- 解耦事件發(fā)送方和接收方
- 開銷小必盖、快、代碼更優(yōu)雅、體積小(~50k jar)
- 避免復(fù)雜和容易出錯(cuò)的依賴關(guān)系和生命周期問(wèn)題
EventBus的三要素
- Event：事件，可以是任意類型的對(duì)象暇咆。
- Subscriber：事件訂閱者，在EventBus3.0之前消息處理的方法只能限定于onEvent冠摄、onEventMainThread糯崎、onEventBackgroundThread和onEventAsync。而在EventBus3.0之后河泳，事件處理的方法可以隨便取名，但是需要添加一個(gè)注解@Subscribe邮丰，并且要指定線程模型（默認(rèn)為POSTING）吻商，線程模型下面會(huì)講到娶靡。
- Publisher：事件發(fā)布者，可以在任意線程任意位置發(fā)送事件纸兔，直接調(diào)用EventBus.getDefault().post(Object)，根據(jù)post函數(shù)參數(shù)的類型否副，會(huì)自動(dòng)調(diào)用訂閱相應(yīng)類型事件的函數(shù)汉矿。
EventBus的五種線程模型
- POSTING（默認(rèn)）：如果使用事件處理函數(shù)指定了線程模型為* * * POSTING，那么該事件在哪個(gè)線程發(fā)布出來(lái)的备禀，事件處理函數(shù)就會(huì)在這個(gè)線程中運(yùn)行洲拇，也就是說(shuō)發(fā)布事件和接收事件在同一個(gè)線程。在線程模型為POSTING的事件處理函數(shù)中盡量避免執(zhí)行耗時(shí)操作曲尸，因?yàn)樗鼤?huì)阻塞事件的傳遞赋续，甚至有可能會(huì)引起ANR。
- MAIN: 事件的處理會(huì)在UI線程中執(zhí)行另患。事件處理時(shí)間不能太長(zhǎng)纽乱，長(zhǎng)了會(huì)ANR的。
- BACKGROUND：如果事件是在UI線程中發(fā)布出來(lái)的昆箕，那么該事件處理函數(shù)就會(huì)在新的線程中運(yùn)行鸦列，如果事件本來(lái)就是子線程中發(fā)布出來(lái)的租冠，那么該事件處理函數(shù)直接在發(fā)布事件的線程中執(zhí)行。在此事件處理函數(shù)中禁止進(jìn)行UI更新操作薯嗤。
- ASYNC：無(wú)論事件在哪個(gè)線程發(fā)布顽爹，該事件處理函數(shù)都會(huì)在新建的子線程中執(zhí)行，同樣应民，此事件處理函數(shù)中禁止進(jìn)行UI更新操作
- MAIN_ORDERED：在EventBus3.1之后新增加的话原，按照事件的發(fā)布順序同步執(zhí)行
EventBus常用Api
繼承結(jié)構(gòu)
java.lang.Object
org.greenrobot.eventbus.EventBus
EventBus的使用，注冊(cè)普通事件
添加依賴庫(kù)
implementation "org.greenrobot:eventbus:3.1.1"
自定義一個(gè)事件類
data class MessageEvent(val message:String)
準(zhǔn)備訂閱器:聲明和注釋訂閱方法诲锹，可選地指定線程模式
@Subscribe(threadMode = ThreadMode.MAIN)
fun onMessageEvent(event: MessageEvent){ /* Do something */ }
在EventBus3.0之前消息處理的方法只能限定于onEvent繁仁、onEventMainThread、onEventBackgroundThread和onEventAsync归园，EventBus3.0之后消息處理的方法可以隨便取名黄虱，但是需要添加一個(gè)注解@Subscribe，并且要指定線程模型（默認(rèn)為POSTING）
注冊(cè)和取消訂閱事件
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
EventBus.getDefault().register(this)
}
override fun onDestroy() {
super.onDestroy()
EventBus.getDefault().unregister(this)
}
發(fā)布事件
EventBus.getDefault().post(MessageEvent("發(fā)送MessageEvent"))
EventBus的粘性事件
在EventBus中除了普通事件庸诱，還支持發(fā)送黏性事件捻浦，就是在發(fā)送事件之后再訂閱該事件也能收到該事件
訂閱者處理粘性事件
@Subscribe(threadMode = ThreadMode.POSTING, sticky = true)
fun onMessageEvent(event: MessageEvent){ /* Do something */ }
發(fā)送黏性事件
EventBus.getDefault().postSticky(MessageEvent("發(fā)送MessageEvent"))
在需要的地方調(diào)用，訂閱注冊(cè)事件
EventBus.getDefault().register(this)
ProGuard 混淆規(guī)則
-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);
}
