android EventBus使用 总结

以下由我网上看的文章根据自己理解整理而成,感谢以下文章作者
Hongyang
http://blog.csdn.net/lmj623565791/article/details/40794879
启舰
http://blog.csdn.net/harvic880925/article/details/40787203

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

EventBus简介：

EventBus定义：一款针对Android优化的发布/订阅事件总线。主要功能是替代Intent,Handler,BroadCast在Fragment，Activity，Service，线程之间传递消息.优点是开销小，代码更优雅。以及将发送者和接收者解耦。
四个部分：

1. 发布者(消息发送者)
2. 订阅者(注册EventBus)
3. 事件(消息接收)
4. 总线(注销EventBus)

A activity 跳转到B activity 过后，B activity 发送消息给A activity ，在A activity 里面注册EventBus，注销BevenBus，接受消息 ，整个过程就是这样的

   EventBus.getDefault().post("消息");//发送----->>B activity 里面

  EventBus.getDefault().register(this);//注册------->>A activity OnCreate（）方法
  EventBus.getDefault().unregister(this);//注销-------->>A activity OnDestroy（）方法
    接受消息的方法有四个 依次是：

    onEvent()
    onEventMainThread()
    onEventBackgroundThread()
    onEventAsync()

EventBus四个不同的消息接收处理方法：

onEvent:
使用onEvent，那么该事件在哪个线程发布出来的，onEvent就会在这个线程中运行，也就是说发布事件和接收事件线程在同一个线程。使用这个方法时，在onEvent方法中不能执行耗时操作，如果执行耗时操作容易导致事件分发延迟。

onEventMainThread:
使用onEventMainThread，那么不论事件是在哪个线程中发布出来的，onEventMainThread都会在UI线程中执行，接收事件就会在UI线程中运行，这个在Android中是非常有用的，因为在Android中只能在UI线程中跟新UI，所以在onEvnetMainThread方法中是不能执行耗时操作的。

onEventBackground:
使用onEventBackgrond，那么如果事件是在UI线程中发布出来的，那么onEventBackground就会在子线程中运行，如果事件本来就是子线程中发布出来的，那么onEventBackground函数直接在该子线程中执行。

onEventAsync：
使用onEventAsync，那么无论事件在哪个线程发布，都会创建新的子线程在执行onEventAsync.

一 、注册

在要接收消息的页面注册EventBus：
通过我们会在OnCreate()函数中注册EventBus，在OnDestroy（）函数中反注册。所以整体的注册与反注册的代码如下：

  EventBus.getDefault().register(this);//订阅事件OnCreate()函数

  EventBus.getDefault().unregister(this);//注销事件OnDestroy()函数

声明一个类,通过这个类可以发送消息和接收消息的,(实体)

发送的消息我们发个Msg ：FirstEvent("Hello EventsBus")


public class FirstEvent {

    String Msg;
    public  FirstEvent(String msg){

        this.Msg=msg;
    }

    public String getMsg() {
        return Msg;
    }

    public void setMsg(String msg) {
        Msg = msg;
    }
}

二、发送

这里直接点击按钮发送过去

 btn2.setOnClickListener(new View.OnClickListener() {

            @Override
            public void onClick(View v) {
                EventBus.getDefault().post(
                        new FirstEvent("FirstEvent btn clicked"));
            }
        });

//接收函数1

   public void onEventMainThread(FirstEvent event) {

        String msg = "onEventMainThread收到了消息：" + event.getMsg();
        Log.i("msg", msg);
        Toast.makeText(this, msg, Toast.LENGTH_LONG).show();
    }

这里的EventsBus 消息的发送和接受有个非常经典的总结：

当发送EventsBus 实例的消息过来的时候，消息的接收是根据参数中的类名来执行的

当然现在的EventBus 到了3.0 了 ，其实大体还是一样的，只不过多了几个注解而已

三、注意事项

　　1、注册一般写在onCreate或者onStart中，尽量不要写在onResume，可能出现多次注册，比如：
　　

    //EventBusException: Subscriber class already registered to event class

　　
　　2、取消注册一定写在onDestory,写在onStop可能会引发异常；
　　
　　
　　3、建议注册前先判断一下是否已经注册，避免重复注册，并且注册尽量放在各变量初始化最后，以免造成空指针异常；

    if (!EventBus.getDefault().isRegistered(this)) {
               EventBus.getDefault().register(this);
        }

　　4、3.0和之前版本不兼容，现在采用注解的方法来接收事件，四种注解方式分别为：

　　　　1)　　@Subscrible  对应之前的onEvent();
　　　　2)　　@Subscrible(threadMode = ThreadMode.ASYNC) 对应之前的onEventAsync();
　　　　3)　　@Subscrible(threadMode = ThreadMode.BACKGRAND) 对应之前的onEventBackground();
　　　　4)　　@Subscrible(threadMode = ThreadMode.MAIN) 对应之前的onEventMainThread();

如：

@Subscribe(threadMode = ThreadMode.MAIN)
     public void onEventMainThread(MessageEvent event) {
       //更新UI...
   }

　　5、采用注解后方法名没有限制了，参数只有一个，和发送者post的参数对应配对，未声明threadMode的时候默认线程模式是ThreadMode.POSTING，只有在该模式下才可以取消线程，否则容易导致如下异常：org.greenrobot.eventbus.EventBusException: This method may only be called from inside event handling methods on the posting thread