EventBus源码再分析
一、概述
EventBus是一个开源的用于Android和Java上的一个:订阅--->发布事件总线。
优点:
1.只要是在一个JVM内,就可以实现通信
2.小巧灵活、不占内存
3.解耦,切换线程灵活
4.库小,不占内存
缺点:
1.注册和反注册时一对,如果忘记了就会出现内存泄漏
2.拿到注解方法组是通过反射来进行的,效率稍低
3.在整个项目中需要定义不少的Event组件,事件如果很多就会看起来比较臃肿
ps:就目前来说,如果项目中使用kotlin,那么事件总线可以使用SharedFlow或者StateFlow来代替。
二、原理分析
从使用上来说EventBus就三板斧。注册:EventBus.getDefault().register(obj)、取消注册:EventBus.getDefault().unregister(obj)、发送事件:EventBus.getDefault().post(event)、接收事件@Subscribe(threadMode=ThreadMode.MAIN)接收事件
一、先说注册
public void register(Object subscriber) { //获取注册对象的class字节码对象 Class<?> subscriberClass = subscriber.getClass();
//这一步比较关键,作用是用来获取subscriber对象中包含@Subscribe注解的方法集合 List<SubscriberMethod> subscriberMethods = subscriberMethodFinder.findSubscriberMethods(subscriberClass); synchronized (this) { for (SubscriberMethod subscriberMethod : subscriberMethods) {
//循环对方法集合进行注册,其实就是往集合中去添加找到的方法名。 subscribe(subscriber, subscriberMethod); } } }
接下来看看subscriberMethodFinder.findSubscriberMethods(subscriberClass)方法中都干了啥
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;
}
}
接下来看:subscriberMethods = findUsingReflection(subscriberClass);//拿到注解方法集合
private List<SubscriberMethod> findUsingReflection(Class<?> subscriberClass) {
FindState findState = prepareFindState();
findState.initForSubscriber(subscriberClass);
while (findState.clazz != null) {
findUsingReflectionInSingleClass(findState);
findState.moveToSuperclass();
}
return getMethodsAndRelease(findState);
}
private void findUsingReflectionInSingleClass(FindState findState) {
Method[] methods;
try {
// 获取注册对象的所有方法
methods = findState.clazz.getDeclaredMethods();
} catch (Throwable th) {
....
}
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注解
Subscribe subscribeAnnotation = method.getAnnotation(Subscribe.class);
if (subscribeAnnotation != null) {//如果Subscribe对象不为空,说明这个方法上有@Subscribe注解
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)) {
....
}
} else if (strictMethodVerification && method.isAnnotationPresent(Subscribe.class)) {
....
}
}
}
到这里:subscriberMethodFinder.findSubscriberMethods(subscriberClass);获取注解方法列表的方法已经返回了方法列表,算是走完了。
下面看下循环注册subscribe(subscriber, subscriberMethod);方法
private void subscribe(Object subscriber, SubscriberMethod subscriberMethod) {
Class<?> eventType = subscriberMethod.eventType;
//将注册对象和注册对象中的@Subscribe注解信息封装成为一个Subscription,方便后面使用
Subscription newSubscription = new Subscription(subscriber, subscriberMethod);
//先看看以前有没有存过,如果没有就new一个
CopyOnWriteArrayList<Subscription> subscriptions = subscriptionsByEventType.get(eventType);
if (subscriptions == null) {
subscriptions = new CopyOnWriteArrayList<>();
//把事件类型和时间类型对应的对象及对象注解信息存入map,这个后面unRegister的时候也会用的到
subscriptionsByEventType.put(eventType, subscriptions);
} else {
....
}
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);//把事件类型存起来,放入typesBySubscriberd对象中,后面会用到
.....
}
到这里注册就分析完了,其实整体上看起来是比较简单的,流程无非是:拿到订阅对象,通过订阅对象拿到对应的class。在运行时拿到class的所有方法,过滤出带有@subscribe注解的方法,并发放发信息存入对象,对象存入集合,然后返回。通过拿到返回的对象集合,循环的去进行注册,其实就是把对象方法,和事件类型封装到map中,供后面使用。
二、下面说说EventBus.getDefault.Post(event)方法
public void post(Object event) {
//事件入队列
PostingThreadState postingState = currentPostingThreadState.get();
List<Object> eventQueue = postingState.eventQueue;
eventQueue.add(event);
if (!postingState.isPosting) {
postingState.isMainThread = isMainThread();//判断post所在的线程是主线程还是子线程,并记录下来
postingState.isPosting = true;
....
try {
while (!eventQueue.isEmpty()) {
//分发事件
postSingleEvent(eventQueue.remove(0), postingState);
}
} finally {
postingState.isPosting = false;
postingState.isMainThread = false;
}
}
}
下面看看postSingleEvent都干了什么事情
private void postSingleEvent(Object event, PostingThreadState postingState) throws Error {
Class<?> eventClass = event.getClass();//依然是通过时间对象获取其字节码对象
boolean subscriptionFound = false;
......
subscriptionFound = postSingleEventForEventType(event, postingState, eventClass);//接着对事件分发
.....
}
private boolean postSingleEventForEventType(Object event, PostingThreadState postingState, Class<?> eventClass) {
CopyOnWriteArrayList<Subscription> subscriptions;
synchronized (this) {
subscriptions = subscriptionsByEventType.get(eventClass);//这句话很重要,表示通过事件类型在subscriptionsByEventType的map中拿,@Subscribe对象中此注解的方法信息集合
}
if (subscriptions != null && !subscriptions.isEmpty()) {
for (Subscription subscription : subscriptions) {//@Subscribe信息集合拿到后开始遍历
postingState.event = event;
postingState.subscription = subscription;
boolean aborted;
try {
postToSubscription(subscription, event, postingState.isMainThread);//分发并执行方法
aborted = postingState.canceled;
} finally {
.....
}
return true;
}
return false;
}
private void postToSubscription(Subscription subscription, Object event, boolean isMainThread) {
switch (subscription.subscriberMethod.threadMode) {
case POSTING://表示默认线程,post在哪里调用,次方发就在哪里执行
invokeSubscriber(subscription, event);//这个方法表示通过java的反射机制,通过method.invoke来执行方法,其实就是主动调用
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);
}
}
我们看下invokeSubscriber方法中时什么东西
void invokeSubscriber(Subscription subscription, Object event) {
try {
//从对象中拿到注解方法对象,然后调用方法对象的invoke,把参数传递进去主动执行
subscription.subscriberMethod.method.invoke(subscription.subscriber, event);
}
....
}
到这里post方法算是执行完事了。其实Post方法说是发送事件倒不如说是,主动执行事件。我们可以看下它所做的操作:1.根据事件类型,拿到注解方法集合、2.遍历集合、3.遍历后拿到@Subscribe注解标注的方法对象,然后执行method.invoke方法。这样看起来就是就是主动执行。
三、最后看看EventBus.getDefault().unregister(obj)干了啥
public synchronized void unregister(Object subscriber) {
//根据对象拿到类型集合,这是register的时候存好的
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());
}
}
private void unsubscribeByEventType(Object subscriber, Class<?> eventType) {
//注册的时候才存好的结合,根据事件类型拿到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; subscriptions.remove(i); i--; size--; } } } }
浙公网安备 33010602011771号