EventBus的使用非常简单,主要分为3个步骤:
定义事件。
订阅事件。
发布事件。
第一步,定义事件。事件可以是任意普通的Java对象,没有任何特殊的要求。例如:
public class MessageEvent{
privateString message;
public MessageEvent(String message){
this.message = message;
}
public Stringget Message(){
return message;
}
public void setMessage(String message){
this.message = message;
}
}
第二步,订阅事件。订阅者需要定义事件处理方法(也称为订阅者方法)。当发布对应类型的事件时,该方法将被调用。EventBus 3使用@Subscribe注解来定义订阅者方法。方法名可以是任意合法的方法名,参数类型为订阅事件的类型。例如:
@Subscribe(threadMode = ThreadMode.MAIN)
public void onMessageEvent(MessageEvent event){
...
}
订阅者还需要在总线上注册,并在不需要时在总线上注销。只有订阅者注册了,它们才会收到事件。在Android中,可以根据Activity或者Fragment的生命周期来注册和注销。例如:
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initContentView();
// 注册订阅者
EventBus.getDefault().register(this);
}
@Override
protectedvoidonDestroy(){
super.onDestroy();
// 注销订阅者
EventBus.getDefault().unregister(this);
}
第三步,发布事件。在需要的地方发布事件,所有订阅了该类型事件并已注册的订阅者将收到该事件。例如:
// 发布事件
EventBus.getDefault().post(new MessageEvent("Hello EventBus!"));
下面是一个例子。订阅事件的代码如下所示:
public class MainActivity extends AppCompatActivity implements View.OnClickListener{
private static final String TAG ="MainActivity";
private TextView mTvMessage;
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initContentView();
// 注册订阅者
EventBus.getDefault().register(this);
}
private void initContentView(){
Button btnStart = findViewById(R.id.btn_main_start_activity);
mTvMessage = findViewById(R.id.tv_main_message);
btnStart.setOnClickListener(this);
}
@Override
publicvoidonClick(View v){
if(v.getId() == R.id.btn_main_start_activity) {
SecondActivity.start(this);
}
}
@Subscribe(threadMode = ThreadMode.MAIN)
public void onMessageEvent(MessageEvent event){
Log.i(TAG,"message is "+ event.getMessage());
// 更新界面
mTvMessage.setText(event.getMessage());
}
@Override
protectedvoidonDestroy(){
super.onDestroy();
// 注销订阅者
EventBus.getDefault().unregister(this);
}
}
MainActivity订阅了MessageEvent事件。当接收到MessageEvent事件时,订阅者方法将打印日志消息,并更新界面上的TextView。
发布事件的代码如下所示:
public class SecondActivity extends AppCompatActivity implements View.OnClickListener{
public static void start(Context context){
Intent intent =new Intent(context, SecondActivity.class);
context.startActivity(intent);
}
@Override
protected void onCreate(Bundle savedInstanceState){
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_second);
initContentView();
}
private void initContentView(){
findViewById(R.id.btn_second_post_event).setOnClickListener(this);
}
@Override
public void onClick(View v){
if(v.getId() == R.id.btn_second_post_event) {
// 发布事件
EventBus.getDefault().post(newMessageEvent("Hello EventBus!"));
}
}
}
网友评论