[移动开发]android 跨组件/页面 通信传递数据之 eventbus 简单使用.

记录一下。

1.添加依赖

implementation group: 'org.greenrobot', name: 'eventbus', version: '3.2.0'

2.注册观察者（要在哪个地方接收事件），取消注册的观察者（销毁对象的时候调用）

这个观察者只需要是一个对象即可，并不指定为Context

public class MainActivity extends AppCompatActivity {

    private static final String TAG = "MainActivity";
    

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        EventBus.getDefault().register(this);
          //省略其他代码
        '''''''
        '''''''
        '''''''
    }

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

3.发送事件

发送分为两种，一种是黏性事件，一种为普通事件，简单点说，我们在其他异步线程发送了一个事件，但有可能我们的观察者还没有注册，但我们同时希望这个观察者能够收到这个事件，那么就发送黏性事件，即黏性事件可以发送给将来要注册的观察者对象，普通事件就单纯的给已经注册过的观察者发送事件。

//黏性事件
EventBus.getDefault().postSticky(messageEvent);
//messageEvent  这是你自己定义的对象，随便定义，也无需继承任何接口
//普通事件
EventBus.getDefault().post(messageEvent);

4.接收事件

只需要在接收的方法上面添加一个注解就行，上文中我们在MainActivity 中注册成为了观察者，

那么就在这个观察者中继续添加方法接收事件就行：

public class MainActivity extends AppCompatActivity {

    private static final String TAG = "MainActivity";

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        EventBus.getDefault().register(this);
        
        ''''''
        ''''''
    }

    

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

    @Subscribe(priority = 1)
    public void onReceivedStateChanged(MessageEvent messageEvent) {
       ///do something 这个方法名随意取符合java 规范就好，MessageEvent 是上面提到的自己定义的类，请注意，发送和接收必须是同一个类，发送MessageEvent ，接收也是MessageEvent 
          EventBus.getDefault().cancelEventDelivery(messageEvent);
//这个函数是用来取消分发事件，和android 事件分发机制有那么一丢丢相似，意思是这里处理了这件事情之后，我不想让这个事件继续传递给其他观察者对象。
    }
}

千万注意，我代码中默认的处理线程并不一定是UI主线程！，如果你在这里要处理耗时操作，但又要更新UI ，请这样操作：

@Subscribe(priority = 1)
public void onReceivedStateChanged(MessageEvent messageEvent) {
    EventBus.getDefault().cancelEventDelivery(messageEvent);
    //如果你发布事件是在其他线程，你可以在这里处理耗时操作
    runOnUiThread(
                () -> {
                        //在这里更新UI,不要进行耗时操作
                   }
     );
}

强烈推荐在其他线程处理数据，以免APP卡顿.

@Subscribe注解解释：

查看源码包含三个属性：

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface Subscribe {

    /// 这个注解标注的方法运行在哪个线程中
    ThreadMode threadMode() default ThreadMode.POSTING;

    /**
     * If true, delivers the most recent sticky event (posted with
     * {@link EventBus#postSticky(Object)}) to this subscriber (if event available).
     */   
    /// 是否是黏性事件
    boolean sticky() default false;

    /** Subscriber priority to influence the order of event delivery.
     * Within the same delivery thread ({@link ThreadMode}), higher priority subscribers will receive events before
     * others with a lower priority. The default priority is 0. Note: the priority does *NOT* affect the order of
     * delivery among subscribers with different {@link ThreadMode}s! */
    
    int priority() default 0;
}

这几个英语相信大家都能看懂，这里献丑了，简单翻译一下：

• ThreadMode ：

• MainThread 主线程

• BackgroundThread 后台线程

• Async 后台线程

• PostThread 发送线程（默认）

BackgroundThread:当事件是在UI线程发出，那么事件处理实际上是需要新建单独线程，如果是在后台线程发出，那么事件处理就在该线程。该事件处理方法应该是快速的，避免阻塞后台线程。

Async：发送事件方不需要等待事件处理完毕。这种方式适用于该事件处理方法需要较长时间，例如网络请求。

sticky：

黏性事件

priority?

值越小优先级越低，默认为0。

顺便提一下观察者模式，观察者模式其实很容易理解，如果不太明白可以致信邮箱，后续会写个样本上来。

eaaomk@163.com