【EventBus】Subscribe 注解分析 ( Subscribe 注解属性 | threadMode 线程模型 | POSTING | MAIN | MAIN_ORDERED | ASYNC)

package org.greenrobot.eventbus;


import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

@Documented
@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD})
public @interface Subscribe {
    ThreadMode threadMode() default ThreadMode.POSTING;

    /**
     * 如果为true，则将最近的粘性事件 (posted with
     * {@link EventBus#postSticky(Object)}) 传递到此订阅服务器（如果事件可用）。
     */
    boolean sticky() default false;

    /** 影响事件传递顺序的订户优先级。在同一传递线程（{@link ThreadMode}）中，
     * 优先级较高的订阅者将在其他优先级较低的订阅者之前接收事件。默认优先级为0。
     * 注意：优先级*不*影响具有不同{@link ThreadMode}的订阅服务器之间的传递顺序！ */
    int priority() default 0;
}

package org.greenrobot.eventbus;

/**
 * 每个订户方法都有一个线程模式，该模式确定EventBus将在哪个线程中调用该方法。
 * EventBus独立于发布线程处理线程。
 *
 * @see EventBus#register(Object)
 * @author Markus
 */
public enum ThreadMode {
    /**
     * 订阅服务器将在发布事件的同一线程中直接调用。
     * 这是默认设置。
     * 事件传递意味着开销最小，因为它完全避免了线程切换。
     * 因此，对于已知可以在很短时间内完成而不需要主线程的简单任务，这是推荐的模式。
     * 使用此模式的事件处理程序必须快速返回，以避免阻塞发布线程（可能是主线程）。
     */
    POSTING,

    /**
     * 在Android上，订户将在Android的主线程（UI线程）中被调用。
     * 如果发布线程是主线程，则将直接调用订阅者方法，从而阻塞发布线程。
     * 否则，事件将排队等待传递（非阻塞）。使用此模式的订阅服务器必须快速返回以避免阻塞主线程。
     * 如果不在Android上，其行为与{@link#POSTING}相同。
     */
    MAIN,

    /**
     * 在Android上，订户将在Android的主线程（UI线程）中被调用。
     * 与{@link#MAIN}不同，事件将始终排队等待传递。这确保post调用是非阻塞的。
     */
    MAIN_ORDERED,

    /**
     * 在Android上，订阅者将在后台线程中被调用。
     * 如果发布线程不是主线程，则将在发布线程中直接调用订阅方方法。
     * 如果发布线程是主线程，EventBus将使用一个后台线程，该线程将按顺序传递其所有事件。
     * 使用此模式的订阅者应尝试快速返回，以避免阻塞后台线程。
     * 如果不在Android上，则始终使用后台线程。
     */
    BACKGROUND,

    /**
     * 订户将在单独的线程中被调用。
     * 这始终独立于发布线程和主线程。
     * 发布事件从不等待使用此模式的订阅服务器方法。
     * 如果订户方法的执行可能需要一些时间，例如网络访问，则订户方法应使用此模式。
     * 避免同时触发大量长时间运行的异步订阅服务器方法，以限制并发线程的数量。
     * EventBus使用线程池高效地重用已完成异步订户通知中的线程。
     */
    ASYNC
}