EventBus实例

一、概述

• 下载地址

  地址：https://github.com/greenrobot/EventBus，是个不错的组件间通信框架，主要用于事件的发布和订阅。

• EventBus定义

  它是一个发布 / 订阅的事件总线。
  它包含4个成分：发布者，订阅者，事件，总线。
  订阅者可以订阅多个事件，发送者可以发布任何事件，发布者同时也可以是订阅者。

• 应用场景

  例如：两个Fragment组成主界面，左边的Fragment是个目录，右边的Fragment是详细信息面板；
  a、目录的列表是从网络获取的。
  b、当点击目录上的条目时，动态更新详细信息面板；

  看了这个需求，我们传统的做法是：
  a、目录Fragment在onCreate中去开启线程去访问网络获取数据，获取完成以后，通过handler去更新界面。
  b、在目录的Fragment中提供一个接口，然后详细信息面板去注册这个接口，当发生点击时，去回调这个接口，让详细信息面板发生改变。

• EventBus使用

  EventBus.getDefault().register(this);//订阅事件
  EventBus.getDefault().post(object);//发布事件
  EventBus.getDefault().unregister(this);//取消订阅

二、代码演示

1.MainActivity及其布局

public class MainActivity extends FragmentActivity  {      @Override      protected void onCreate(Bundle savedInstanceState)      {          super.onCreate(savedInstanceState);          setContentView(R.layout.activity_main);      }  }  

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"      xmlns:tools="http://schemas.android.com/tools"      android:layout_width="match_parent"      android:layout_height="match_parent"      android:baselineAligned="false"      android:divider="?android:attr/dividerHorizontal"      android:orientation="horizontal"      android:showDividers="middle" >    <fragment          android:id="@+id/item_list"          android:name="com.angeldevil.eventbusdemo.ItemListFragment"          android:layout_width="0dip"          android:layout_height="match_parent"          android:layout_weight="1" />      <fragment          android:id="@+id/item_detail_container"          android:name="com.angeldevil.eventbusdemo.ItemDetailFragment"          android:layout_width="0dip"          android:layout_height="match_parent"          android:layout_weight="2" />  </LinearLayout>

可以看到，我们MainActvity可以说没有一行代码，布局文件即两个Fragment组成；

2.Event事件类

public class Event  {      /** 列表加载事件 */      public static class ItemListEvent      {          private List<Item> items;          public ItemListEvent(List<Item> items)          {              this.items = items;          }          public List<Item> getItems()          {              return items;          }      }  }  

3. ItemListFragment

