Android 框架学习1：EventBus 3.0 的特点与如何使用

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface Subscribe {
    //注册方法所在线程
    ThreadMode threadMode() default ThreadMode.POSTING;    //默认与发生方法在同一线程

    //是否为粘性事件
    boolean sticky() default false;

    //注册方法接收消息的优先级，当同一线程有多个注册方法时有效
    int priority() default 0;
}

@Subscribe(threadMode = ThreadMode.POSTING)
public void onMessage(MessageEvent event) {
    log(event.message);
}

@Subscribe(sticky = true)
public void readStickyMsg(MessageEvent event){
    //...
}

@Subscribe(priority = 1);
public void onEvent(MessageEvent event) {
    ...
}

@Subscribe
public void onEvent(MessageEvent event){
    // Process the event
    ...
    // Prevent delivery to other subscribers
    EventBus.getDefault().cancelEventDelivery(event) ;
}
Pasted from: http://greenrobot.org/eventbus/documentation/priorities-and-event-cancellation/

EventBus eventBus = EventBus.builder()
    .logNoSubscriberMessages(false)
    .sendNoSubscriberEvent(false)
    .build();

boolean logSubscriberExceptions = true;
boolean logNoSubscriberMessages = true;
boolean sendSubscriberExceptionEvent = true;
boolean sendNoSubscriberEvent = true;
boolean throwSubscriberException;
boolean eventInheritance = true;
boolean ignoreGeneratedIndex;
boolean strictMethodVerification;
ExecutorService executorService = DEFAULT_EXECUTOR_SERVICE;
List<Class<?>> skipMethodVerificationForClasses;
List<SubscriberInfoIndex> subscriberInfoIndexes;

AsyncExecutor.create().execute(
    new AsyncExecutor.RunnableEx() {
        @Override
        public void run() throws LoginException {
            // No need to catch any Exception (here: LoginException)
            remote.login();
            EventBus.getDefault().postSticky(new LoggedInEvent());
        }
    }
);
Pasted from: http://greenrobot.org/eventbus/documentation/asyncexecutor/

@Subscribe(threadMode = ThreadMode.MAIN)
public void handleFailureEvent(ThrowableFailureEvent event) {
    // do something
}

classpath 'com.neenbedankt.gradle.plugins:android-apt:1.8'

apply plugin: 'android-apt'
apt {
    arguments {
        eventBusIndex "top.shixinzhang.MyEventBusIndex"
    }
}
dependencies {
    compile 'org.greenrobot:eventbus:3.0.0'
    apt 'org.greenrobot:eventbus-annotation-processor:3.0.1'
}

public class MessageEvent implements Serializable {
    private static final long serialVersionUID = -1371779234999786464L;
    private String message;
    private String time;

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

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    public String getTime() {
        return time;
    }

    public void setTime(String time) {
        this.time = time;
    }
}

public class EventBusRegisterActivity extends AppCompatActivity {

    @BindView(R.id.tv_event_info)
    TextView mTvEventInfo;
    @BindView(R.id.tv_event_info_priority)
    TextView mTvEventInfoPriority;
    @BindView(R.id.btn_cancel_delivery)
    Button mBtnCancelDelivery;
    private boolean mCancelDelivery;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_event_bus_test);
        ButterKnife.bind(this);
    }

    /**
     * 订阅方法，设置线程为 POSTING，优先级为 5
     * @param event
     */
    @Subscribe(threadMode = ThreadMode.POSTING, priority = 5)
    public void readMessageFirst(MessageEvent event) {
        mTvEventInfoPriority.setText("\n" + event.getMessage() + ", " + event.getTime());
        if (mCancelDelivery) {
            EventBus.getDefault().cancelEventDelivery(event);
        }
    }

    @Subscribe(threadMode = ThreadMode.POSTING, priority = 1)
    public void readMessage(MessageEvent event) {
        mTvEventInfo.setText("\n" + event.getMessage() + ", " + event.getTime());
    }

    /**
     * 为了演示效果，我们在按钮点击事件中注册事件
     */
    @OnClick(R.id.btn_register_normal)
    public void registerNormal() {
        if (!EventBus.getDefault().isRegistered(this)) {
            EventBus.getDefault().register(this);
        }
    }

    @OnClick(R.id.btn_unregister_normal)
    public void unregisterNormal() {
        EventBus.getDefault().unregister(this);
    }


    @OnClick(R.id.btn_cancel_delivery)
    public void cancelDelivery() {
        mCancelDelivery = !mCancelDelivery;
        mBtnCancelDelivery.setText(mCancelDelivery ? "已拦截事件传递" : "点击拦截事件传递");
    }

    @OnClick(R.id.btn_jump_next)
    public void jumpToNext() {
        startActivity(new Intent(this, EventBusPosterActivity.class));
    }


    @OnClick(R.id.btn_jump_sticky)
    public void jumpToSticky() {
        startActivity(new Intent(this, EventBusStickyActivity.class));
    }


    @Override
    protected void onDestroy() {
        super.onDestroy();
    }
}

public class EventBusStickyActivity extends AppCompatActivity {

    @BindView(R.id.tv_event_info)
    TextView mTvEventInfo;
    @BindView(R.id.btn_register_sticky_event)
    Button mBtnRegisterStickyEvent;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_event_bus_sticky);
        ButterKnife.bind(this);
    }

    @Subscribe(threadMode = ThreadMode.MAIN, sticky = true)
    public void readStickyMsg(MessageEvent event){
        mTvEventInfo.setText(mTvEventInfo.getText() + "\n" + event.getMessage() + ", " + event.getTime());
    }

    @OnClick(R.id.btn_jump_next)
    public void jumpToNext(){
        startActivity(new Intent(this, EventBusPosterActivity.class));
    }

    @OnClick(R.id.btn_register_sticky_event)
    public void registerSticky(){
        EventBus.getDefault().register(this);
    }

    @OnClick(R.id.btn_unregister_sticky_event)
    public void unregisterSticky(){
        EventBus.getDefault().removeStickyEvent(MessageEvent.class);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
    }
}

public class EventBusPosterActivity extends AppCompatActivity {

    @BindView(R.id.tv_event_info)
    TextView mTvEventInfo;
    @BindView(R.id.btn_post_normal)
    Button mBtnPostNormal;
    @BindView(R.id.btn_post_sticky_event)
    Button mBtnPostStickyEvent;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_event_bus_post);
        ButterKnife.bind(this);
    }

    @OnClick(R.id.btn_post_normal)
    public void postNormalEvent(){
        EventBus.getDefault().post(new MessageEvent("另外界面的主线程，普通消息", DateUtils.getCurrentTime()));
        finish();
    }

    @OnClick(R.id.btn_post_sticky_event)
    public void postStickyEvent(){
        EventBus.getDefault().postSticky(new MessageEvent("另外界面的主线程，粘性消息", DateUtils.getCurrentTime()));
        finish();
    }
}