拦截器是一种能够监控,重写,重试调用的强大机制。
调用chain.proceed(request)是每个拦截器实现的关键部分。这个看似简单的方法是所有HTTP 工作发生的地方, 在这里产生一个响应应答请求。
拦截器可以是链式的,假设你有一个压缩拦截器和一个校验拦截器,那么需要决定数据是否被压缩后进行校验,或者是先校验后压缩。OkHttp采用列表的形式追踪拦截器,拦截器会被有序调用。
7.1 应用拦截器
拦截器被注册成为应用拦截器或者网络拦截器。下面通过上述定义的LoggingInterceptor来展示他们之间的不同。注册一个应用拦截器通过调用OkHttpClient.interceptors()返回的List的add()方法完成。
URL http://www.publicobject.com/helloworld.txt
重定向到
https://publicobject.com/helloworld.txt, OkHttp自动追踪这个重定向过程。我们的应用拦截器会被调用一次,从chain.proceed()返回的响应是重定向后的响应。
可以看到,请求被重定向了,因为response.request().url()返回的结果跟request.url()返回的结果不一致。两条日志打印了不一样的URL。
7.2 网络拦截器
注册网络拦截器和注册应用拦截器很类似。只是通过networkInterceptors()方法取代了interceptore()方法
可以看到,请求被重定向了,因为response.request().url()返回的结果跟request.url()返回的结果不一致。两条日志打印了不一样的URL。
7.3 在应用拦截器和网络拦截器之间如何选择
每个拦截器各有自己的优点
应用拦截器
*不必要担心响应和重定向之间的中间响应。
*通常只调用一次,即使HTTP响应是通过缓存提供的。
*遵从应用层的最初目的。与OkHttp的注入头部无关,如If-None-Match。
*允许短路而且不调用Chain.proceed()。
*允许重试和多次调用Chain.proceed()。
网络拦截器
*允许像重定向和重试一样操作中间响应。
*网络发生短路时不调用缓存响应。
*在数据被传递到网络时观察数据。
*有权获得装载请求的连接。
7.4 重写请求
通过拦截器可以添加,移除,替换请求头。也可以改变请求的请求体。例如,在知道连接的web服务器是否支持压缩格式的情况下,可以使用应用拦截器添加请求体压缩类型。
7.5 重写响应
相对应地,拦截器可以重写响应头和改变响应体。这一点比重写写请求头要危险,因为可能违反web服务器的期望。
如果你处于一种比较纠结的状态,并且准备处理结果,那么重写响应头是解决问题的有效方法。例如,可以修复服务器配置错误的Cache-Control响应头是缓存更高效。
7.6 实用性
OkHttp拦截器在OkHttp2.2以后更优。不过,没有OkUrlFactory,拦截器无法工作,基于OkHttp构建的框架有Retrofit<=1.8 版本和Picasso<=2.4版本。