最近有个想法——就是把 Android 主流开源框架进行深刻分析,而后写成一系列文章,包括该框架的详细使用与源码解析。目的是经过鉴赏大神的源码来了解框架底层的原理,也就是作到不只要知其然,还要知其因此然。html
这里我说下本身阅读源码的经验,我通常都是按照平时使用某个框架或者某个系统源码的使用流程入手的,首先要知道怎么使用,而后再去深究每一步底层作了什么,用了哪些好的设计模式,为何要这么设计。java
系列文章:git
更多干货请关注 AndroidNotes程序员
(1)定义事件
这个事件就是须要传递的实体类。github
public class MessageEvent {
public final String message;
public MessageEvent(String message) {
this.message = message;
}
}
复制代码
(2)准备订阅者
声明用来处理事件的订阅方法。面试
@Subscribe(threadMode = ThreadMode.MAIN)
public void onMessageEvent(MessageEvent event) {
Toast.makeText(this, event.message, Toast.LENGTH_SHORT).show();
}
复制代码
(3)注册与解除注册
注册与解除注册订阅者,与第(2)步放在同一个类中。设计模式
@Override
public void onStart() {
super.onStart();
EventBus.getDefault().register(this);
}
@Override
public void onStop() {
super.onStop();
EventBus.getDefault().unregister(this);
}
复制代码
(4)发送事件
能够在任何地方发送事件。缓存
EventBus.getDefault().post(new MessageEvent("普通事件"));
复制代码
普通事件是先注册和准备订阅者,而后再发送事件才能收到。而粘性事件在发送事件以后再注册和准备订阅者也能收到事件。安全
使用上与普通事件的区别是第(2)步须要增长 “sticky = true” 声明为粘性事件,第(4)步 post 方法改为 postSticky 方法,以下:markdown
准备订阅者:
@Subscribe(threadMode = ThreadMode.MAIN, sticky = true)
public void onMessageEvent(StickyMessageEvent event) {
Toast.makeText(this, event.message, Toast.LENGTH_SHORT).show();
}
复制代码
发送事件:
EventBus.getDefault().postSticky(new StickyMessageEvent("粘性事件"));
复制代码
接下来咱们就根据这几步进行源码分析。
源码版本:3.2.0
/*Subscribe*/
public @interface Subscribe {
//(1)
ThreadMode threadMode() default ThreadMode.POSTING;
//(2)
boolean sticky() default false;
//(3)
int priority() default 0;
}
复制代码
源码中我标注了 3 个关注点,分别以下:
以上设置都是在 “准备订阅者” 那里配置的,以下:
@Subscribe(threadMode = ThreadMode.MAIN, sticky = true, priority = 1)
public void onMessageEvent(StickyMessageEvent event) {
Toast.makeText(this, event.message, Toast.LENGTH_SHORT).show();
}
复制代码
在看注册方法以前咱们先看下是怎么获取 EventBus 实例的,即 EventBus#getDefault() 中的 getDefault 方法:
/*EventBus*/
public static EventBus getDefault() {
EventBus instance = defaultInstance;
if (instance == null) {
synchronized (EventBus.class) {
instance = EventBus.defaultInstance;
if (instance == null) {
instance = EventBus.defaultInstance = new EventBus();
}
}
}
return instance;
}
复制代码
能够看到,这里是经过双重校验锁的单例模式来获取 EventBus 的实例。
看一下它的构造方法:
/*EventBus*/
private final Map<Class<?>, CopyOnWriteArrayList<Subscription>> subscriptionsByEventType;
private final Map<Object, List<Class<?>>> typesBySubscriber;
private final Map<Class<?>, Object> stickyEvents;
public EventBus() {
this(DEFAULT_BUILDER);
}
EventBus(EventBusBuilder builder) {
logger = builder.getLogger();
//(1)start
subscriptionsByEventType = new HashMap<>();
typesBySubscriber = new HashMap<>();
stickyEvents = new ConcurrentHashMap<>();
//(1)end
mainThreadSupport = builder.getMainThreadSupport();
//(2)
mainThreadPoster = mainThreadSupport != null ? mainThreadSupport.createPoster(this) : null;
//(3)
backgroundPoster = new BackgroundPoster(this);
//(4)
asyncPoster = new AsyncPoster(this);
indexCount = builder.subscriberInfoIndexes != null ? builder.subscriberInfoIndexes.size() : 0;
//(5)
subscriberMethodFinder = new SubscriberMethodFinder(builder.subscriberInfoIndexes,
builder.strictMethodVerification, builder.ignoreGeneratedIndex);
/*一些 boolean 类型的常量赋值*/
logSubscriberExceptions = builder.logSubscriberExceptions;
logNoSubscriberMessages = builder.logNoSubscriberMessages;
sendSubscriberExceptionEvent = builder.sendSubscriberExceptionEvent;
sendNoSubscriberEvent = builder.sendNoSubscriberEvent;
throwSubscriberException = builder.throwSubscriberException;
eventInheritance = builder.eventInheritance;
//(6)
executorService = builder.executorService;
}
复制代码
首先是调用无参构造方法,而后传入一个 DEFAULT_BUILDER 来调用有参构造,这个 DEFAULT_BUILDER 是 EventBusBuilder,它是一个 EventBus 的建造器,里面封装了一些 EventBus 所须要的参数等。 源码中我标记了 6 个关注点,分别以下:
/*MainThreadSupport*/
public interface MainThreadSupport {
...
Poster createPoster(EventBus eventBus);
class AndroidHandlerMainThreadSupport implements MainThreadSupport {
...
@Override
public Poster createPoster(EventBus eventBus) {
return new HandlerPoster(eventBus, looper, 10);
}
}
}
/*HandlerPoster*/
public class HandlerPoster extends Handler implements Poster {
...
}
复制代码
能够看到这里建立了一个 HandlerPoster,因此这里的 mainThreadPoster 其实是一个 HandlerPoster。
接下来看下 register 方法:
/*EventBus*/
public void register(Object subscriber) {
Class<?> subscriberClass = subscriber.getClass();
//(1)
List<SubscriberMethod> subscriberMethods = subscriberMethodFinder.findSubscriberMethods(subscriberClass);
synchronized (this) {
//(2)
for (SubscriberMethod subscriberMethod : subscriberMethods) {
subscribe(subscriber, subscriberMethod);
}
}
}
复制代码
源码中我标记了 2 个关注点,分别以下:
主要是获取注册类上全部订阅方法的集合,也就是使用示例中 “准备订阅者” 那步加了 @Subscribe 注解的那些方法。点进去看看:
/*SubscriberMethodFinder*/
private static final Map<Class<?>, List<SubscriberMethod>> METHOD_CACHE = new ConcurrentHashMap<>();
private final boolean ignoreGeneratedIndex;
List<SubscriberMethod> findSubscriberMethods(Class<?> subscriberClass) {
//(1)
List<SubscriberMethod> subscriberMethods = METHOD_CACHE.get(subscriberClass);
if (subscriberMethods != null) {
return subscriberMethods;
}
//(2)
if (ignoreGeneratedIndex) {
subscriberMethods = findUsingReflection(subscriberClass);
} else {
//(3)
subscriberMethods = findUsingInfo(subscriberClass);
}
// 订阅方法为空,说明注册类中不存在 @Subscribe 注解的方法。
if (subscriberMethods.isEmpty()) {
throw new EventBusException("Subscriber " + subscriberClass
+ " and its super classes have no public methods with the @Subscribe annotation");
} else {
//(4)
METHOD_CACHE.put(subscriberClass, subscriberMethods);
return subscriberMethods;
}
}
复制代码
源码中我标记了 4 个关注点,分别以下:
下面具体看看关注点(3)中内部是怎么实现的:
/*SubscriberMethodFinder*/
private List<SubscriberMethod> findUsingInfo(Class<?> subscriberClass) {
//(1)
FindState findState = prepareFindState();
//(2)
findState.initForSubscriber(subscriberClass);
while (findState.clazz != null) {
//(3)
findState.subscriberInfo = getSubscriberInfo(findState);
// 默认 subscriberInfo 为 null,不会走这里
if (findState.subscriberInfo != null) {
SubscriberMethod[] array = findState.subscriberInfo.getSubscriberMethods();
for (SubscriberMethod subscriberMethod : array) {
if (findState.checkAdd(subscriberMethod.method, subscriberMethod.eventType)) {
findState.subscriberMethods.add(subscriberMethod);
}
}
} else {
//(4)
findUsingReflectionInSingleClass(findState);
}
findState.moveToSuperclass();
}
//(5)
return getMethodsAndRelease(findState);
}
复制代码
源码中我标记了 5 个关注点,分别以下:
/*SubscriberMethodFinder*/
class SubscriberMethodFinder {
static class FindState {
/*查找过程当中临时用来记录订阅方法等的一些集合*/
final List<SubscriberMethod> subscriberMethods = new ArrayList<>();
final Map<Class, Object> anyMethodByEventType = new HashMap<>();
final Map<String, Class> subscriberClassByMethodKey = new HashMap<>();
final StringBuilder methodKeyBuilder = new StringBuilder(128);
/*临时用来记录的一些变量*/
Class<?> subscriberClass;
Class<?> clazz;
boolean skipSuperClasses;
SubscriberInfo subscriberInfo;
void initForSubscriber(Class<?> subscriberClass) {
this.subscriberClass = clazz = subscriberClass;
skipSuperClasses = false;
subscriberInfo = null;
}
// 查找完成进行回收
void recycle() {
subscriberMethods.clear();
anyMethodByEventType.clear();
subscriberClassByMethodKey.clear();
methodKeyBuilder.setLength(0);
subscriberClass = null;
clazz = null;
skipSuperClasses = false;
subscriberInfo = null;
}
...
}
}
复制代码
能够看到,FindState 是 SubscriberMethodFinder 中的静态类,主要用来辅助查找订阅方法。
继续看下 prepareFindState 方法是怎么返回 FindState 对象的:
/*SubscriberMethodFinder*/
private FindState prepareFindState() {
synchronized (FIND_STATE_POOL) {
for (int i = 0; i < POOL_SIZE; i++) {
FindState state = FIND_STATE_POOL[i];
if (state != null) {
FIND_STATE_POOL[i] = null;
return state;
}
}
}
return new FindState();
}
复制代码
首先从 FIND_STATE_POOL 中取出可用的 FindState,若是没有则从新建立一个 FindState。
(2):初始化刚刚 FindState 类中的那些变量。
(3):点击 getSubscriberInfo 方法进去看看:
/*SubscriberMethodFinder*/
private SubscriberInfo getSubscriberInfo(FindState findState) {
if (findState.subscriberInfo != null && findState.subscriberInfo.getSuperSubscriberInfo() != null) {
SubscriberInfo superclassInfo = findState.subscriberInfo.getSuperSubscriberInfo();
if (findState.clazz == superclassInfo.getSubscriberClass()) {
return superclassInfo;
}
}
if (subscriberInfoIndexes != null) {
for (SubscriberInfoIndex index : subscriberInfoIndexes) {
SubscriberInfo info = index.getSubscriberInfo(findState.clazz);
if (info != null) {
return info;
}
}
}
return null;
}
复制代码
其中 subscriberInfo 是刚刚关注点(2)中初始化的 null,subscriberInfoIndexes 是在 EventBus 的有参构造中经过 EventBusBuilder 配置的,咱们没配置,也为 null,因此这个方法默认只会返回 null。
/*SubscriberMethodFinder*/
private void findUsingReflectionInSingleClass(FindState findState) {
Method[] methods;
try {
// 反射获取注册类中的全部方法
methods = findState.clazz.getDeclaredMethods();
} catch (Throwable th) {
try {
// 反射获取注册类中的全部方法
methods = findState.clazz.getMethods();
} catch (LinkageError error) {
...
}
findState.skipSuperClasses = true;
}
// 循环遍历全部方法
for (Method method : methods) {
int modifiers = method.getModifiers();
if ((modifiers & Modifier.PUBLIC) != 0 && (modifiers & MODIFIERS_IGNORE) == 0) {
Class<?>[] parameterTypes = method.getParameterTypes();
if (parameterTypes.length == 1) {
// 获取方法上的注解
Subscribe subscribeAnnotation = method.getAnnotation(Subscribe.class);
if (subscribeAnnotation != null) {
// 获取方法上的第一个参数,也就是事件类型(即便用示例中 MessageEvent 的类型)
Class<?> eventType = parameterTypes[0];
if (findState.checkAdd(method, eventType)) {
// 获取线程模式
ThreadMode threadMode = subscribeAnnotation.threadMode();
// 将方法、事件类型、线程模式、优先级、是不是粘性事件封装到 SubscriberMethod 对象,而后添加到 FindState 类中的 subscriberMethods 集合中存起来
findState.subscriberMethods.add(new SubscriberMethod(method, eventType, threadMode,
subscribeAnnotation.priority(), subscribeAnnotation.sticky()));
}
}
} else if (strictMethodVerification && method.isAnnotationPresent(Subscribe.class)) {
String methodName = method.getDeclaringClass().getName() + "." + method.getName();
throw new EventBusException("@Subscribe method " + methodName +
"must have exactly 1 parameter but has " + parameterTypes.length);
}
} else if (strictMethodVerification && method.isAnnotationPresent(Subscribe.class)) {
String methodName = method.getDeclaringClass().getName() + "." + method.getName();
throw new EventBusException(methodName +
" is a illegal @Subscribe method: must be public, non-static, and non-abstract");
}
}
}
复制代码
上面的注释写的很清楚了,主要是经过反射获取注册类中的全部方法,而后遍历方法,判断若是带有 Subscribe 注解的方法,就将该方法、事件类型、线程模式、优先级、是不是粘性事件封装到 SubscriberMethod 对象,而后添加到 FindState 类中的 subscriberMethods 集合中存起来。
/*SubscriberMethodFinder*/
private List<SubscriberMethod> getMethodsAndRelease(FindState findState) {
List<SubscriberMethod> subscriberMethods = new ArrayList<>(findState.subscriberMethods);
findState.recycle();
synchronized (FIND_STATE_POOL) {
for (int i = 0; i < POOL_SIZE; i++) {
if (FIND_STATE_POOL[i] == null) {
FIND_STATE_POOL[i] = findState;
break;
}
}
}
return subscriberMethods;
}
复制代码
能够看到,这里首先从 FindState 中取出保存的全部订阅方法的信息,这时候 FindState 就没用了,那么须要调用 recycle 方法将里面的一些集合、变量等进行回收。可是 FindState 常常要用到,因此会把它缓存到 FIND_STATE_POOL 中,这样下次就不用从新建立 FindState 了,提升性能。最后将 subscriberMethods 返回。
这样 findSubscriberMethods 方法就看完了,继续看 EventBus#register() 中的关注点(2),即 subscribe 方法。
主要是循环获取每一个订阅方法进行订阅,实际内部只是给 subscriptionsByEventType、typesBySubscriber 集合添加数据。点进去看看:
/*EventBus*/
private void subscribe(Object subscriber, SubscriberMethod subscriberMethod) {
// 获取事件类型
Class<?> eventType = subscriberMethod.eventType;
//(1)
Subscription newSubscription = new Subscription(subscriber, subscriberMethod);
//(2)start
CopyOnWriteArrayList<Subscription> subscriptions = subscriptionsByEventType.get(eventType);
if (subscriptions == null) {
subscriptions = new CopyOnWriteArrayList<>();
subscriptionsByEventType.put(eventType, subscriptions);
} else {
if (subscriptions.contains(newSubscription)) {
throw new EventBusException("Subscriber " + subscriber.getClass() + " already registered to event "
+ eventType);
}
}
//(2)end
int size = subscriptions.size();
//(3)
for (int i = 0; i <= size; i++) {
if (i == size || subscriberMethod.priority > subscriptions.get(i).subscriberMethod.priority) {
subscriptions.add(i, newSubscription);
break;
}
}
//(4)start
List<Class<?>> subscribedEvents = typesBySubscriber.get(subscriber);
if (subscribedEvents == null) {
subscribedEvents = new ArrayList<>();
typesBySubscriber.put(subscriber, subscribedEvents);
}
subscribedEvents.add(eventType);
//(4)end
//(5)
if (subscriberMethod.sticky) {
...
}
}
复制代码
源码中我标注了 5 个关注点,分别以下:
/*EventBus*/
public synchronized boolean isRegistered(Object subscriber) {
return typesBySubscriber.containsKey(subscriber);
}
复制代码
这样,注册方法也就分析完了。
小结
经过反射获取注册类上全部的订阅方法,而后将这些订阅方法进行包装保存到 subscriptionsByEventType 集合。这里还用 typesBySubscriber 集合保存了事件类型集合,用来判断某个对象是否注册过。
看一下解除注册的 unregister 方法:
/*EventBus*/
public synchronized void unregister(Object subscriber) {
// 根据注册类获取 typesBySubscriber 集合中保存的事件类型集合
List<Class<?>> subscribedTypes = typesBySubscriber.get(subscriber);
if (subscribedTypes != null) {
for (Class<?> eventType : subscribedTypes) {
// 看下面
unsubscribeByEventType(subscriber, eventType);
}
// 移除 typesBySubscriber 中保存的事件类型集合
typesBySubscriber.remove(subscriber);
} else {
logger.log(Level.WARNING, "Subscriber to unregister was not registered before: " + subscriber.getClass());
}
}
/*EventBus*/
private void unsubscribeByEventType(Object subscriber, Class<?> eventType) {
// 根据事件类型获取 subscriptionsByEventType 集合中保存的 Subscription 集合
List<Subscription> subscriptions = subscriptionsByEventType.get(eventType);
if (subscriptions != null) {
int size = subscriptions.size();
for (int i = 0; i < size; i++) {
Subscription subscription = subscriptions.get(i);
if (subscription.subscriber == subscriber) {
subscription.active = false;
// 从 Subscription 集合中移除 Subscription
subscriptions.remove(i);
i--;
size--;
}
}
}
}
复制代码
能够看到,unregister 方法很是简单,上面都有注释了,咱们直接来个小结。
小结
注册的时候使用 subscriptionsByEventType 集合保存了全部订阅方法信息,使用 typesBySubscriber 集合保存了全部事件类型。那么解注册的时候就是为了移除这两个集合中保存的内容。
看一下发送事件的 post 方法:
/*EventBus*/
private final ThreadLocal<PostingThreadState> currentPostingThreadState = new ThreadLocal<PostingThreadState>() {
@Override
protected PostingThreadState initialValue() {
return new PostingThreadState();
}
};
public void post(Object event) {
//(1)start
PostingThreadState postingState = currentPostingThreadState.get();
List<Object> eventQueue = postingState.eventQueue;
eventQueue.add(event);
//(1)end
if (!postingState.isPosting) {
postingState.isMainThread = isMainThread();
postingState.isPosting = true;
if (postingState.canceled) {
throw new EventBusException("Internal error. Abort state was not reset");
}
try {
while (!eventQueue.isEmpty()) {
//(2)
postSingleEvent(eventQueue.remove(0), postingState);
}
} finally {
postingState.isPosting = false;
postingState.isMainThread = false;
}
}
}
复制代码
源码中我标记了 2 个关注点,分别以下:
这里的 currentPostingThreadState 是一个 ThreadLocal 对象,里面保存了 PostingThreadState。使用 ThreadLocal 的好处是保证 PostingThreadState 是线程私有的,其余线程没法访问,避免出现线程安全问题。
继续看下 PostingThreadState 里面是什么:
/*EventBus*/
public class EventBus {
final static class PostingThreadState {
final List<Object> eventQueue = new ArrayList<>();
boolean isPosting;
boolean isMainThread;
Subscription subscription;
Object event;
boolean canceled;
}
}
复制代码
能够看到,里面有事件队列、Subscription、事件,以及是否正在发送、是否主线程、是否已取消的标记位。
因此关注点(1)就是从 currentPostingThreadState 中获取 PostingThreadState,而后拿到事件队列,最后将传进来的事件保存到该事件队列中。
主要是从事件队列中取出一个事件进行发送,看下里面作了什么:
/*EventBus*/
private void postSingleEvent(Object event, PostingThreadState postingState) throws Error {
Class<?> eventClass = event.getClass();
// 是否找到订阅者
boolean subscriptionFound = false;
//(1)
if (eventInheritance) {
//(2)
List<Class<?>> eventTypes = lookupAllEventTypes(eventClass);
int countTypes = eventTypes.size();
for (int h = 0; h < countTypes; h++) {
Class<?> clazz = eventTypes.get(h);
//(3)
subscriptionFound |= postSingleEventForEventType(event, postingState, clazz);
}
} else {
// (4)
subscriptionFound = postSingleEventForEventType(event, postingState, eventClass);
}
if (!subscriptionFound) {
if (logNoSubscriberMessages) {
logger.log(Level.FINE, "No subscribers registered for event " + eventClass);
}
if (sendNoSubscriberEvent && eventClass != NoSubscriberEvent.class &&
eventClass != SubscriberExceptionEvent.class) {
//(5)
post(new NoSubscriberEvent(this, event));
}
}
}
复制代码
源码中我标记了 5 个关注点,分别以下:
/*EventBus*/
private static final Map<Class<?>, List<Class<?>>> eventTypesCache = new HashMap<>();
private static List<Class<?>> lookupAllEventTypes(Class<?> eventClass) {
synchronized (eventTypesCache) {
List<Class<?>> eventTypes = eventTypesCache.get(eventClass);
if (eventTypes == null) {
eventTypes = new ArrayList<>();
Class<?> clazz = eventClass;
while (clazz != null) {
eventTypes.add(clazz);
addInterfaces(eventTypes, clazz.getInterfaces());
clazz = clazz.getSuperclass();
}
eventTypesCache.put(eventClass, eventTypes);
}
return eventTypes;
}
}
static void addInterfaces(List<Class<?>> eventTypes, Class<?>[] interfaces) {
for (Class<?> interfaceClass : interfaces) {
if (!eventTypes.contains(interfaceClass)) {
eventTypes.add(interfaceClass);
addInterfaces(eventTypes, interfaceClass.getInterfaces());
}
}
}
复制代码
主要是查找全部事件类型,包括当前事件、父类和接口中的事件。这里用了一个 eventTypesCache 集合类保存查找到的事件类型,避免每次都查找,提升性能。
下面详细分析下关注点(3)的 postSingleEventForEventType 方法:
/*EventBus*/
private boolean postSingleEventForEventType(Object event, PostingThreadState postingState, Class<?> eventClass) {
CopyOnWriteArrayList<Subscription> subscriptions;
synchronized (this) {
//(1)
subscriptions = subscriptionsByEventType.get(eventClass);
}
if (subscriptions != null && !subscriptions.isEmpty()) {
for (Subscription subscription : subscriptions) {
postingState.event = event;
postingState.subscription = subscription;
boolean aborted;
try {
//(2)
postToSubscription(subscription, event, postingState.isMainThread);
aborted = postingState.canceled;
} finally {
postingState.event = null;
postingState.subscription = null;
postingState.canceled = false;
}
if (aborted) {
break;
}
}
return true;
}
return false;
}
复制代码
关注点(1)首先从 subscriptionsByEventType 集合中取出以前注册的时候保存的 Subscription 集合,而后遍历集合拿到 Subscription,而后调用关注点(2)中的 postToSubscription 方法。
看下 postToSubscription 方法:
/*EventBus*/
private void postToSubscription(Subscription subscription, Object event, boolean isMainThread) {
switch (subscription.subscriberMethod.threadMode) {
case POSTING:
invokeSubscriber(subscription, event);
break;
case MAIN:
if (isMainThread) {
invokeSubscriber(subscription, event);
} else {
mainThreadPoster.enqueue(subscription, event);
}
break;
case MAIN_ORDERED:
if (mainThreadPoster != null) {
mainThreadPoster.enqueue(subscription, event);
} else {
// temporary: technically not correct as poster not decoupled from subscriber
invokeSubscriber(subscription, event);
}
break;
case BACKGROUND:
if (isMainThread) {
backgroundPoster.enqueue(subscription, event);
} else {
invokeSubscriber(subscription, event);
}
break;
case ASYNC:
asyncPoster.enqueue(subscription, event);
break;
default:
throw new IllegalStateException("Unknown thread mode: " + subscription.subscriberMethod.threadMode);
}
}
复制代码
能够看到,这里是经过咱们在注解中设置的线程模式来决定在哪一个线程执行订阅方法。下面详细分析下这 5 种线程模式。
POSTING
看一下 invokeSubscriber 方法:
/*EventBus*/
void invokeSubscriber(Subscription subscription, Object event) {
try {
subscription.subscriberMethod.method.invoke(subscription.subscriber, event);
} catch (InvocationTargetException e) {
handleSubscriberException(subscription, event, e.getCause());
} catch (IllegalAccessException e) {
throw new IllegalStateException("Unexpected exception", e);
}
}
复制代码
直接经过反射调用。发送事件的 post 方法咱们刚刚一路跟下来发现是没有发生任何线程切换的,所以这里仍是发送事件所在的线程。因此,若是线程模式是 POSTING,那么在哪一个线程发送事件,就在哪一个线程执行订阅方法。
MAIN
这里首先判断是否在主线程,在主线程则直接反射调用;不然调用 mainThreadPoster 的 enqueue 方法。咱们在 “2.2 注册” 那里已经分析过 mainThreadPoster 其实是一个 HandlerPoster,因此直接看下 HandlerPoster#enqueue():
/*HandlerPoster*/
public class HandlerPoster extends Handler implements Poster {
private final PendingPostQueue queue;
public void enqueue(Subscription subscription, Object event) {
//(1)
PendingPost pendingPost = PendingPost.obtainPendingPost(subscription, event);
synchronized (this) {
//(2)
queue.enqueue(pendingPost);
if (!handlerActive) {
handlerActive = true;
//(3)
if (!sendMessage(obtainMessage())) {
throw new EventBusException("Could not send handler message");
}
}
}
}
}
复制代码
源码中我标记了 3 个关注点,分别以下:
咱们看下 handleMessage 方法:
/*HandlerPoster*/
public class HandlerPoster extends Handler implements Poster {
@Override
public void handleMessage(Message msg) {
boolean rescheduled = false;
try {
long started = SystemClock.uptimeMillis();
while (true) {
//(1)
PendingPost pendingPost = queue.poll();
...
//(2)
eventBus.invokeSubscriber(pendingPost);
...
}
} finally {
handlerActive = rescheduled;
}
}
}
复制代码
能够看到,这里会不断的从队列中取出 PendingPost,而后调用 EventBus 的 invokeSubscriber 方法进行处理。
看一下这个方法:
/*EventBus*/
void invokeSubscriber(PendingPost pendingPost) {
Object event = pendingPost.event;
Subscription subscription = pendingPost.subscription;
PendingPost.releasePendingPost(pendingPost);
if (subscription.active) {
invokeSubscriber(subscription, event);
}
}
/*EventBus*/
void invokeSubscriber(Subscription subscription, Object event) {
try {
subscription.subscriberMethod.method.invoke(subscription.subscriber, event);
} catch (InvocationTargetException e) {
handleSubscriberException(subscription, event, e.getCause());
} catch (IllegalAccessException e) {
throw new IllegalStateException("Unexpected exception", e);
}
}
复制代码
一样是经过反射调用订阅方法。因此,若是线程模式是 MAIN,那么在主线程发送事件,则在主线程执行订阅方法;不然先将事件加入到队列中,而后经过 Handler 切换到主线程再执行。
MAIN_ORDERED
mainThreadPoster 不会为空,因此与 MAIN 同样是调用了 enqueue 方法,只不过这里少了线程的判断。因此,若是线程模式是 MAIN_ORDERED,那么不管在哪一个线程发送事件,都会先将事件加入到队列中,而后经过 Handler 切换到主线程再执行。
BACKGROUND
这里首先判断是否在主线程,在主线程则调用 backgroundPoster 的 enqueue 方法;不然直接反射调用。咱们直接看下 BackgroundPoster:
/*BackgroundPoster*/
final class BackgroundPoster implements Runnable, Poster {
...
public void enqueue(Subscription subscription, Object event) {
PendingPost pendingPost = PendingPost.obtainPendingPost(subscription, event);
synchronized (this) {
queue.enqueue(pendingPost);
if (!executorRunning) {
executorRunning = true;
//(1)
eventBus.getExecutorService().execute(this);
}
}
}
@Override
public void run() {
try {
try {
while (true) {
PendingPost pendingPost = queue.poll(1000);
...
eventBus.invokeSubscriber(pendingPost);
}
} catch (InterruptedException e) {
...
}
} finally {
executorRunning = false;
}
}
}
复制代码
能够看到,与 MAIN 相似,都是先将 subscription 和 event 封装成一个 PendingPost 对象,而后加入到队列中。不一样的是这里不是使用 Handler 发送消息,而是经过线程池去执行。因此,若是线程模式是 BACKGROUND,那么在子线程发送事件,则在子线程执行订阅方法,不然先将事件加入到队列中,而后经过线程池去执行。
ASYNC
没有任何线程判断,直接看 AsyncPoster:
/*AsyncPoster*/
class AsyncPoster implements Runnable, Poster {
private final PendingPostQueue queue;
private final EventBus eventBus;
AsyncPoster(EventBus eventBus) {
this.eventBus = eventBus;
queue = new PendingPostQueue();
}
public void enqueue(Subscription subscription, Object event) {
PendingPost pendingPost = PendingPost.obtainPendingPost(subscription, event);
queue.enqueue(pendingPost);
eventBus.getExecutorService().execute(this);
}
@Override
public void run() {
PendingPost pendingPost = queue.poll();
if(pendingPost == null) {
throw new IllegalStateException("No pending post available");
}
eventBus.invokeSubscriber(pendingPost);
}
}
复制代码
与 BackgroundPoster 同样。因此,若是线程模式是 ASYNC,那么不管在哪一个线程发送事件,都会先将事件加入到队列中,而后经过线程池去执行。
小结
从 subscriptionsByEventType 集合中取出全部订阅方法,而后根据线程模式判断是否须要切换线程,不须要则直接经过反射调用订阅方法;须要则经过 Handler 或线程池切换到指定线程再执行。
看一下发送粘性事件的 postSticky 方法:
/*EventBus*/
public void postSticky(Object event) {
synchronized (stickyEvents) {
stickyEvents.put(event.getClass(), event);
}
post(event);
}
复制代码
首先将事件保存到 stickyEvents 集合中,而后调用 post 方法发送事件,这个方法与刚刚讲的发送事件的方法是如出一辙的,只是这里最终不会把事件发送出去,具体看下面:
post()——>postSingleEvent()——>postSingleEventForEventType()
/*EventBus*/
private boolean postSingleEventForEventType(Object event, PostingThreadState postingState, Class<?> eventClass) {
CopyOnWriteArrayList<Subscription> subscriptions;
synchronized (this) {
subscriptions = subscriptionsByEventType.get(eventClass);
}
if (subscriptions != null && !subscriptions.isEmpty()) {
...
postToSubscription(subscription, event, postingState.isMainThread);
...
}
return false;
}
复制代码
这里的 subscriptions 取出来是空的,因此并不会执行 postToSubscription 方法。
那么怎么将事件发送出去呢?
咱们一开始就说了 “普通事件是先注册和准备订阅者,而后再发送事件才能收到。而粘性事件在发送事件以后再注册和准备订阅者也能收到事件。”,因此是在注册的那里将事件发送出去的,咱们分析注册的时候省略了粘性事件相关逻辑,如今回去再看看:
/*EventBus*/
private void subscribe(Object subscriber, SubscriberMethod subscriberMethod) {
...
if (subscriberMethod.sticky) {
if (eventInheritance) {
Set<Map.Entry<Class<?>, Object>> entries = stickyEvents.entrySet();
for (Map.Entry<Class<?>, Object> entry : entries) {
Class<?> candidateEventType = entry.getKey();
if (eventType.isAssignableFrom(candidateEventType)) {
Object stickyEvent = entry.getValue();
// 关注点
checkPostStickyEventToSubscription(newSubscription, stickyEvent);
}
}
} else {
Object stickyEvent = stickyEvents.get(eventType);
checkPostStickyEventToSubscription(newSubscription, stickyEvent);
}
}
}
复制代码
这里判断若是是粘性事件,则从 stickyEvents 集合中取出事件,而后调用 checkPostStickyEventToSubscription 方法:
/*EventBus*/
private void checkPostStickyEventToSubscription(Subscription newSubscription, Object stickyEvent) {
if (stickyEvent != null) {
postToSubscription(newSubscription, stickyEvent, isMainThread());
}
}
复制代码
这里调用的 postToSubscription 方法就是咱们上一节分析过的,也就是根据线程模型决定是否要切换线程执行订阅方法。
小结
发送粘性事件的的时候,首先会将事件保存到 stickyEvents 集合,等到注册的时候判断若是是粘性事件,则从集合中取出事件进行发送。
EventBus 源码相对于 Glide 仍是比较简单的,可是里面用到的 ThreadLocal、反射、设计模式等都是值得学习的。最后总结一下面试相关问题,这样也算是看完这篇博客的收获了。
(1)介绍一下 EventBus 以及它的优势
EventBus 是一个 Android 事件发布/订阅框架,主要用来简化 Activity、Fragment、Service、线程等之间的通信。优势是开销小、使用简单、以及解耦事件发送者和接收者。
(2)为何要使用 EventBus 来替代广播呢?
(3)说下 5 种线程模式的区别
(4)EventBus 是如何作到发送粘性消息的?
发送粘性事件的的时候,首先会将事件保存到 stickyEvents 集合,等到注册的时候判断若是是粘性事件,则从集合中取出事件进行发送。
(5)说下 EventBus 的原理
经过反射获取注册类上全部的订阅方法,而后将这些订阅方法进行包装保存到 subscriptionsByEventType 集合。这里还用 typesBySubscriber 集合保存了事件类型集合,用来判断某个对象是否注册过。
注册的时候使用 subscriptionsByEventType 集合保存了全部订阅方法信息,使用 typesBySubscriber 集合保存了全部事件类型。那么解注册的时候就是为了移除这两个集合中保存的内容。
从 subscriptionsByEventType 集合中取出全部订阅方法,而后根据线程模式判断是否须要切换线程,不须要则直接经过反射调用订阅方法;须要则经过 Handler 或线程池切换到指定线程再执行。
发送粘性事件的的时候,首先会将事件保存到 stickyEvents 集合,等到注册的时候判断若是是粘性事件,则从集合中取出事件进行发送。
我是 wildma,CSDN 认证博客专家,简书程序员优秀做者,擅长屏幕适配。 若是文章对你有帮助,点个赞就是对我最大的承认!