EventBus之粘性事件(Sticky Events)

Sticky Events

有些事件在事件发布后携带有感兴趣的信息。例如，一个事件表示某个初始化已经完成。或者如果你有一些传感器或位置数据，你想要保持最近的值。您可以使用粘性事件，而不是实现自己的缓存。因此EventBus将某个类型的最后一个粘性事件保存在内存中。然后可以将粘性事件交付给订阅者或显式查询。因此，您不需要任何特殊的逻辑来考虑已经可用的数据。

示例：

可以在订阅都订阅之前，首先发送一个粘性事件：

 EventBus.getDefault().postSticky(eventData);

在订阅者的注册过程中，所有的粘性订阅者方法将立即得到之前发布的粘性事件：

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_sticky);
        mTvMessage = (TextView) this.findViewById(R.id.tv_message);
        EventBus.getDefault().register(this);
    }

    // UI updates must run on MainThread
    @Subscribe(sticky = true, threadMode = ThreadMode.MAIN)
    public void refreshMessage(final EventData eventData) {
        Log.i(TAG, "method:refreshMessage#eventData=" + eventData);
        mTvMessage.setText("已经接收到 eventData=" + eventData.toString());
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        EventBus.getDefault().unregister(this);
    }

手动获取和删除粘性事件：

正如您所看到的，当匹配的订阅者注册时，最后一个粘附事件将自动交付给他们。但有时手动检查粘性事件可能更方便。此外，可能还需要删除(消耗)粘性事件，以便不再交付它们。示例：

        EventData stickyEventData = EventBus.getDefault().getStickyEvent(EventData.class);
        // Better check that an event was actually posted before
        if(stickyEventData != null) {
            // "Consume" the sticky event
            EventBus.getDefault().removeStickyEvent(stickyEventData);
            // Now do something with it
        }

方法：removeStickyEvent 重载:当您传递类时，它将返回以前保存的粘性事件。使用这个变量，我们可以改进前面的例子：

        EventData stickyEventData = EventBus.getDefault().removeStickyEvent(EventData.class);
        // Better check that an event was actually posted before
        if(stickyEventData != null) {
            // Now do something with it
        }

另外的移除方法：

根据某个事件对象进行移除，如果事件匹配且粘性事件被删除，则为true。

        boolean b = EventBus.getDefault().removeStickyEvent(eventData);

移除所有粘性事件：

EventBus.getDefault().removeAllStickyEvents();

 

GitHub地址

由于作者水平有限，语言描述及代码实现中难免有纰漏，望各位看官多提宝贵意见！

Hello , World !

感谢所有！