探索Android路由框架-ARouter之深挖源码(二)

本文已独家授权 郭霖 ( guolin_blog ) 公众号发布!

在《 探索Android路由框架-ARouter(一)》中,主要介绍了ARouter框架的基本配置、多种跳转方案、拦截器的使用等。这一篇文章主要是对该框架的源码进行分析:    

ARouter是通过APT生成代码在框架内部进行操作,那么,项目编译生成的文件位置在那里?

项目编译生成的文件位置  

既然生成了这些源码,我们就先随便点点看看这些都是啥?

源码 - 1
源码 - 2
源码 - 3
源码 - 4

这里简简单单随便截图了APT生成的部分源码,是不是感觉跟上一篇文章使用到的代码很多相似性呐~比如拦截器的优先级是1、跳转匹配的路径也是一样的、跳转传递的参数、定义的组名等等。既然这么多一样的那肯定是在内部某部分进行封装使用,带着这个问题我们开始逐步分析。

首先,我们从该框架使用到的注解开始分析(因为注解是使用这个框架的起点)

注解分析:

首先,我们知道要使用ARouter的首先需要在类的注释上面写上 @Route 这个注解,点进源码看看

Route注解

使用该注解标注的类将被自动添加至路由表中。而且,ARouter 并非仅提供页面(Activity)的路由功能,还可以用来路由模块想要暴露给其他模块调用的接口。也就是说 @Route 不仅可用于 Activity 类,还可用于模块对外接口的实现类。那么具体它可以实现那些类型?

从上面的源码1、2、3、4截图可以看到,除了拦截器,里面通过实现接口重写方法,方法里面都有一个RouteMeta,那么我们点进去RouteMeta这个类看看:

RouteMeta

其中红色矩形中的类注释一目了然、翻译过来: 它包含基本路由信息。

截图中蓝色的矩形,RouteType,就是路由的类型。那么,这款路由框架的具体路由类型又有那些?带着这个疑问,点进RouteType 源码看看。

RouterType

首先这是一个枚举,这些就是框架可以具体使用到的路由类型

说完Route 这个注解,我们在来看看@Interceptor 拦截器注解,

Interceptor 注解

哦,我们发现拦截器的注解就2个方法,第一个是定义优先级的,第二个就是拦截器的名字。

接着,@Autowired 注解:

我们知道这个注解是界面跳转时参数传递用的。Activity 中使用该注解标志的变量,会在页面被路由打开的时候自动赋予传递的参数值。赋值的操作可以参考上面的源码 - 4截图。

初始化分析:

我们知道,ARouter框架使用的第一个步骤,是要先初始化,也就是调用:ARouter.init( Application.this );这个API,那么,它的初始化究竟是做了那些东西?我们先点进源码看看:

ARouter.init()

那么,实际上它调用的是绿色矩形内的代码,绿色矩形内有两个初始化,一个是 _ARouter.init(application),还有一个是 _ARouter.afterInit( )

我们首先点进 _ARouter . init()看看,

 _ARouter

A:红色箭头的是类注释,翻译过来就是:ARouter核心( 外观模式 )

B:绿色箭头代表的是一个线程池,对线程池概念不是很清楚的朋友可以点进 必须要理清的Java线程池 先了解一下

C:蓝色箭头代表的是 这个_ARouter init()实际是调用的LogisticsCenter里面的init方法。

首先,什么是外观模式?

简单点理解就是,通过创建一个统一的类,用来包装子系统中一个或多个复杂的类,客户端可以通过调用外观类的方法来调用内部子系统中所有方法。大概意思就是这样,想深入理解的话可以自行查阅资料。

其次,这个线程池做了什么功能?

点进去DefaultPoolExecutor这个类看看:

DefaultPoolExecutor

由源码得知就是创建了一个数组阻塞队列的线程池

最后,我们点进LogisticsCenter,看看里面的init方法执行了什么操作(因为源码太长,我就分别截图)

LogisticsCenter - init (1)
LogisticsCenter - init (2)

通过LogisticsCenter - init(1)这幅源码图可以得知:如果是Debug模式,则执行从if代码块; 如果是Release模式:通过PackageUtils.isNewVersion(context)判断当前应用是否是第一次启动。接着,获取arouter-compiler生成的文件,然后将该文件,存储在sp中,下次启动应用的时候,直接从sp缓存中读取。

