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 !

感谢所有!

上一篇:gradient 线性渐变 浏览器兼容


下一篇:UGUI_事件执行类ExecuteEvents