EventBus

EventBus 是Android上的以发布\订阅事件为核心的库。
事件 ( event ) 经过 post() 发送到总线,而后再分发到匹配事件类型的订阅者 ( subscribers ) 。
订阅者只有在总线中注册 ( register ) 了才能收到事件,注销 ( unrigister ) 以后就收不到任何事件了。
事件方法必须带有 Subscribe 的注解,必须是 public ,没有返回类型 void 而且只能有一个参数。java

EventBus.getDefault()全部事件注册,分发到同一条总线。git

订阅者能够注册到不一样的线上的 EventBus ,经过不一样的 EventBus 实例来发送数据,不一样的 EventBus 是相互隔离开的,订阅者都只会收到注册到该线上事件。
EventBus bus = new EventBus();github


1.订阅:
1.1 订阅者优先级(Subscriber Priorities),能够经过提高优先级来修改事件传递的顺序。EventBus默认的优先级是0。
@Subscribe(priority = 1);
public void onEvent(MessageEvent event) {

}
在相同的线程模式下,高优先级的订阅者将会比低优先级的订阅者更早接收到事件。 
注意:优先级不会影响不一样线程模式下的订阅者接收事件的顺序。app

1.2 父类中定义的订阅方法不能被子类重写。
调用EventBus.getDefault().regist(this)后,EventBus就会查询当前类及其父类中的订阅方法,若是发现父类中也订阅了相同的订阅方法(被子类override了),则会抛出异常ide

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) post

3. Sticky事件:ui

发送粘性事件
EventBus.getDefault().postSticky(new DataSynEvent());this

对于粘性广播咱们都比较清楚属于常驻广播,对于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  
}.net

或者调用移除全部粘性事件:
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); }

相关文章
相关标签/搜索