me.jessyan.retrofiturlmanager.parser

Class SuperUrlParser

java.lang.Object

me.jessyan.retrofiturlmanager.parser.SuperUrlParser

All Implemented Interfaces:

UrlParser

public class SuperUrlParser
extends java.lang.Object
implements UrlParser

================================================ 超级解析器 超级模式属于高级模式的加强版, 优先级高于高级模式, 在高级模式中, 需要传入一个 BaseUrl (您传入 Retrofit 的 BaseUrl) 作为被替换的基准 如这个传入的 BaseUrl 为 "https://www.github.com/wiki/part" (PathSize = 2), 那框架会将所有需要被替换的 Url 中的 域名 以及 域名 后面的前两个 pathSegments 使用您传入 RetrofitUrlManager.putDomain(String, String) 方法的 Url 替换掉 但如果突然有一小部分的 Url 只想将 "https://www.github.com/wiki" (PathSize = 1) 替换掉, 后面的 pathSegment '/part' 想被保留下来 这时项目中就出现了多个 PathSize 不同的需要被替换的 BaseUrl

使用高级模式实现这种需求略显麻烦, 所以我创建了超级模式, 让每一个 Url 都可以随意指定不同的 BaseUrl (PathSize 自己定) 作为被替换的基准 使 RetrofitUrlManager 可以从容应对各种复杂的需求

超级模式也需要手动开启, 但与高级模式不同的是, 开启超级模式并不需要调用 API, 只需要在 Url 中加入 RetrofitUrlManager.IDENTIFICATION_PATH_SIZE + PathSize

替换规则如下: 1. 旧 URL 地址为 https://www.github.com/wiki/part#baseurl_path_size=1, #baseurl_path_size=1 表示其中 BaseUrl 为 https://www.github.com/wiki 您调用 RetrofitUrlManager.putDomain(String, String)方法传入的 URL 地址是 https://www.google.com/api 经过本解析器解析后生成的新 URL 地址为 http://www.google.com/api/part

2. 旧 URL 地址为 https://www.github.com/wiki/part#baseurl_path_size=1, #baseurl_path_size=1 表示其中 BaseUrl 为 https://www.github.com/wiki 您调用 RetrofitUrlManager.putDomain(String, String)方法传入的 URL 地址是 https://www.google.com 经过本解析器解析后生成的新 URL 地址为 http://www.google.com/part

3. 旧 URL 地址为 https://www.github.com/wiki/part#baseurl_path_size=0, #baseurl_path_size=0 表示其中 BaseUrl 为 https://www.github.com 您调用 RetrofitUrlManager.putDomain(String, String)方法传入的 URL 地址是 https://www.google.com/api 经过本解析器解析后生成的新 URL 地址为 http://www.google.com/api/wiki/part

4. 旧 URL 地址为 https://www.github.com/wiki/part/issues/1#baseurl_path_size=3, #baseurl_path_size=3 表示其中 BaseUrl 为 https://www.github.com/wiki/part/issues 您调用 RetrofitUrlManager.putDomain(String, String)方法传入的 URL 地址是 https://www.google.com/api 经过本解析器解析后生成的新 URL 地址为 http://www.google.com/api/1

See Also:

Created by JessYan on 2018/6/21 16:41 Contact me Follow me ================================================

Constructor Summary

Constructors

Constructor and Description
SuperUrlParser()

Method Summary

Modifier and Type	Method and Description
void	init(RetrofitUrlManager retrofitUrlManager) 这里可以做一些初始化操作
okhttp3.HttpUrl	parseUrl(okhttp3.HttpUrl domainUrl, okhttp3.HttpUrl url) 将 RetrofitUrlManager.mDomainNameHub 中映射的 URL 解析成完整的HttpUrl 用来替换 @Request.url 达到动态切换 URL

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SuperUrlParser

public SuperUrlParser()

Method Detail

init

public void init(RetrofitUrlManager retrofitUrlManager)

Description copied from interface: UrlParser

这里可以做一些初始化操作

Specified by:

init in interface UrlParser

Parameters:

retrofitUrlManager - RetrofitUrlManager

parseUrl

public okhttp3.HttpUrl parseUrl(okhttp3.HttpUrl domainUrl,
                                okhttp3.HttpUrl url)

Description copied from interface: UrlParser

将 RetrofitUrlManager.mDomainNameHub 中映射的 URL 解析成完整的HttpUrl 用来替换 @Request.url 达到动态切换 URL

Specified by:

parseUrl in interface UrlParser

Parameters:

domainUrl - 用于替换的 URL 地址

url - 旧 URL 地址

Returns: