OKHttp开源框架学习八：拦截器之CacheInterceptor

目录

系列文章：

代码：

---

系列文章：

OKHttp开源框架学习一：同步请求总结

OKHttp开源框架学习二：异步请求总结

OKHttp开源框架学习三：任务调度核心类Dispatcher

OKHttp开源框架学习四：拦截器

OKHttp开源框架学习五：拦截器之RetryAndFollowUpInterceptor

OKHttp开源框架学习六：拦截器之BridgeInterceptor

OKHttp开源框架学习七：缓存策略源码分析

OKHttp开源框架学习八：拦截器之CacheInterceptor

OKHttp开源框架学习九：拦截器之ConnectInterceptor

OKHttp开源框架学习十：ConnectionPool连接池

OKHttp开源框架学习十一：拦截器之CallServerInterceptor

Okhttp总结

代码：

CacheInterceptor.java

@Override public Response intercept(Chain chain) throws IOException {
    //尝试获取缓存  Candidate（候选人） 
    Response cacheCandidate = cache != null
        ? cache.get(chain.request())
        : null;

    long now = System.currentTimeMillis();

    //缓存策略
    CacheStrategy strategy = new CacheStrategy.Factory(now, chain.request(), cacheCandidate).get();
    //通过网络Request获取response
    Request networkRequest = strategy.networkRequest;
    //通过缓存获取response
    Response cacheResponse = strategy.cacheResponse;

    if (cache != null) {
      //有缓存的情况下，更新一下相关的统计指标，增加命中率
      cache.trackResponse(strategy);
    }

    //如果缓存不符合要求，就关掉。类似于对IO流的处理
    if (cacheCandidate != null && cacheResponse == null) {
      closeQuietly(cacheCandidate.body()); // The cache candidate wasn't applicable. Close it.
    }

    // If we're forbidden from using the network and the cache is insufficient（不充分的，
    //  不足的）, fail.
    //如果网络不可用或者缓存数据不完整，失败
    if (networkRequest == null && cacheResponse == null) {
      return new Response.Builder()
          .request(chain.request())
          .protocol(Protocol.HTTP_1_1)
          .code(504)
          .message("Unsatisfiable Request (only-if-cached)")
          .body(Util.EMPTY_RESPONSE)
          .sentRequestAtMillis(-1L)
          .receivedResponseAtMillis(System.currentTimeMillis())
          .build();
    }

    // If we don't need the network, we're done.
    //如果不需要要网络获取，至此可以结束了
    if (networkRequest == null) {
      return cacheResponse.newBuilder()
          .cacheResponse(stripBody(cacheResponse))
          .build();
    }

    //通过网络Request获取response
    Response networkResponse = null;
    try {
      networkResponse = chain.proceed(networkRequest);
    } finally {
      // If we're crashing on I/O or otherwise, don't leak the cache body.
      if (networkResponse == null && cacheCandidate != null) {
        closeQuietly(cacheCandidate.body());
      }
    }

    // If we have a cache response too, then we're doing a conditional get.
    if (cacheResponse != null) {
      if (networkResponse.code() == HTTP_NOT_MODIFIED) {
        Response response = cacheResponse.newBuilder()
            .headers(combine(cacheResponse.headers(), networkResponse.headers()))
            .sentRequestAtMillis(networkResponse.sentRequestAtMillis())
            .receivedResponseAtMillis(networkResponse.receivedResponseAtMillis())
            .cacheResponse(stripBody(cacheResponse))
            .networkResponse(stripBody(networkResponse))
            .build();
        networkResponse.body().close();

        // Update the cache after combining headers but before stripping the
        // Content-Encoding header (as performed by initContentStream()).
        cache.trackConditionalCacheHit();
        cache.update(cacheResponse, response);
        return response;
      } else {
        closeQuietly(cacheResponse.body());
      }
    }

    Response response = networkResponse.newBuilder()
        .cacheResponse(stripBody(cacheResponse))
        .networkResponse(stripBody(networkResponse))
        .build();

    if (cache != null) {
      if (HttpHeaders.hasBody(response) && CacheStrategy.isCacheable(response, networkRequest)) {
        // Offer this request to the cache.
        CacheRequest cacheRequest = cache.put(response);
        return cacheWritingResponse(cacheRequest, response);
      }

      //如果缓存是无效的，就移除
      if (HttpMethod.invalidatesCache(networkRequest.method())) {
        try {
          cache.remove(networkRequest);
        } catch (IOException ignored) {
          // The cache cannot be written.
        }
      }
    }

    return response;
  }