前言

之前我们把ARouter的原理分析了一遍，如果你是刚启动的新项目，建议立刻使用，哪天运营有这个需求了，你就可以牛逼的对他说，我早就已经做好了。

但是老项目就会有一丢丢的尴尬，所以我们要在ARouter的基础上，独立深度链接的功能，然后打造出加强版的深度链接库，我起名为DeepLinkSo。

正文

回顾一下ARouter的源码，我们记得他使用的是自定义注解，完成路由的注册和绑定。注解看上去高大上，但是在这里我认为存在一个致命的短板，那就是不够灵活。

注解的局限性

注解的解析是在编译期间完成并生成源码，也就是说版本一经发布，注册的路由地址就无法发生改变，例如

1、 开启新的路由。例如个人信息页我们并没有配置路由，我们就无法通过深度链接打开这个网页，只能修改代码，然后重新发布版本解决这个问题。
2、关闭某个路由，因为某些原因某个页面要停止外部访问，也只能修改代码，然后重新发布版本。

所以几经思考，如果路由的配置文件能够从网上下载更新的话，是不是就能让深度链接更佳灵活呢？

于是我选择了使用XML。
使用注解可以在编译期间生成源码，节省了启动时间，但是牺牲了灵活性。
使用XML恰恰相反，没有增加编译时间，而是增加了启动时间，但是我们的XML还是很小的，经过测试也就10毫秒左右，还在可以接受的范围内。

自定义XML协议

XML协议无论在前端后端都被广泛的使用，而且Android对XML解析的有很好的支持，复习一下XML解析的三种方式：

1、SAX解析
2、Pull解析（推荐）
3、Dom解析

Android推荐使用Pull解析，轻量快速，所以我们也选择使用Pull解析。

首先制定好我们的XML格式：

<?xml version="1.0" encoding="utf-8"?>
<DeepLinkSo>

    <!-- 版本号 -->
    <version value="1" />

    <!-- 拦截器会按照配置的顺序依次执行 -->
    <common-interceptors>
        <common-interceptor>com.lzp.deeplinkso.demo.interceptor.TestInterceptor</common-interceptor>
    </common-interceptors>

    <!-- 所有需要支持DeepLink的文件列表 -->
    <list>

        <!-- 跳转的页面 -->
        <Activity>
            <class>com.lzp.deeplinkso.demo.MainActivity</class>
            <page>main</page>
        </Activity>

        <!-- 跳转的页面 -->
        <Activity>
            <class>com.lzp.deeplinkso.demo.TestActivity</class>
            <page>test</page>
            <!-- 需要的参数 -->
            <params>
                <key type="Long" value="userId" />
                <key value="userName" />
            </params>
            <!-- 是否跳过公共Interceptor -->
            <skipCommonInterceptor>true</skipCommonInterceptor>
            <!-- 私有拦截器 -->
            <!--<interceptors>-->
                <!--<interceptor>com.lzp.deeplinkso.demo.interceptor.TestInterceptor</interceptor>-->
            <!--</interceptors>-->
        </Activity>

        <!-- 自定义事件 -->
        <Event>
            <class>com.lzp.deeplinkso.demo.handler.TestEventHandler</class>
            <page>event</page>
            <params>
                <key value="eventId" />
            </params>
        </Event>

    </list>

</DeepLinkSo>

我们在XML制定了以下内容：

1、版本号。可以根据降级和升级做一些操作。
2、全局拦截器。所有的跳转都会经过拦截处理，我们可以在跳转中设置跳过全局拦截器。
3、跳转的页面。可以设置对应的路由地址，跳转的参数，私有拦截器等。
4、自定义事件。设置和页面是一样的，只是不跳转页面。

这样我们的功能已经算是很全面了，接下来我们可以通过解析XML，保存所有的配置信息：

class DeepLinkSoConfig {

    /**
     * 当前版本号
     *
     *  无实际作用，仅仅是为了区别xml的版本
     * */
    private var version = "0"

    internal var listener: IDeepLinkSoListener? = null

    /**
     * 保存跳转Activity配置项
     * */
    private val activityOptionMap = HashMap<String, DeepLinkSoActivityOption>()

    /**
     * 保存自定义事件配置项
     * */
    private val eventOptionMap = HashMap<String, DeepLinkSoEventOption>()

    /**
     * 自定义拦截器
     * */
    internal var interceptors: ArrayList<IDeepLinkSoInterceptor>? = null

    internal fun setVersionCode(version: String) {
        this.version = version
    }

    fun getVersionCode() = this.version

    /**
     *  添加配置项
     * */
    internal fun addOption(key: String, option: DeepLinkSoOption) {
        when (option) {
            is DeepLinkSoActivityOption -> activityOptionMap[key] = option
            is DeepLinkSoEventOption -> eventOptionMap[key] = option
        }
    }

    /**
     *  添加配置项
     * */
    internal fun getOption(key: String): DeepLinkSoOption? {
        return activityOptionMap[key] ?: eventOptionMap[key]
    }

    /**
     *  获取Activity配置项
     * */
    internal fun getActivityOption(key: String) = activityOptionMap[key]

    /**
     *  获取Event配置项
     * */
    internal fun getEventOption(key: String) = eventOptionMap[key]

    /**
     * 清除配置项
     * */
    internal fun reset() {
        activityOptionMap.clear()
        eventOptionMap.clear()
        interceptors?.clear()
    }

}

解析的过程就不贴了，到此为止，我们已经为具体的开发做好了准备。

总结

今天我们分析了并制定了深度链接库的XML协议，思考了使用注解和XML的优劣点，为之后的功能开发做好准备。

下一篇：Android：从零开始打造自己的深度链接库（四）：DeepLinkSo实战