EventBus的基本使用 eventbus

基本的使用

定义events

Events通常是一个POJO(plain old Java object).可以根据需要，随便定义。可以定义多种类型的events，事件处理函数根据事件的类型实现重载。events除了自定义，还可以是Java中的基本类型(int, boolean等)。
public class MessageEvent{ public String message;

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

}

注册订阅者

只有需要接收events的地方，才需要注册订阅者。只是发送事件的话，不必注册。在Acitvity中注册和注销订阅者：

@Override public void onStart() { super.onStart(); EventBus.getDefault().register(this); }@Override public void onStop() { EventBus.getDefault().unregister(this); super.onStop(); }

添加events处理函数

其实添加events处理函数也是注册订阅者的一部分，它们俩一起完成了注册任务。在注册了订阅者的地方，添加事件处理函数。

// This method will be called when a MessageEvent is posted public void onEvent(MessageEvent event){ Toast.makeText(getActivity(), event.message, Toast.LENGTH_SHORT).show(); }// This method will be called when a SomeOtherEvent is posted public void onEvent(SomeOtherEvent event){ doSomethingWith(event); }

有两点需要注意：
事件处理函数必须有参数，且只能有一个参数。函数根据这个参数的类型，实现重载的功能。事件处理函数的名字必须以onEvent开头，且必须是以下四种： onEvent onEventMainThread onEventBackgroundThread onEventAsync

发送events

可以在任何地方发送一个事件。所有注册了这个事件类型的订阅者都可以收到它。
EventBus.getDefault().post(new MessageEvent("Hello everyone!")); 这里有两点需要注意：
如果event是基本类型，发送时event会被自动装箱。因此事件处理函数（onEvent）的参数类型必须是基本类型对应的对象类型。所有注册了event对象的父类的订阅者，都可以收到这个event。也就是说，如果某个订阅者的某个事件处理函数的参数是Object类型
onEvent(Object object) 那么所有发出去的event，它都可以收到。
线程模型 EventBus可以自动处理线程问题，使我们从后台线程与UI线程的切换中解放出来。
在EventBus中，通过约定事件处理函数名称的方式，决定在哪个线程中执行事件处理方法。
onEvent 对应PostThread模型，事件处理函数将会在事件发送者的线程上执行。这种模式，不需要切换线程，是最快速的，推荐默认采用。 onEventMainThread 对应MainThread模型，事件处理函数将会在主线程上执行。 onEventBackgroundThread 对应BackgroundThread模型，如果发送线程不是主线程，那么事件处理函数将会直接在发送线程调用。如果发送线程是主线程，那么EventBus会启用一个后台线程执行事件处理函数。 onEventAsync 对应Async模型，EventBus会启用一个单独的线程(既不是发送线程，又不是主线程)执行事件处理函数。EventBus会使用线程池，重用线程。设定优先级可以在注册的时候,设置订阅者的优先级。

int priority = 1; EventBus.getDefault().register(this, priority);

高优先级的订阅者，可以先接收到事件。默认的优先级是0. 这里有一点需要注意，用官方文档的话说就是：
Note: the priority does NOT affect the order of delivery among subscribers with different ThreadModes! 也就是说，两个订阅者：subscribe1和subscribe2，subscribe1的优先级较高，那么subscribe1的onEvent函数肯定比subscribe2的onEvent函数先接收到事件，onEventBackgroundThread函数也肯定比subscribe2的onEventBackgroundThread优先。但是不能比较subscribe1的onEvent和subscribe2的onEventBackgroundThread，因为它们的线程模型不同，可能在不同的线程上。
取消events的传递高优先级的订阅者可以在事件处理函数中取消事件的传递。

// Called in the same thread (default) public void onEvent(MessageEvent event){ // Process the event ...EventBus.getDefault().cancelEventDelivery(event) ; }

Sticky Events Sticky Events可以用于需要延迟接收事件的情况。普通的事件发送出去以后，EventBus便不再持有了，因此后续注册的订阅者无法接收到它。但是sticky事件不同，EventBus会在内存中为每一种事件类型保存一个最新发送的事件，直到后续发送新的sticky事件，把它覆盖掉。因此后续注册的订阅者，依然可以从内存中得到这个已发送的sticky事件。发送sticky事件：
EventBus.getDefault().postSticky(new MessageEvent("Hello everyone!")); 注册sticky订阅者：

@Override public void onStart() { super.onStart(); EventBus.getDefault().registerSticky(this); }public void onEventMainThread(MessageEvent event) { textField.setText(event.message); }@Override public void onStop() { EventBus.getDefault().unregister(this); super.onStop(); }

也可以直接直接获得某个类型的sticky事件：
EventBus.getDefault().getStickyEvent(Class eventType) 有两点需要注意：
【EventBus的基本使用】 sticky类型的订阅者，依然可以收到普通类型的event；但是普通类型的订阅者收不到sticky类型的event 某个类型，只有最新的事件才会被保存