目录
0、相关视频:
EventBus (2017.12.8)
1、相关文章:
Android EventBus 的使用(文章1:阅读量6w,40赞)
Android EventBus3.0实例使用详解及封装调用(阅读量3000,1赞)
EventBus使用详解(一)——初步使用EventBus(2014.10.31,阅读量38w,250赞,启舰大神的)
2、EventBus 简介
参照文章1写
EventBus是一种用于Android的事件发布-订阅总线,由GreenRobot开发,Gihub地址是:EventBus。它简化了应用程序内各个组件之间进行通信的复杂度,尤其是碎片之间进行通信的问题,可以避免由于使用广播通信而带来的诸多不便。
2.1、 三个角色
- Event:事件,它可以是任意类型,EventBus会根据事件类型进行全局的通知。
- Subscriber:事件订阅者,在EventBus 3.0之前我们必须定义以onEvent开头的那几个方法,分别是
onEvent
、onEventMainThread
、onEventBackgroundThread
和onEventAsync
,而在3.0之后事件处理的方法名可以随意取,不过需要加上注解@subscribe
,并且指定线程模型,默认是POSTING
。 - Publisher:事件的发布者,可以在任意线程里发布事件。一般情况下,使用
EventBus.getDefault()
就可以得到一个EventBus对象,然后再调用post(Object)
方法即可。
2.2、四种线程模型
EventBus3.0有四种线程模型,分别是:
- POSTING:默认,表示事件处理函数的线程跟发布事件的线程在同一个线程。
- MAIN:表示事件处理函数的线程在主线程(UI)线程,因此在这里不能进行耗时操作。
- BACKGROUND:表示事件处理函数的线程在后台线程,因此不能进行UI操作。如果发布事件的线程是主线程(UI线程),那么事件处理函数将会开启一个后台线程,如果果发布事件的线程是在后台线程,那么事件处理函数就使用该线程。
- ASYNC:表示无论事件发布的线程是哪一个,事件处理函数始终会新建一个子线程运行,同样不能进行UI操作。
3、EventBus 使用
3.1、引入依赖
implementation 'org.greenrobot:eventbus:3.1.1'
3.2、定义事件
然后,我们定义一个事件的封装对象。在程序内部就使用该对象作为通信的信息:
public class MessageWrap {
public final String message;
public static MessageWrap getInstance(String message) {
return new MessageWrap(message);
}
private MessageWrap(String message) {
this.message = message;
}
}
3.3、发布事件
使用两个Activity:EventBusTest1Activity用于注册EventBus和接收消息,EventBusTest2Activity用于发送消息
public class EventBusTest1Activity extends BaseActivity {
@BindView(R.id.btn1)
Button btn1;
@BindView(R.id.btn2)
Button btn2;
@BindView(R.id.btn3)
Button btn3;
@BindView(R.id.btn4)
Button btn4;
@BindView(R.id.tvMessage)
TextView tvMessage;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_event_bus_test1);
ButterKnife.bind(this);
}
@OnClick({R.id.btn1, R.id.btn2, R.id.btn3, R.id.btn4})
public void onViewClicked(View view) {
switch (view.getId()) {
case R.id.btn1:
EventBus.getDefault().register(this);
break;
case R.id.btn2:
readyGo(EventBusTest2Activity.class);
break;
case R.id.btn3:
break;
case R.id.btn4:
break;
}
}
@Subscribe(threadMode = ThreadMode.MAIN)
public void onGetMessage(MessageWrap message) {
tvMessage.setText(message.message);
}
@Override
protected void onDestroy() {
super.onDestroy();
EventBus.getDefault().unregister(this);
}
}
public class EventBusTest2Activity extends AppCompatActivity {
@BindView(R.id.etInput)
EditText etInput;
@BindView(R.id.btnSendMsg)
Button btnSendMsg;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_event_bus_test2);
ButterKnife.bind(this);
}
@OnClick(R.id.btnSendMsg)
public void onViewClicked() {
String message = etInput.getText().toString();
EventBus.getDefault().post(MessageWrap.getInstance(message));
}
}
3.4、黏性事件
所谓的黏性事件,就是指发送了该事件之后再注册EventBus,订阅者依然能够接收到的事件。使用黏性事件的时候有两个地方需要做些修改。一个是订阅事件的地方,这里我们在先打开的Activity中注册监听黏性事件:
@Subscribe(threadMode = ThreadMode.MAIN, sticky = true)
public void onGetStickyMessage(MessageWrap message) {
tvMessage.setText(message.message);
}
另一个是发布事件的地方,这里我们在新的开的Activity中发布黏性事件。即调用EventBus的postSticky
方法来发布事件:
String message2 = etInput.getText().toString();
EventBus.getDefault().postSticky(MessageWrap.getInstance(message2));
3.5、优先级
在Subscribe
注解中总共有3个参数,上面我们用到了其中的两个,这里我们使用以下第三个参数,即priority
。它用来指定订阅方法的优先级,是一个整数类型的值,默认是0,值越大表示优先级越大。在某个事件被发布出来的时候,优先级较高的订阅方法会首先接受到事件。
为了对优先级进行测试,这里我们需要对上面的代码进行一些修改。这里,我们使用一个布尔类型的变量来判断是否应该取消事件的分发。我们在一个较高优先级的方法中通过该布尔值进行判断,如果未true
就停止该事件的继续分发,从而通过低优先级的订阅方法无法获取到事件来证明优先级较高的订阅方法率先获取到了事件。
这里有几个地方需要注意:
- 只有当两个订阅方法使用相同的
ThreadMode
参数的时候,它们的优先级才会与priority
指定的值一致; - 只有当某个订阅方法的
ThreadMode
参数为POSTING
的时候,它才能停止该事件的继续分发。