EventBus出来已经很长时间了,如今更新到了3.0
,但是项目中一直没有用到,所以整理记录一下。
一般就是以下4点:
EventBus.getDefault().register(this);//订阅事件
EventBus.getDefault().post(object);//发布事件
EventBus.getDefault().unregister(this);//取消订阅
@Subscribe(threadMode = ThreadMode.MAIN)//处理事件
public void receiveMessage(CustomEvent event) {
}
线程模式
EventBus的事件处理函数中需要指定线程模型,也就是指定事件处理函数运行所在的线程。
在EventBus中的观察者通常有四种线程模型,分别是PostThread(默认)、MainThread、BackgroundThread与Async。
那他们有什么区别呢?
ThreadMode.POSTING:如果使用事件处理函数指定了此线程模型,那么该事件在哪个线程发布出来的,事件处理函数就会在这个线程中运行,也就是说发布事件和接收事件在同一个线程。在线程模型为ThreadMode.POSTING的事件处理函数中尽量避免执行耗时操作,因为它会阻塞事件的传递,甚至有可能会引起ANR(相当于3.0之前的onEvent)。
ThreadMode.Main:如果使用事件处理函数指定了此线程模型,那么不论事件是在哪个线程中发布出来的,该事件处理函数都会在UI线程中执行。该方法可以用来更新UI,但是不能处理耗时操作。
ThreadMode.BACKGROUND:如果使用事件处理函数指定了此线程模型,那么如果事件是在UI线程中发布出来的,那么该事件处理函数就会在新的线程中运行,如果事件本来就是子线程中发布出来的,那么该事件处理函数直接在发布事件的线程中执行。在此事件处理函数中禁止进行UI更新操作。
ThreadMode.ASYNC:如果使用事件处理函数指定了此线程模型,那么无论事件在哪个线程发布,该事件处理函数都会在新建的子线程中执行。同样,此事件处理函数中禁止进行UI更新操作。
普通事件
1、注册:
EventBus.getDefault().register(this);
2、发布事件:
findViewById(R.id.btn_first_event).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
EventBus.getDefault().post(new CustomEvent("CustomEvent btn clicked"));
}
});
3、处理订阅:
@Subscribe(threadMode = ThreadMode.MAIN)
public void receiveMessage(CustomEvent event) {
String msg = "receiveMessage收到了消息:" + event.getMsg();
showEventText.setText(msg);
Toast toast = Toast.makeText(this, msg, Toast.LENGTH_LONG);
toast.setGravity(Gravity.CENTER, 0, 0);
toast.show();
}
4、反注册:
EventBus.getDefault().unregister(this);//反注册EventBus
粘性事件
关于粘性事件,可以参考Android的广播机制,其中有一个粘性广播,粘性广播的意思是:该广播发送后,会保存在内存中,如果后来有注册的Receiver与之匹配,那么该Receiver便会接收到该广播。那么粘性事件同理,在注册之前便把事件发生出去,等到注册之后便会收到最近发送的粘性事件(必须匹配)。注意:只会接收到最近发送的一次粘性事件,之前的会接收不到。
粘性事件与普通事件注册与反注册相同,不同之处在于发布事件和处理事件。
发送粘性事件方法:
EventBus.getDefault().postSticky(new StickyEvent("StickyEvent btn clicked"));
处理事件方法:
@Subscribe(threadMode = ThreadMode.MAIN, sticky = true)
public void receiveStickyMessage(StickyEvent event) {
String msg = "receiveStickyMessage收到了消息:" + event.getMsg();
showStickyText.setText(msg);
Toast toast = Toast.makeText(this, msg, Toast.LENGTH_LONG);
toast.setGravity(Gravity.CENTER, 0, 0);
toast.show();
}