然后,在LogisticsCenter - init(2)红色矩形的代码块可以得知:首先遍历arouter-compiler生成的文件,将他们按照类型分别存储到Warehouse的对应字段中。也就是,如果类名前缀符合文件拼接规则,比如为com.alibaba.android.arouter.routes.ARouter$$Root的文件,就将其添加到具体的Warehouse里面的集合中。也就是对应的这里

对应的文件

那么,这个文件拼接规则(也就是字符串拼接)是?

文件拼接规则

Warehouse又是什么?点进源码看看

Warehouse

其中,Warehouse的类注释写的非常好,翻译过来就是:路由元数据和其他数据的存储。这个类本质就是路由文件映射表。里面提供了各种HashMap集合(Map不允许重复的key),去存储SP存储的值。

我们再看看这里存储拦截器的集合,UniqueKeyTreeMap,这个类是存储拦截器的,我们看看它做了什么?

UniqueKeyTreeMap

原来,这个UniqueKeyTreeMap,就是继承了TreeMap,哦,我们知道TreeMap是一种有序的集合(底层帮我们排序)所以数值越小,它就优先添加拦截器。这样也就解释了为什么拦截器属性值设置的越低,优先级越高。

综上,针对 _ARouter init( ) 这个初始化的源码我们可以得知以下:

A:初始化这一操作,表面上是_ARouter ,实则是LogisticsCenter 在帮我们管理逻辑

B:LogisticsCenter 内部通过先存储SP,然后遍历、匹配(满足条件则添加到具体的集合中,按照文件的前缀不同,将他们添加到路由映射表Warehouse的groupsIndex、interceptorsIndex、providersIndex 中)

C:具体的路由清单是Warehouse ,不仅保存实例,还给我们提供了缓存。也就是说 同一个目标(RouteMeta、IProvider、IInterceptor)仅会在第一次使用的时候创建一次,然后缓存起来。后面都是直接使用的缓存。

初始化还有一个API,_ARouter.afterInit( ) ; 这个API在上面的截图也有,那么这个API是用来干什么的?我们点进去看看。

_ARouter.afterInit

首先,它实例化了一个InterceptorService。这里的InterceptorService下面会说。 这里的build方法,最终返回的是一个Postcard对象:

build

从源码可以得知,实际上它返回的却是,_ARouter.getInstance().build(path)这个方法,这个方法是一个方法重载(一般用的最多的就是这一个,也就是默认分组,不进行自定义分组),跟进去看看(源码很长,分为以下两个截图):

_ARouter.getInstance().build - 1
_ARouter.getInstance().build - 2

发现这里有一个PathReplaceService(也就是红色矩形),这个PathReplaceService又是什么,点进去看看

PathReplaceService

这个类注释翻译过来就是:预处理路径。这个接口是IProvider的子类

让我们在看回绿色箭头,其中,navigation(clazz)这种方式是属于根据类型查找,而build(path)是根据名称进行查找。如果应用中没有实现PathReplaceService这个接口,则pService=null。PathReplaceService可以对所有的路径进行预处理,然后返回一个新的值(返回一个新的String和Uri)。绿色箭头有一个extractGroup()方法,点进去看看:

extractGroup

extractGroup(path)这个方法,核心逻辑是红色矩形内的代码,这个方法主要是获取分组名称。切割path字符串,默认为path中第一部分为组名。这就证明了如果我们不自定义分组,默认就是第一个分号的内容。

分析完了build,我们在看看navigation

navigation

继续点进源码看看,发现进入了_ARouter这个类里面的navigation方法:

navigation - 1
navigation - 2

其中,navigation - 1这幅图中的红色矩形代表的意思是,如果(两个)路径没写对,ARouter会Toast提示客户端,路径不对。

navigation - 2这幅图中的红色矩形代表的是忽略拦截器。interceptorService实例化对象的时机,是在_ARouter这类中的afterInit( )进行实例化的。这幅图中的蓝色矩形和箭头的方法真实逻辑是调用了下图的方法:

通过这段代码我们可以得知:

1:如果navigation()不传入Activity作为context,则使用Application作为context

2:内部使用了Intent来进行传递

3:如果在跳转时,设置了flags,且没有设置Activity作为context,则下面的startActivity()方法会发生错误,因为缺少Activity的Task栈;

