Interceptor调用链
Interceptor接口在OKHttp包下有5个内置实现,也就是上图中最大的那一个框。它们通过责任链的方式调用,实现了Http协议的整个流程,当然这个流程指的是应用层协议的流程,不包括底下传输层的实现。
Interceptor是可扩展可配置的,用户可以自定义实现Interceptor接口,并且通过OkHttpClient添加到Http流程的实现中去。
OKHttpClient有两个可配置的Interceptor集合(它们默认都是空的):interceptors和networkInterceptors。interceptors会被添加到调用链的最前面;而networkInterceptors则会被添加到Socket连接之后,Socket读写数据之前。但是如果是WebSocket请求,networkInterceptors集合则不会被添加到调用链中去。
Response getRespons
《Android学习笔记总结+最新移动架构视频+大厂安卓面试真题+项目实战源码讲义》
【docs.qq.com/doc/DSkNLaERkbnFoS0ZF】 完整内容开源分享
eWithInterceptorChain() throws IOException {
// Build a full stack of interceptors.
List interceptors = new ArrayList<>();
//用户自定义的拦截器会在请求最开始被调用,也就是递归的最上层
interceptors.addAll(client.interceptors());
//失败重试,代理认证、重定向等
interceptors.add(new RetryAndFollowUpInterceptor(client));
//重写请求和响应头,Cookie存储
interceptors.add(new BridgeInterceptor(client.cookieJar()));
//Http缓存流程实现
interceptors.add(new CacheInterceptor(client.internalCache()));
//发起Socket连接
interceptors.add(new ConnectInterceptor(client));
//Socket连接和数据读写之间,但是WebSocket请求不会添加这个拦截器集合
//可能WebSocket,数据通信走的是传输层,而Interceptor是应用层协议的接口?
if (!forWebSocket) {
interceptors.addAll(client.networkInterceptors());
}
//数据的读写,真正的网络I/O
interceptors.add(new CallServerInterceptor(forWebSocket));
…
}
Transmitter
Transmitter翻译过来有“传输者、传播者”的意思,所以在这里我还是用上下文来称呼它,作用域是整个Call任务。
Transmitter会在Interceptor调用链中相互传递,Interceptor会通过Transmitter对象的属性或者方法对底下的传输层进行操作,Transmitter对调用者屏蔽了传输层的实现细节,让Interceptor调用链专注于应用层协议的实现。
Transmitter管理着Call任务的很多状态(比如请求开始、请求结束、失败、取消等等),调用者随时可以获取Call的状态从而实现相应的逻辑处理,也可以根据处理的结果更新其状态。
Transmitter还持有用户配置,实现了超时回调机制等等。
Transmitter往下的代码耦合性挺强的,层次之间其实没有上面那图那么清晰,它直接会存在一些交叉,彼此之间相互调用,个人觉得这部分代码可读性是挺差的 - -!。同时多数类都是final类,并不向上提供接口,也就是这部分代码是不可扩展的,只是留有一些可配置的参数属性(比如:连接池最大空闲连接数),我不知道这是OkHttp历史版本迭代的原因,还是作者有意这样设计,如果有小伙伴对这方面有了解的话,希望可以留言跟大家分享一下。
Exchange层
这个名字是我直接根据它几个主要实现类的名称前缀来取的,可能不能很好表明这一层的具体功能。总的来说这一层主要负责连接应用层和传输层,例如:Http协议作为应用层协议,它的主要流程由上面的Interceptor调用链来实现,但是Interceptor不会直接和传输层的实现类打交道,而是通过Exchange提供的API去实现数据的读写。
Exchange层主要有三个类:Exchange、ExchangeFinder和ExchangeCodec,前两个都是Transmitter的属性,第三个有ExchangeFinder创建。
Exchange:Exchange代表着一次Request和Response,里面封装了应用层的读写方法,Interceptor调用链就是通过Transmitter获取的Exchange对象来进行读写操作。一次Request和Response,也即是上面的Interceptor调用链从RetryAndFollowUpInterceptor到CallServerInterceptor绕了一圈,但是一个Call任务并不代表仅仅只会绕一圈,比如你访问百度之前需要通过你公司的代理服务器,那么就可能在发送请求到百度之前,先发送一次Http请求到代理服务认证,认证通过了才会继续发送请求到百度,这样就绕了两圈了,也就是发送了两次Http请求,同理还有重定向也是一样。简单来说一次用户请求是一个Call,一个Call可能会发生多次Exchange,但是对于用户来说Exchange是透明的,只需要感知Call即可。
ExchangeCodec:OkHttp的编解码器,这是一个接口,具体实现有Http1ExchangeCodec和Http2ExchangeCodec。下面这图展示的是Exchange、ExchangeCodec、Okio和网络I/O,在读写操作上的层次关系。
/** Returns a new exchange to carry a new request and response. */
Exchange newExchange(Interceptor.Chain chain, boolean doExtensiveHealthChecks) {
…
ExchangeCodec codec = exchangeFinder.find(client, chain, doExtensiveHealthChecks);
Exchange result = new Exchange(this, call, eventListener, exchangeFinder, codec);
…
}
同时ExchangeFinder还负责获取和创建RealConnection,ExchangeFinder和RealConnectionPool也有比较强的耦合关系,这个后面的文章会详细介绍。
链接
Connection:Connection封装了Socket的连接操作,包括TCP连接,TLS连接,在代理隧道上构建Https连接等。一个连接创建成功后可以在存活时间内被反复使用,但是不能同时处理多个Call任务。获取Connection后,就可以通过Connection#socket()方法获取Socket对象进行读写操作。Connection是一个接口,只有一个实现类RealConnection,但是Transmitter声明Connection属性的时候,并没有使用Connection而是直接使用RealConnection,所以实际上我们也无法对其进行扩展。
RealConnectionPool:RealConnectionPool是一个finnal类,管理RealConnection的链接池。
Route:路由,例如一个Url可能通过DNS能解析出2个Host,而这2个Host是需要通过代理才能访问的,而这个代理又有两台机器组成负载均衡,那这样就会产生4条线路,每条线路就会被封装成一个Route。
RouteSelector:Route选择器,会对Route的选择上做一些优化,比如记录最近连接失败的Route,把它放到重试队列最底端,优先使用上次连接成功的Route等。
java.net
到这里,我就大体把OkHttp的层次设计概括了一遍,这些内容都是我自己读源码的理解,因此总会有不对的地方。其实读源码是必须自己打开编辑器去读的,你可以参考网上的文章,但是你如果不亲自去研读的话,是挺难理解的,也无法确定它的正确性。所以我也希望小伙伴能看了我的文章之后能够亲自去研读相关的源码,然后对比我的理解,大家相互交流,后面我也会继续带来这个系列的其他文章。