EventBus-Kotlin的实例应用

EventBus原理

EventBus 是基于观察者模式，核心是事件。EventBus通过注册将所有订阅事件的方法储存在集合中，当有事件发布的时候，根据某些规则，匹配出符合条件的方法，调用执行，从而实现组件间的通信。
发布的事件相当于被观察者，注册的对象相当于观察者，被观察者和观察者是一对多的关系。当被观察者状态发生变化，即发布事件的时候，观察者对象将会得到通知并作出响应，即执行对应的方法。

EventBus三要素

1.事件（Event），是一个对象可以是任意数据类型。
2.事件订阅者（Subscriber），EventBus3.0之后，事件处理的方法可以自由命名，在使用它时需要在方法上面添加一个注解@Subscribe，并写明采用哪种线程模式，默认为POSTING。
3.事件发布者（Publisher），可以用它在任意位置发送事件，需要调用post方法实例化EventBus对象，然后根据破石头函数的参数类型，自动调用订阅这个事件的函数。

EventBus的实例应用

下面简单介绍一个发送“发表评论”事件，然后详情页面通知评论列表作出刷新响应的例子。

0.添加依赖

请参考[https://github.com/greenrobot/EventBus]

implementation 'org.greenrobot:eventbus:3.2.0'

1.自定义一个Event消息事件类

class PublishCommentEvent {
    companion object{
        fun post(){
            EventBusCompat.post(PublishCommentEvent())
        }
    }
}

2.在需要订阅事件的地方注册和注销EventBus

订阅者需要在总线中注册/注销。只有注册后，订阅者才能正常接收到事件。通常我们都在 Activity、Fragment 中订阅事件，需要在生命周期回调函数中做这步。

Activity：在 onCreate 中注册，在 onDestory 中注销。

//详情页面DetailActivity
//注册
Override protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    EventBus.getDefault().register(this);
}
//注销
@Override protected void onDestroy() {
    super.onDestroy();
    EventBus.getDefault().unregister(this);
}

Fragment：在 onCreateView 中注册，在 onDestoryView 中注销。（同上）

3.发送事件

发送事件只需要调用一个 post 方法即可。

//发表评论CommentCreateActivity
override fun addCommentSuccess(bean: NewsCommentListBean) {
        PublishCommentEvent.post()
        finish()
    }

4.处理事件

在 Activity 或 Fragment 中定义一个方法，方法名可以任意指定，参数为要接收的 Event 对象，需要加上 @Subscribe 注解。注解中可以添加线程模型、是否支持粘性事件、优先级属性。其中线程模型是必需的，默认值为 POSTING。

//详情页面DetailActivity
@Subscribe(threadMode = ThreadMode.MAIN)
    fun onPublishCommentEvent(event: PublishCommentEvent) {
    //业务逻辑
        mPage = 1
        mPresenter.getBusinessDetailCommentList(shopId, mPage)
    }

另外

5.粘性事件（StickyEvent）

普通事件必须要订阅者先注册，然后发送事件，才能被订阅者接收到。有的情况下，我们希望即使先发送事件，再注册，订阅者也能接收到。EventBus 提供了粘性事件来满足这种情形。

在发布事件时，改用 postSticky 方法来发送一个粘性事件。

EventBus.getDefault().postSticky(new StringEvent("Hello World!"));

然后在订阅者接收事件方法的 @Subscribe 注解中加上sticky=true，表示支持接收粘性事件。

@Subscribe(sticky = true, threadMode = ThreadMode.MAIN)
public void onStringEvent(StringEvent event) {   
    mTextView.setText(event.message);
}

以上。