4:Fragment的判断根据版本不同进行了相应的判断

看到了这里,我们在看回navigation - 2这幅图。如果(两个)路径匹配的话,会执行到截图中的蓝色矩形,点进蓝色矩形里面去看看(也就是 LogisticsCenter.completion( Postcard )):

LogisticsCenter.completion - 1
LogisticsCenter.completion - 2
LogisticsCenter.completion - 3

首先,根据path在Warehouse.routes映射表中查找对应的RouteMeta。但是,第一次加载的时候,是没有数据的。(而第一次加载是在LogisticsCenter.init()中,上面也说了。因此只有`Warehouse`的`groupsIndex、interceptorsIndex、providersIndex` 有数据),因此这个时候routeMeta=null。所以,这个时候会先从Warehouse.groupsIndex中取出类名前缀为com.alibaba.android.arouter.routes.ARouter$$Group$$group的文件;接着,将我们添加@Route注解的类映射到Warehouse.routes中;然后将已经加载过的组从Warehouse.groupsIndex中移除,这样也避免了重复添加进Warehouse.routes;注意,这个时候Warehouse.routes已经有值了,所以重新调用本方法(completion(postcard))执行了else代码块。

然后,LogisticsCenter.completion - 2 图中就是具体的设置属性值;然后在 LogisticsCenter.completion - 3 图中,对 IProvider的子类进行初始化 provider.init(mContext); 初始化完毕以后,将IProvider的子类添加进Warehouse.providers中;最后将IProvider的实现类保存在postcard中,因此可以从postcard获取IProvider的实例对象,其中,greenChannel()会忽略拦截器这个前面也说了。

小结:

在LogisticsCenter.completion这个方法里面完成了对Warehouse.providers、Warehouse.routes的赋值。那么Warehouse.interceptors又是在哪里赋值的呢?

IProvider有个子类接口,InterceptorService(在文章的上面,也简单提到过这个接口)

InterceptorService

因此InterceptorServiceImpl也是IProvider的子类;在LogisticsCenter.completion()中,有provider.init(context)的初始化 ;那么,我们看看InterceptorServiceImpl这个拦截器的实现类,

InterceptorServiceImpl

在InterceptorServiceImpl这个类里面的红色矩形中,完成了具体拦截器的初始化以及将拦截器添加到Warehouse.interceptors映射表中。

写到这里,ARouter框架的源码基本上就分析完毕了。可能你说,这不是只是初始化嘛,是的这只是初始化,但是界面跳转的源码都涵盖在上面了,你可能不信,我们点击跳转的API去看看:

简单跳转

点击build,又跳进熟悉的build里面来了:

build

同样,点击navigation,也回到了上面的navigation中去了。

源码基本上就写到这里,内容有点绕。个人建议自己对着源码好好过一遍,这样理解的效果可能会比较好。

如果这篇文章对您有开发or学习上的些许帮助,希望各位看官留下宝贵的star,谢谢。

Ps:著作权归作者所有,转载请注明作者, 商业转载请联系作者获得授权,非商业转载请注明出处(开头或结尾请添加转载出处,添加原文url地址),文章请勿滥用、开源项目仅供学习交流、也希望大家尊重笔者的劳动成果,谢谢。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容

  • Arouter框架适合项目比较大,模块多的时候,可以实现解耦,不需要知道跳转的是哪个activity,只需要知道配...
    破晓11阅读 3,457评论 0 2
  • 组件化 模块化、组件化与插件化 在项目发展到一定程度,随着人员的增多,代码越来越臃肿,这时候就必须进行模块化的拆分...
    silentleaf阅读 4,943评论 2 12
  • 本文章用于记录笔者学习 ARouter 源码的过程,仅供参考,如有错误之处还望悉心指出,一起交流学习。 ARout...
    DevLocke阅读 13,945评论 6 52
  • 酒的危害,想必大家都知道吧!饮次酒不算什么,可如果长期饮酒,可能会引起肝脾肿大、消化道炎症甚至癌变呢!可是老...
    海棠味的棒棒糖阅读 379评论 0 0
  • 没有什么不可能 你是我要的对的那个人 亲爱的,愿相伴左右,白首百年 不是需要所有人知道我爱你 只要我知道我懂我明白...
    心想荣阅读 219评论 0 0