本系列文章主要分析 EventBus 框架的架构和原理,,基于最新的 3.1.0 版本。
这是 EventBus 开源库的地址,大家可以直接访问https://github.com/greenrobot/EventBus
本篇文章是 EventBus 的第三篇,主要分析 初始化,注册和取消注册;
Eventbus 翻译过来就是事件总线,用于简化组件和组件,线程和线程之间的消息通信,可以看成是 Handler + Thread 的替代品。
1 回顾 我们在使用的过程中,需要先进行注册:
1 EventBus.getDefault().register(this );
当我们的组件在销毁以后,就要执行取消注册:
1 EventBus.getDefault().unregister(this );
本篇文章,主要分析 register 和 unregister 的流程!
2 EventBus EventBus 这个类是总的入口,我们可以通过 getDefault 返回默认配置的 EventBus,也可以通过 EventBusBuilder 去自定义配置:
EventBus 使用了单例模式!
2.1 成员属性 我们先去看看 EventBus 的成员属性,当然我们后面也会详细分析:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 private static final Map<Class<?>, List<Class<?>>> eventTypesCache = new HashMap<>();private final Map<Class<?>, CopyOnWriteArrayList<Subscription>> subscriptionsByEventType;private final Map<Object, List<Class<?>>> typesBySubscriber;private final Map<Class<?>, Object> stickyEvents;private final ThreadLocal<PostingThreadState> currentPostingThreadState = new ThreadLocal<PostingThreadState>() { @Override protected PostingThreadState initialValue () { return new PostingThreadState(); } }; private final MainThreadSupport mainThreadSupport; private final Poster mainThreadPoster; private final BackgroundPoster backgroundPoster; private final AsyncPoster asyncPoster; private final SubscriberMethodFinder subscriberMethodFinder;
1 2 3 4 5 6 7 8 9 10 11 12 13 static volatile EventBus defaultInstance; private static final EventBusBuilder DEFAULT_BUILDER = new EventBusBuilder(); private final ExecutorService executorService; private final boolean throwSubscriberException; private final boolean logSubscriberExceptions;private final boolean logNoSubscriberMessages;private final boolean sendSubscriberExceptionEvent;private final boolean sendNoSubscriberEvent;private final boolean eventInheritance;private final int indexCount;
这里我简单的解释下:
mainThreadPoster,backgroundPoster,asyncPoster 用于不同类型消息的分发,它们都是实现了 Post 接口,后面我们分析的时候再看!
currentPostingThreadState 是一个 ThreadLocal 变量,每个 post 线程都会有一个 PostingThreadState 属性,表示 post 的状态!
SubscriberMethodFinder 用于查找订阅方法;
2.2 创建 EventBus 实例 EventBus 提供了多种创建方式,既可以通过单例模式创建一个统一的 EventBus 对象,也可以创建多个 EventBus 实例,每个实例都是一个单独的作用域!
2.2.1 getDefault 单例模式方法,创建默认的 EventBus:
1 2 3 4 5 6 7 8 9 10 11 public static EventBus getDefault () { if (defaultInstance == null ) { synchronized (EventBus.class) { if (defaultInstance == null ) { defaultInstance = new EventBus(); } } } return defaultInstance; }
2.2.2 new EventBus 非单例模式方法,两个构造器,默认构造器会传入一个默认的 DEFAULT_BUILDER
,另一个需要传入指定的 EventBusBuilder 实例;
但是,我们只能通过无参数的构造器创建非单例的 EventBus 实例!
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 public class EventBus { ... ... ... public EventBus () { this (DEFAULT_BUILDER); } EventBus(EventBusBuilder builder) { logger = builder.getLogger(); subscriptionsByEventType = new HashMap<>(); typesBySubscriber = new HashMap<>(); stickyEvents = new ConcurrentHashMap<>(); mainThreadSupport = builder.getMainThreadSupport(); mainThreadPoster = mainThreadSupport != null ? mainThreadSupport.createPoster(this ) : null ; backgroundPoster = new BackgroundPoster(this ); asyncPoster = new AsyncPoster(this ); indexCount = builder.subscriberInfoIndexes != null ? builder.subscriberInfoIndexes.size() : 0 ; subscriberMethodFinder = new SubscriberMethodFinder(builder.subscriberInfoIndexes, builder.strictMethodVerification, builder.ignoreGeneratedIndex); logSubscriberExceptions = builder.logSubscriberExceptions; logNoSubscriberMessages = builder.logNoSubscriberMessages; sendSubscriberExceptionEvent = builder.sendSubscriberExceptionEvent; sendNoSubscriberEvent = builder.sendNoSubscriberEvent; throwSubscriberException = builder.throwSubscriberException; eventInheritance = builder.eventInheritance; executorService = builder.executorService; } ... ... ... }
通过建造者模式来初始化部分变量,同时也会对其他变量做默认的初始化;
2.2.3 通过 EventBusBuilder 创建 EventBusBuilder 也提供了两个方法,通过 build 模式创建 EventBus 实例!
2.2.3.1 installDefaultEventBus 单例模式方法,创建默认的 EventBus,但是如果已经创建了 EventBus 的单例,那就不能调用这个方法:
1 2 3 4 5 6 7 8 9 10 11 public EventBus installDefaultEventBus () { synchronized (EventBus.class) { if (EventBus.defaultInstance != null ) { throw new EventBusException("Default instance already exists." + " It may be only set once before it's used the first time to ensure consistent behavior." ); } EventBus.defaultInstance = build(); return EventBus.defaultInstance; } }
2.2.3.2 build 这个方法可以用与创建非单例的 EventBus 实例:
1 2 3 4 public EventBus build () { return new EventBus(this ); }
2.3 register - 注册 我们来看 register 的过程:
1 2 3 4 5 6 7 8 9 10 11 12 public void register (Object subscriber) { Class<?> subscriberClass = subscriber.getClass(); List<SubscriberMethod> subscriberMethods = subscriberMethodFinder.findSubscriberMethods(subscriberClass); synchronized (this ) { for (SubscriberMethod subscriberMethod : subscriberMethods) { subscribe(subscriber, subscriberMethod); } } }
整体流程简单,不多说了;
注意:这里的 subscriberClass 是调用 register 方法所在的类;
2.3.1 subscribe 创建订阅关系:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 private void subscribe (Object subscriber, SubscriberMethod subscriberMethod) { Class<?> eventType = subscriberMethod.eventType; Subscription newSubscription = new Subscription(subscriber, subscriberMethod); 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); } } int size = subscriptions.size(); for (int i = 0 ; i <= size; i++) { if (i == size || subscriberMethod.priority > subscriptions.get(i).subscriberMethod.priority) { subscriptions.add(i, newSubscription); break ; } } List<Class<?>> subscribedEvents = typesBySubscriber.get(subscriber); if (subscribedEvents == null ) { subscribedEvents = new ArrayList<>(); typesBySubscriber.put(subscriber, subscribedEvents); } subscribedEvents.add(eventType); 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); } } }
流程:
将订阅关系保存到对应的缓存中;
处理 sticky 事件的分发;
这里的 eventInheritance 是啥意思呢,其实就是事件继承关系:
比如 MessageEvent2 继承了 MessageEvent,那么如果订阅方法的参数是 MessageEvent,而粘性事件是 MessageEvent2,那么我们依然可以分发该消息;
2.3.2 checkPostStickyEventToSubscription 1 2 3 4 5 6 private void checkPostStickyEventToSubscription (Subscription newSubscription, Object stickyEvent) { if (stickyEvent != null ) { postToSubscription(newSubscription, stickyEvent, isMainThread()); } }
// If the subscriber is trying to abort the event, it will fail (event is not tracked in posting state) –> Strange corner case, which we don’t take care of here.
2.3.3 postToSubscription 对于 sticky event 这个和粘性广播的道理是一样,如果它之前就已经分发过,那么他会被存储在系统里,下一个订阅者一旦注册,那就能够收到:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 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 { 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); } }
可以看到,这里开始事件的 post 了!
event post 这里我们不关注,后面会分析;
2.4 unregister - 反注册 我们来看看反注册的过程:
1 2 3 4 5 6 7 8 9 10 11 12 public synchronized void unregister (Object subscriber) { List<Class<?>> subscribedTypes = typesBySubscriber.get(subscriber); if (subscribedTypes != null ) { for (Class<?> eventType : subscribedTypes) { unsubscribeByEventType(subscriber, eventType); } typesBySubscriber.remove(subscriber); } else { logger.log(Level.WARNING, "Subscriber to unregister was not registered before: " + subscriber.getClass()); } }
2.4.1 unsubscribeByEventType 这个方法很简单,就是将订阅关系移除掉;
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 private void unsubscribeByEventType (Object subscriber, Class<?> eventType) { 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 ; subscriptions.remove(i); i--; size--; } } } }
不多说了。
3 EventBusBuilder 建造者模式,用于自定义 EventBus 的配置,并创建 EventBus 实例:
3.1 成员变量 我们来看下成员变量:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 public class EventBusBuilder { private final static ExecutorService DEFAULT_EXECUTOR_SERVICE = Executors.newCachedThreadPool(); 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; Logger logger; MainThreadSupport mainThreadSupport; EventBusBuilder() { }
如果我们使用默认的 EventBusBuilder 来初始化 EventBus 的话,那么 EventBusBuilder 的方法会返回属性的默认值:
这里我简单的说下:
3.2 方法 前面我们顺便看了下通过 EventBusBuilder 创建 EventBus 的相关方法,这里就不再看了,我们来看下 EventBusBuilder 其中的部分方法:
3.2.1 getMainThreadSupport 获取主线程的支持对象!
1 2 3 4 5 6 7 8 9 10 11 12 13 MainThreadSupport getMainThreadSupport () { if (mainThreadSupport != null ) { return mainThreadSupport; } else if (AndroidLogger.isAndroidLogAvailable()) { Object looperOrNull = getAndroidMainLooperOrNull(); return looperOrNull == null ? null : new MainThreadSupport.AndroidHandlerMainThreadSupport((Looper) looperOrNull); } else { return null ; } }
3.2.1.1 getAndroidMainLooperOrNull 获取主线程的 looper 对象;
1 2 3 4 5 6 7 Object getAndroidMainLooperOrNull () { try { return Looper.getMainLooper(); } catch (RuntimeException e) { return null ; } }
不多说了。
3.2.2 addIndex 改方法用于将通过 EventBus 的 annotation preprocessor 生成的 SubscriberInfoIndex 子类实例,加入到 EventBusBuilder.subscriberInfoIndexes 中!
1 2 3 4 5 6 7 public EventBusBuilder addIndex (SubscriberInfoIndex index) { if (subscriberInfoIndexes == null ) { subscriberInfoIndexes = new ArrayList<>(); } subscriberInfoIndexes.add(index); return this ; }
不多说了。
3.2.3 getLogger 获取 log 系统:
1 2 3 4 5 6 7 8 9 10 Logger getLogger () { if (logger != null ) { return logger; } else { return AndroidLogger.isAndroidLogAvailable() && getAndroidMainLooperOrNull() != null ? new AndroidLogger("EventBus" ) : new Logger.SystemOutLogger(); } }
4 MainThreadSupport 是一个接口,AndroidHandlerMainThreadSupport 内部类实现了该接口,作为主线程的支持类,是对 looper 对象的封装;
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 public interface MainThreadSupport { boolean isMainThread () ; Poster createPoster (EventBus eventBus) ; class AndroidHandlerMainThreadSupport implements MainThreadSupport { private final Looper looper; public AndroidHandlerMainThreadSupport (Looper looper) { this .looper = looper; } ... ... ... } }
这里我们先不看 AndroidHandlerMainThreadSupport 的其他方法,后面会分析。
暂时只需要知道,AndroidHandlerMainThreadSupport 的 createPoster 方法会创建一个 HandlerPoster 实例,他是 Handler 的子类,同时实现了 Poster 接口!
看到这里,其实能猜到,HandlerPoster 会持有主线程的 Looper 对象,像主线程发送消息!!
5 SubscriberMethodFinder 该类用于查找订阅者的方法:
5.1 成员变量 我们来看一些核心的成员变量:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 private static final int BRIDGE = 0x40 ;private static final int SYNTHETIC = 0x1000 ;private static final int MODIFIERS_IGNORE = Modifier.ABSTRACT | Modifier.STATIC | BRIDGE | SYNTHETIC;private static final Map<Class<?>, List<SubscriberMethod>> METHOD_CACHE = new ConcurrentHashMap<>(); private List<SubscriberInfoIndex> subscriberInfoIndexes;private final boolean strictMethodVerification;private final boolean ignoreGeneratedIndex;private static final int POOL_SIZE = 4 ;private static final FindState[] FIND_STATE_POOL = new FindState[POOL_SIZE];
这里可以看到,subscriberInfoIndexes 是要手动设置到 EventBusBuilder 中;
5.2 new SubscriberMethodFinder
参数 List subscriberInfoIndexes :表示 SubscriberInfoIndex 集合,就是通过 APT 技术生成的,存储了订阅方法的对象;
参数 boolean strictMethodVerification :是否强制方法校验,默认为 false;
参数 boolean ignoreGeneratedIndex :是否强制使用反射,即使开启了 APT 特性;默认为 false;
以上参数值均来自于 EventBusBuilder 中的默认值/自定义值;
1 2 3 4 5 6 SubscriberMethodFinder(List<SubscriberInfoIndex> subscriberInfoIndexes, boolean strictMethodVerification, boolean ignoreGeneratedIndex) { this .subscriberInfoIndexes = subscriberInfoIndexes; this .strictMethodVerification = strictMethodVerification; this .ignoreGeneratedIndex = ignoreGeneratedIndex; }
5.3 findSubscriberMethods 查询订阅者拥有的订阅方法:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 List<SubscriberMethod> findSubscriberMethods (Class<?> subscriberClass) { List<SubscriberMethod> subscriberMethods = METHOD_CACHE.get(subscriberClass); if (subscriberMethods != null ) { return subscriberMethods; } if (ignoreGeneratedIndex) { subscriberMethods = findUsingReflection(subscriberClass); } else { subscriberMethods = findUsingInfo(subscriberClass); } if (subscriberMethods.isEmpty()) { throw new EventBusException("Subscriber " + subscriberClass + " and its super classes have no public methods with the @Subscribe annotation" ); } else { METHOD_CACHE.put(subscriberClass, subscriberMethods); return subscriberMethods; } }
ignoreGeneratedIndex 默认是 false 的;
核心代码在 findUsingReflection 和 findUsingInfo 中!
5.3.1 findUsingReflection - 反射获取 我们来看下通过反射是如何获取的:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 private List<SubscriberMethod> findUsingReflection (Class<?> subscriberClass) { FindState findState = prepareFindState(); findState.initForSubscriber(subscriberClass); while (findState.clazz != null ) { findUsingReflectionInSingleClass(findState); findState.moveToSuperclass(); } return getMethodsAndRelease(findState); }
这里的 subscriberClass 是调用 register 方法所在的类,所以找父类肯定是向上搜索;
对于每一个调用了 register 的 class,都会创建一个 FindState 对象,保存相关信息;
5.3.2 findUsingInfo - APT 获取 开启了 APT 预处理技术的话,那就通过动态生成的类获取,这个过程比反射更快;
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 private List<SubscriberMethod> findUsingInfo (Class<?> subscriberClass) { FindState findState = prepareFindState(); findState.initForSubscriber(subscriberClass); while (findState.clazz != null ) { findState.subscriberInfo = getSubscriberInfo(findState); 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 { findUsingReflectionInSingleClass(findState); } findState.moveToSuperclass(); } return getMethodsAndRelease(findState); }
可以看到,这里会优先获取通过 APT 技术生成的类,如果没有对应的 SubscriberInfo,那就仍然通过反射来获取方法 Method;
这里的 subscriberClass 是调用 register 方法所在的类,所以找父类肯定是向上搜索;
5.3.2.1 getSubscriberInfo 返回订阅者对应的 SubscriberInfo 实例,前面我们知道 findState.subscriberInfo 在初始化的时候是 null 的:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 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 实例!
5.4 prepareFindState 主要是为每个 find 操作,创建一个 FindState 对象;
1 2 3 4 5 6 7 8 9 10 11 12 13 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 实例;
5.5 findUsingReflectionInSingleClass 通过反射的方式获取注册方法,通过 SubscriberMethod 实例封装,保存到 findState.subscriberMethods 中:
参数为 FindState 实例,这里获取方法的是通过 findState.clazz,这个要注意;
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 private void findUsingReflectionInSingleClass (FindState findState) { Method[] methods; try { methods = findState.clazz.getDeclaredMethods(); } catch (Throwable th) { methods = findState.clazz.getMethods(); 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 ) { Class<?> eventType = parameterTypes[0 ]; if (findState.checkAdd(method, eventType)) { ThreadMode threadMode = subscribeAnnotation.threadMode(); 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" ); } } }
strictMethodVerification 表示是否强制校验方法的访问修饰符;
5.6 getMethodsAndRelease 返回收集到的方法:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 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; }
6 FindState FindState 是 SubscriberMethodFinder 的内部类,用于保存查询的结果和状态信息(包括子类和父类):
6.1 成员变量 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 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;
subscriberClassByMethodKey:如果存在继承关系,同时方法有覆盖,那么以子类为准;
6.2 initForSubscriber 初始化操作;
1 2 3 4 5 6 void initForSubscriber (Class<?> subscriberClass) { this .subscriberClass = clazz = subscriberClass; skipSuperClasses = false ; subscriberInfo = null ; }
6.3 moveToSuperclass 跳转到 superClass,处理父类:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 void moveToSuperclass () { if (skipSuperClasses) { clazz = null ; } else { clazz = clazz.getSuperclass(); String clazzName = clazz.getName(); if (clazzName.startsWith("java." ) || clazzName.startsWith("javax." ) || clazzName.startsWith("android." )) { clazz = null ; } } }
不多说了;
6.4 checkAdd 检查要添加方法的信息:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 boolean checkAdd (Method method, Class<?> eventType) { Object existing = anyMethodByEventType.put(eventType, method); if (existing == null ) { return true ; } else { if (existing instanceof Method) { if (!checkAddWithMethodSignature((Method) existing, eventType)) { throw new IllegalStateException(); } anyMethodByEventType.put(eventType, this ); } return checkAddWithMethodSignature(method, eventType); } }
可以看到,作者其实在注释里面也有说明:有两级的检查:
可能有多个处理该 eventType 的函数:
只有第一次添加会进入 if (existing instanceof Method) {
分支;
第二次就会将 anyMethodByEventType 中的 value 从 Method 变为 FindState,那么就不会进入 if (existing instanceof Method) {
分支了;
无论一类多方法,还是继承一方法,都是上面的流程;
(但是看作者的注释:貌似没有考虑一个订阅者有多个监听相同事件类型的方法。)
如果该 checkAdd 方法返回的是 false,那么 @Subscribe 修饰的方法就不会被收集!!!
6.4.1 checkAddWithMethodSignature 检查方法签名:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 private boolean checkAddWithMethodSignature (Method method, Class<?> eventType) { methodKeyBuilder.setLength(0 ); methodKeyBuilder.append(method.getName()); methodKeyBuilder.append('>' ).append(eventType.getName()); String methodKey = methodKeyBuilder.toString(); Class<?> methodClass = method.getDeclaringClass(); Class<?> methodClassOld = subscriberClassByMethodKey.put(methodKey, methodClass); if (methodClassOld == null || methodClassOld.isAssignableFrom(methodClass)) { return true ; } else { subscriberClassByMethodKey.put(methodKey, methodClassOld); return false ; } }
这里实际上是方法的签名:方法名>参数
对于同一个类,如果有多个函数处理同一个 eventType,显然方法签名是不一样的,那么这个 checkAddWithMethodSignature 返回的是 true;
对于继承关系,对于子类和父类有相同的方法签名的情况,以子类为准,也就是说父类的同名同参方法是不会被收集的 checkAddWithMethodSignature 返回的是 false;;
6.5 recycle 回收内部的变量,就是 clear 操作:
1 2 3 4 5 6 7 8 9 10 void recycle () { subscriberMethods.clear(); anyMethodByEventType.clear(); subscriberClassByMethodKey.clear(); methodKeyBuilder.setLength(0 ); subscriberClass = null ; clazz = null ; skipSuperClasses = false ; subscriberInfo = null ; }
就不多说了,啊哈哈哈哈哈~~
7 Subscription 表示一种订阅关系;
7.1 成员变量 我们来看下成员属性:
1 2 3 final class Subscription { final Object subscriber; final SubscriberMethod subscriberMethod;
7.2 new Subscription 创建订阅关系:
1 2 3 4 5 Subscription(Object subscriber, SubscriberMethod subscriberMethod) { this .subscriber = subscriber; this .subscriberMethod = subscriberMethod; active = true ; }
8 总结 我们分析了 EventBus 的创建,注册和反注册,整个初始化和注册的过程主要分为下面的基本:
通过 EventBusBuilder 创建 EventBus;
EventBus 收集当前类以及其父类所有的订阅方法;
根据事件类型和每一个订阅方法,创建订阅关系;
遗留了如下的几个问题:
post 操作的执行流程;
不同线程模式的消息是如何分发和处理的;