public class ItemListFragment extends ListFragment  {      @Override      public void onCreate(Bundle savedInstanceState)      {          super.onCreate(savedInstanceState);          EventBus.getDefault().register(this);  // Register    }      @Override      public void onDestroy()      {          super.onDestroy();          EventBus.getDefault().unregister(this);  // Unregister      }      @Override      public void onViewCreated(View view, Bundle savedInstanceState)      {          super.onViewCreated(view, savedInstanceState);          new Thread()   // 开启线程加载列表          {              public void run()              {                  try                  {                      Thread.sleep(2000); // 模拟延时                      EventBus.getDefault().post(new ItemListEvent(Item.ITEMS));//发布事件，在后台线程发的事件                  } catch (InterruptedException e)                  {                      e.printStackTrace();                  }              };          }.start();      }      public void onEventMainThread(ItemListEvent event)      {          setListAdapter(new ArrayAdapter<Item>(getActivity(),                  android.R.layout.simple_list_item_activated_1,                  android.R.id.text1, event.getItems()));      }      @Override      public void onListItemClick(ListView listView, View view, int position,              long id)      {          super.onListItemClick(listView, view, position, id);          EventBus.getDefault().post(getListView().getItemAtPosition(position));      }  }  

• 说明：
  ItemListFragment里面在onCreate里面进行了事件的订阅，onDestroy里面进行了事件的取消；onViewCreated中我们模拟了一个子线程去网络加载数据，获取成功后我们调用了EventBus.getDefault().post(new ItemListEvent(Item.ITEMS));发布了一个事件；
  细心的你一定发现了一些诡异的事，直接new Thread()获取到数据以后，竟然没有使用handler；我们界面竟然发生了变化，那么List是何时绑定的数据？

• 仔细看下代码，发现这个方法：

public void onEventMainThread(ItemListEvent event){    setListAdapter(new ArrayAdapter<Item>(getActivity(),            android.R.layout.simple_list_item_activated_1,            android.R.id.text1, event.getItems()));}

• 执行原理
  在onCreate里面执行 EventBus.getDefault().register(this);意思是让EventBus扫描当前类，把所有onEvent开头的方法记录下来，如何记录呢？使用Map，Key为方法的参数类型，Value中包含我们的方法。
  这样在onCreate执行完成以后，我们的onEventMainThread就已经以键值对的方式被存储到EventBus中了。
  然后当子线程执行完毕，调用EventBus.getDefault().post(new ItemListEvent(Item.ITEMS))时，EventBus会根据post中实参的类型，去Map中查找对于的方法，于是找到了我们的onEventMainThread，最终调用反射去执行我们的方法。

• 结论
  现在我们在看看代码，当Item点击的时候EventBus.getDefault().post(getListView().getItemAtPosition(position));我们同样发布了一个事件，参数为Item；这个事件是为了让详细信息的Fragment去更新数据，不用说，按照上面的推测，详细信息的Fragment里面一个有个这样的方法： public void onEventMainThread(Item item) ；

4. ItemDetailFragment

public class ItemDetailFragment extends Fragment  {      private TextView tvDetail;      @Override      public void onCreate(Bundle savedInstanceState)      {          super.onCreate(savedInstanceState);          EventBus.getDefault().register(this);  // register      }      @Override      public void onDestroy()      {          super.onDestroy();          EventBus.getDefault().unregister(this);  // Unregister      }      /** List点击时会发送些事件，接收到事件后更新详情 */      public void onEventMainThread(Item item)      {          if (item != null)  tvDetail.setText(item.content);      }      @Override      public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState)      {          View rootView = inflater.inflate(R.layout.fragment_item_detail,  container, false);          tvDetail = (TextView) rootView.findViewById(R.id.item_detail);          return rootView;      }  }

• 结论：
  果然不出我们的所料，真的存在onEventMainThread(Item item)的方法。当然了，必须在onCreate里面首先书写EventBus.getDefault().register(this);让EventBus扫描再说。
  那么这个Fragment的流程就是：onCreate时，EventBus扫描当前类，将onEventMainThread以键值对的形式进行存储，键为Item.class ，值为包含该方法的对象。
  然后当ItemListFragment中Item被点击时，发布了一个事件：EventBus.getDefault().post(getListView().getItemAtPosition(position));实参的类型恰好是Item，于是触发我们的onEventMainThread方法，并把Item实参传递进来，我们更新控件。

三、EventBus的ThreadMode

• 简介
  EventBus包含4个ThreadMode：PostThread，MainThread，BackgroundThread，Async
  MainThread我们已经不陌生了；我们已经使用过。
  具体的用法，极其简单，方法名为：onEventPostThread， onEventMainThread，onEventBackgroundThread，onEventAsync即可

• 具体什么区别呢？

  1. onEventMainThread代表这个方法会在UI线程执行
  2. onEventPostThread代表这个方法会在当前发布事件的线程执行
  3. BackgroundThread这个方法，如果在非UI线程发布的事件，则直接执行，和发布在同一个线程中。如果在UI线程发布的事件，则加入后台任务队列，使用线程池一个接一个调用。
  4. Async 加入后台任务队列，使用线程池调用，注意没有BackgroundThread中的一个接一个。