EventBus 是Android上的以发布\订阅事件为核心的库。
事件 ( event ) 通过 post() 发送到总线,然后再分发到匹配事件类型的订阅者 ( subscribers ) 。
订阅者只有在总线中注册 ( register ) 了才能收到事件,注销 ( unrigister ) 之后就收不到任何事件了。
事件方法必须带有 Subscribe 的注解,必须是 public ,没有返回类型 void 并且只能有一个参数。
EventBus.getDefault()所有事件注册,分发到同一条总线。
订阅者可以注册到不同的线上的 EventBus ,通过不同的 EventBus 实例来发送数据,不同的 EventBus 是相互隔离开的,订阅者都只会收到注册到该线上事件。
EventBus bus = new EventBus();
1.订阅:
1.1 订阅者优先级(Subscriber Priorities),可以通过提升优先级来修改事件传递的顺序。EventBus默认的优先级是0。
@Subscribe(priority = 1);
public void onEvent(MessageEvent event) {
…
}
在相同的线程模式下,高优先级的订阅者将会比低优先级的订阅者更早接收到事件。
注意:优先级不会影响不同线程模式下的订阅者接收事件的顺序。
1.2 父类中定义的订阅方法不能被子类重写。
调用EventBus.getDefault().regist(this)后,EventBus就会查询当前类及其父类中的订阅方法,如果发现父类中也订阅了相同的订阅方法(被子类override了),则会抛出异常
1.3 EventBus对继承的父类也会进行查找注册函数,即子类注册一次即可,父类直接使用 @Subscribe来产生订阅函数。
2. 取消事件(Cancelling event delivery)
你可以在订阅者的事件处理方法中通过调用cancelEventDelivery去中断事件传递的过程。任何下一步的事件都会被取消;之后的订阅者也不会收到事件。
// Called in the same thread (default)
@Subscribe
public void onEvent(MessageEvent event){
// Process the event
…
EventBus.getDefault().cancelEventDelivery(event) ;
}
事件一般都是被高优先级的订阅者取消传递的。事件取消仅限于默认的ThreadMode.PostThread下才可以使用。
其他类型有:@Subscrible(threadMode = ThreadMode.ASYNC)
@Subscrible(threadMode = ThreadMode.BACKGRAND)
@Subscrible(threadMode = ThreadMode.MAIN)
3. Sticky事件:
发送粘性事件
EventBus.getDefault().postSticky(new DataSynEvent());
对于粘性广播我们都比较清楚属于常驻广播,对于EventBus粘性事件也类似,我们如果不再需要该粘性事件我们可以移除:
DataSynEvent stickyEvent = EventBus.getDefault().getStickyEvent(DataSynEvent.class);
// Better check that an event was actually posted before
if(stickyEvent != null) {
// "Consume" the sticky event
EventBus.getDefault().removeStickyEvent(stickyEvent);
/ / Now do something with it
}
或者调用移除所有粘性事件:
EventBus.getDefault().removeAllStickyEvents();
@Override
public void onStart() {
super.onStart();
EventBus.getDefault().register(this);
}
@Override
public void onStop() {
EventBus.getDefault().unregister(this);
super.onStop();
}
@Subscribe(threadMode = ThreadMode.MAIN,sticky = true)
// 在ui线程执行Sticky事件
// 发送事件之后再订阅该事件也能收到Sticky事件
public void onDataSynEvent(DataSynEvent event) {
Log.e(TAG, "event---->" + event.getCount());
}
目前EventBus只支持跨线程,而不支持跨进程。如果一个app的service起到了另一个进程中,那么注册监听的模块则会收不到另一个进程的EventBus发出的事件。
https://github.com/greenrobot/EventBus/
http://blog.csdn.net/afei__/article/details/52103746
# 混淆 EventBus
-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);
}