Android OkhttpInterceptor 笔记：Bri

Anroid OKhttp笔记1 流程分析
Android OkhttpInterceptor 笔记：RetryAndFollowUpInterceptor
Android OkhttpInterceptor 笔记：BridgeInterceptor
Android OkhttpInterceptor 笔记：ConnectInterceptor
Android OkhttpInterceptor 笔记：CacheInterceptor
Android OkhttpInterceptor 笔记：CallServerInterceptor
Android Okhttp笔记:ConnectionPool
Android Okhttp3:Dispatcher分析笔记

一、综述

1.概念

桥接(Bridge)是用于把抽象化与实现化解耦,使得二者可以独立变化。
BridgeInterceptor是一个处理请求与返回的拦截器，它会对请求的Header进行一些处理，然后将工作交到下一级Interceptor，下一级完成后，再对返回进行处理。

2.作用

BridgeInterceptor 拦截器的功能主要有以下 3 点：

1.是负责将用户构建的一个 Request 请求转化为能够进行网络访问的请求。
2.将这个符合网络请求的 Request 进行网络请求。
3.将网络请求回来的响应 Response 转化为用户可用的 Response。

二、源码

     @Override public Response intercept(Chain chain) throws IOException {
Request userRequest = chain.request();
Request.Builder requestBuilder = userRequest.newBuilder();

RequestBody body = userRequest.body();
if (body != null) {
  MediaType contentType = body.contentType();
  if (contentType != null) {
    requestBuilder.header("Content-Type", contentType.toString());
  }

  long contentLength = body.contentLength();
  if (contentLength != -1) {
    requestBuilder.header("Content-Length", Long.toString(contentLength));
    requestBuilder.removeHeader("Transfer-Encoding");
  } else {
    requestBuilder.header("Transfer-Encoding", "chunked");
    requestBuilder.removeHeader("Content-Length");
  }
}

if (userRequest.header("Host") == null) {
  requestBuilder.header("Host", hostHeader(userRequest.url(), false));
}

if (userRequest.header("Connection") == null) {
  requestBuilder.header("Connection", "Keep-Alive");
}

// If we add an "Accept-Encoding: gzip" header field we're responsible for also decompressing
// the transfer stream.
//如果我们添加一个“Accept-Encoding：gzip”头字段，我们也负责解压缩传输流。

boolean transparentGzip = false;
if (userRequest.header("Accept-Encoding") == null && userRequest.header("Range") == null) {
  transparentGzip = true;
  requestBuilder.header("Accept-Encoding", "gzip");
}

List<Cookie> cookies = cookieJar.loadForRequest(userRequest.url());
if (!cookies.isEmpty()) {
  requestBuilder.header("Cookie", cookieHeader(cookies));
}

if (userRequest.header("User-Agent") == null) {
  requestBuilder.header("User-Agent", Version.userAgent());
}

Response networkResponse = chain.proceed(requestBuilder.build());
  //解析服务器返回的Header，如果没有这个cookie，则不进行解析
HttpHeaders.receiveHeaders(cookieJar, userRequest.url(), networkResponse.headers());

Response.Builder responseBuilder = networkResponse.newBuilder()
    .request(userRequest);
//判断服务器是否支持gzip压缩，如果支持，则将压缩提交给Okio库来处理
if (transparentGzip
    && "gzip".equalsIgnoreCase(networkResponse.header("Content-Encoding"))
    && HttpHeaders.hasBody(networkResponse)) {
  GzipSource responseBody = new GzipSource(networkResponse.body().source());
  Headers strippedHeaders = networkResponse.headers().newBuilder()
      .removeAll("Content-Encoding")
      .removeAll("Content-Length")
      .build();
  responseBuilder.headers(strippedHeaders);
  String contentType = networkResponse.header("Content-Type");
  responseBuilder.body(new RealResponseBody(contentType, -1L, Okio.buffer(responseBody)));
}

return responseBuilder.build();
}

三、分析

过程并不复杂，BridgeInterceptor是一个连接桥，它负责把用户构造的请求转换为发送给服务器的请求，把服务器返回的响应转换为对用户友好的响应。
转换的过程就是添加一些服务端需要的header信息。
在Request阶段配置用户信息，并添加一些请求头。在Response阶段，进行gzip解压。

1.cookieJar

BridgeInterceptor初始化方法中也实例了cookieJar，cookieJar就是个接口，里面有两个方法：

saveFromResponse 自定义去存储cookie
loadForRequest 获取指定URL的cookie

2.关于"Accept-Encoding",

如果Response是gzip模式且transparentGzip为true且HttpHeaders.hasBody为true时，会去掉Headers中的"Content-Encoding"和"Content-Length"。

开发者没有添加Accept-Encoding时，自动添加Accept-Encoding: gzip

当用户未设置Accep-Encoding时，用户期望的Content-Length是返回的内容长度。但由于okhttp在用户未设置Accep-Encoding时，会进行gzip的转换。当HTTP使用gzip方式时，Content-Length的返回是根据gzip压缩后的长度进行返回的。此时Content-Length的值与用户所期望的不符的。因为用户并没有主动使用gzip模式。

所以，此时okhttp选择将Content-Length remove掉，以免让调用者产生误解。

Anroid OKhttp笔记1 流程分析
Android OkhttpInterceptor 笔记：RetryAndFollowUpInterceptor
Android OkhttpInterceptor 笔记：BridgeInterceptor
Android OkhttpInterceptor 笔记：ConnectInterceptor
Android OkhttpInterceptor 笔记：CacheInterceptor
Android OkhttpInterceptor 笔记：CallServerInterceptor
Android Okhttp笔记:ConnectionPool
Android Okhttp3:Dispatcher分析笔记