Android事件总线——EventBus的使用

前言

首先我们来说下事件总线，它的作用：为了更简化并更高质量的在Activity，Fragment，Thread和Service等之间的通信，解决组件之间高耦合的同时仍能进行高效的通信。

什么是EventBus

EventBus 是一款针对Android优化的发布－订阅事件总线，简化了应用程序中的各个组件与后台线程间的通信。

其优点是开销小，代码更优雅，将发送者和接收者解耦。

EventBus的使用

EventBus三要素

Event：事件。（任意类型）

Subscriber：事件订阅者。在EventBus3.0之前仅限定于4种线程模型（onEvent，onEventMainThread，onEventBackgroundThread和onEventAysnc）。而在EventBus3.0之后，事件处理方法任意命名，但必须添加一个注解@Subscribe，并指定线程模型（默认为POSTING）。

Publisher：事件发布者。调用EventBus的post(Object)。根据post参数类型，自动调用相应事件的函数。

EventBus4种ThreadMode（线程模型）

POSTING（默认）：发布事件和接收事件在同一个线程。在使用该线程模型事件处理函数中尽量避免执行耗时操作，会导致线程阻塞，甚至引发ANR异常。

MAIN：处理事件在UI线程执行。事件处理的事件不能太长，太长会导致ANR。

BACKGROUND：如果事件在UI线程发布，则该事件函数处理在新的线程中运行；如果事件在子线程发布，则事件函数处理直接在发布线程中运行。此事件处理函数禁止更行UI操作。

ASYNC：无论事件在哪个线程发布，该事件函数处理都会在新建的子线程中执行。同样，该事件处理函数禁止更行UI操作。

EventBus的基本用法

（1） 自定义一个事件类

public class MessageEvent{
...
}

（2）在需要订阅该事件的地方注册事件

EventBus.getDefault().register(this);

（3）发送事件

EventBus.getDefault().post(messageEvent);

（4）处理事件

@Subscribe(threadMode = ThreadMode.MAIN)
public void XXX(MessageEvent messageEvent){
...
}

（5）取消注册事件

EventBus.getDefault().unregister(this);

代码示例

（1）添加依赖库

compile 'org.greenrobot:eventbus:3.0.0'

（2）定义消息事件类

public class MessageEvent {

private String message;

public MessageEvent(String message) {
this.message = message;
}

public String getMessage() {
return message;
}

public void setMessage(String message) {
this.message = message;
}
}

（3）注册和取消订阅事件

public class MainActivity extends AppCompatActivity {

private TextView tv_message;
private Button btn_subscription, btn_message;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

tv_message = (TextView) findViewById(R.id.tv_message);
tv_message.setText("MainActivity");

btn_subscription = (Button) findViewById(R.id.btn_subscription);
btn_subscription.setText("注册事件");

btn_message = (Button) findViewById(R.id.btn_message);
btn_message.setText("跳转到SecondActivity");

btn_subscription.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
//注册事件
EventBus.getDefault().register(MainActivity.this);
}
});

btn_message.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
startActivity(new Intent(MainActivity.this, SecondActivity.class));
}
});
}

@Override
protected void onDestroy() {
super.onDestroy();
//取消注册事件
EventBus.getDefault().unregister(MainActivity.class);
}
}

（4）事件订阅者处理事件

在MainActivity中自定义方法来处理事件。

@Subscribe(threadMode = ThreadMode.MAIN)
public void onMoonEvent(MessageEvent messageBean) {
//展示收到的消息
tv_message.setText(messageBean.getMessage());
}

（5）事件发布者发布事件

创建SecondActivity发布消息。

public class SecondActivity extends AppCompatActivity {

private TextView tv_message;
private Button btn_message;

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_second);

tv_message = (TextView) findViewById(R.id.tv_message);
tv_message.setText("SecondActivity");

btn_message = (Button) findViewById(R.id.btn_message);
btn_message.setText("发送事件");

btn_message.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
EventBus.getDefault().post(new MessageEvent("欢迎学习EventBus"));
finish();
}
});
}
}

运行程序如下，当我们点击MainActivity中的“注册事件”按钮来注册事件，然后点击“跳转到SECONDACTIVITY”按钮，跳转到SecondActivity。接下来我们点击“发送事件”，这时候finishSecondActivity，显示MainActivity，TextView显示“欢迎学习EventBus”。这样MainActivity成功的接收到了SecondActivity中发送的事件。如图：

EventBus的黏性事件

EventBus黏性事件，就是发送该事件之后再订阅该事件也能收到该事件。修改代码如下：

（1）订阅者处理黏性事件

@Subscribe(threadMode = ThreadMode.POSTING,sticky = true)
public void onMoonStickyEvent(MessageEvent messageEvent){
tv_message.setText(messageEvent.getMessage());
}

（2）发送黏性事件

在SecondActivity中定义Button发送黏性事件。

btn_subscription.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
EventBus.getDefault().postSticky(new MessageEvent("黏性事件"));
finish();
}
});

现在我们运行程序，在我们的MainActivity中没有点击“注册事件”，直接跳转到SecondActivity中发送黏性事件。这时回到我们的MainActivity界面。



————————————>



接下来我们点击注册事件，你会发现TextView发生改变显示“粘性事件”，这时大功告成。

ProGuard 混淆规则

-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);
}

总结

欢迎童鞋们学习EventBus的基本使用。

更多请查看：

EventBus的github地址：https://github.com/greenrobot/EventBus

EventBus官网：http://greenrobot.org/eventbus/