前面作者分析了一遍WMRouter
的源代码,趁着思路比较活跃,就打算把ARouter
的源码也看一下,然后对这两个路由方案做一个对比。
文章是作者学习
ARouter
的源码的重点纪要。 ARouter官方文档 : https://github.com/alibaba/ARouter/blob/master/README_CN.md
先通过一张图来了解ARouter
的路由过程以及相关类:
本文先不对路由表的生成做详细了解,也不对InterceptorService
、GlobalDegradeService
的加载做仔细分析,我们就先根据源码来大致看一遍路由的基本过程。
基本路由流程
在ARouter
中如果使用一个 @Route(path = "/test/activity1")
注解标注在了一个Activity
上,那么这个Activity
就是可被路由的。我们可以通过调用下面代码实现页面跳转:
ARouter.getInstance()
.build("/test/activity1")
.navigation(context, new NavigationCallback());
ARouter
只是一个门面类,实际功能的实现是由_ARouter
完成的。来看一下_ARouter.navigation()方法
。注意为了只看主流程,我删去了一些逻辑
protected Object navigation(final Context context, final Postcard postcard, final int requestCode, final NavigationCallback callback) {
try {
LogisticsCenter.completion(postcard); //装配 postcard
} catch (NoRouteFoundException ex) {
logger.warning(Consts.TAG, ex.getMessage());
if (null != callback) {
callback.onLost(postcard); //页面降级
} else {
DegradeService degradeService = ARouter.getInstance().navigation(DegradeService.class);
degradeService.onLost(context, postcard); //全局降级
}
return null;
}
if (null != callback) callback.onFound(postcard);
//新开线程,异步执行拦截器
interceptorService.doInterceptions(postcard, new InterceptorCallback() {
@Override public void onContinue(Postcard postcard) {
_navigation(context, postcard, requestCode, callback);
}
@Override public void onInterrupt(Throwable exception) {
callback.onInterrupt(postcard);
}
});
return null;
}
LogisticsCenter 装配 Postcard
public synchronized static void completion(Postcard postcard) {
//从路由表中获取该路由的RouteMeta
RouteMeta routeMeta = Warehouse.routes.get(postcard.getPath());
if (null == routeMeta) { //路由表中不存在就尝试加载
Class<? extends IRouteGroup> groupMeta = Warehouse.groupsIndex.get(postcard.getGroup()); // 首先把这次路由对应的路由组的表加载出来
if (null == groupMeta) {
throw new NoRouteFoundException(TAG + "There is no route match the path [" + postcard.getPath() + "], in group [" + postcard.getGroup() + "]");
} else {
try {
IRouteGroup iGroupInstance = groupMeta.getConstructor().newInstance();
iGroupInstance.loadInto(Warehouse.routes);
Warehouse.groupsIndex.remove(postcard.getGroup());
} catch (Exception e) {
throw new HandlerException(TAG + "Fatal exception when loading group meta. [" + e.getMessage() + "]");
}
completion(postcard); // Reload
}
} else {
//把对用的RouteMeta信息设置到Postcard中
postcard.setDestination(routeMeta.getDestination()); // destination这里就是Activity类对象
postcard.setType(routeMeta.getType());
....
postcard.withString(ARouter.RAW_URI, postcard.getUri().toString());
...
}
}
来总结一下这个方法的主要流程:
- 尝试从路由表
Warehouse.routes
获取postcard.getPath()
对应的路由信息。 - 如果不存在
RouteMeta
,则加载postcard.getPath()
对应的路由组表Warehouse.groupsIndex
。如果根本不存在对应的组,则路由失败 - 实例化
Warehouse.groupsIndex
, 然后把表内的信息加载到Warehouse.routes
表中,再次调用completion()
- 获取到
postcard.getPath()
对应的RouteMeta
,使用RouteMeta
完善Postcard
我们先来看一眼如何把Warehouse.groupsIndex
的信息加载到Warehouse.routes
中:
这其实IRouteGroup
接口的实例是动态生成的:
public class ARouter$$Group$$test implements IRouteGroup {
@Override
public void loadInto(Map<String, RouteMeta> atlas) {
atlas.put("/test/activity1", RouteMeta.build(RouteType.ACTIVITY, Test1Activity.class, "/test/activity1", "test", -1, -2147483648));
atlas.put("/test/activity2", RouteMeta.build(RouteType.ACTIVITY, Test2Activity.class, "/test/activity2", "test", -1, -2147483648));
}
}
即loadInto()
实际上是把路由信息放入到Warehouse.routes
中。
浅尝辄止,我们继续往下看,这里我们直接看拦截器实例:
拦截器
@Route(path = "/arouter/service/interceptor")
public class InterceptorServiceImpl implements InterceptorService {
@Override
public void doInterceptions(final Postcard postcard, final InterceptorCallback callback) {
if (null != Warehouse.interceptors && Warehouse.interceptors.size() > 0) {
..确保拦截器初始化完毕
LogisticsCenter.executor.execute(new Runnable() {
@Override
public void run() {
//依次执行每一个拦截器
_excute(0, interceptorCounter, postcard);
}
});
} else {
callback.onContinue(postcard);
}
}
}
@Route(path = "/arouter/service/interceptor")
标注,其实这个拦截器会在运行时动态加载。可以看到大致逻辑就是:
在异步线程中依次执行每一个拦截器。其实在这里可以看出ARouter
的拦截器是全局的,即每一次路由如果不设置不被拦截的标志,则都会把拦截器走一遍。
在Postcard组装完毕和拦截器执行完毕后,就会调用_navigation()
private Object _navigation(final Context context, final Postcard postcard, final int requestCode, final NavigationCallback callback) {
final Context currentContext = null == context ? mContext : context;
switch (postcard.getType()) {
case ACTIVITY:
// intent中设置一些信息。
// Navigation in main looper.
runInMainThread(new Runnable() {
@Override
public void run() {
startActivity(requestCode, currentContext, intent, postcard, callback);
}
});
break;
case ...
}
return null;
}
到这里,一次Activity的路由算是完成了。不过这其中我们还有很多细节没有仔细讨论:1
-
Warehouse.routes
路由表和Warehouse.groupsIndex
路由组表是如何加载的 -
InterceptorService
、DegradeService
是如何加载的 - ARouter是支持在运行时期获取不在同一个库的类实例的,比如
Fragment
,这是怎么实现的呢? - ..
这些点,我们在后续文章再继续分析。