1. 建立 OkHttpClient 物件

可以直接新建，也可以用建造者模式建造出來。直接新建時，其實也是使用建造者設定了預設的請求引數。

OkHttpClient client = new OkHttpClient();

OkHttpClient client = new OkHttpClient.Builder()
        .connectTimeout(5, TimeUnit.SECONDS)
        .writeTimeout(1000, TimeUnit.SECONDS)
        .readTimeout(1000, TimeUnit.SECONDS)
        .build();
 

okhttp3.Cache 構造時只需要指定快取目錄和大小即可。

網路攔截器例項：給返回的響應新增快取過期時間

private static final Interceptor REWRITE_CACHE_CONTROL_INTERCEPTOR = new
 
 Interceptor() {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Response originResponse = chain.proceed(chain.request());
        // 5 分鐘後過期
        CacheControl.Builder builder = new CacheControl.Builder()
                .maxAge(5, TimeUnit.MINUTES);

        return
 
 originResponse.newBuilder()
                .header("Cache-Control", builder.build().toString())
                .build();
    }
};

2. 準備好 Request 物件

通常用建造者模式來建造。

new Request.Builder().build();

表單的構建

new FormBody.Builder().build()

3. 傳送請求

OkHttpClient 例項先用 newCall(Request) 方法對請求再一次包裝，返回 Call 物件，表示請求已經準備好。然後有同步和非同步兩種方式來發送請求：

同步方式：

Response response = client.newCall(request).execute();

非同步方式：

Response response = client.newCall(request).enqueue(callback);

非同步方式會用一個 CachedThreadPool 執行緒池來管理非同步任務，任務一提交就馬上在非核心執行緒中執行，非核心執行緒的空閒存活期是 60s。

1. enqueue 方法會傳入一個 okhttp3.Callback 物件，需要注意的是回撥時還是在子執行緒。

new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
        // 通過runOnUiThread()方法回到主執行緒處理邏輯
        getActivity().runOnUiThread(new Runnable() {
            @Override
            public void run() {
                closeProgressDialog();
                Toast.makeText(getContext(), "載入失敗", Toast.LENGTH_SHORT).show();
            }
        });
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {

    }
}

1. enqueue 方法中，callback 被包裝成實現了 Runnable 介面的 AsyncCall 物件，傳入 OkHttpClient 的 Dispatcher 。Dispatcher 會使用執行緒池執行 AsyncCall 的 execute 方法，最終的執行結果回撥 Callback。

@Override protected void execute() {
  boolean signalledCallback = false;
  try {
    Response response = getResponseWithInterceptorChain();
    if (retryAndFollowUpInterceptor.isCanceled()) {
      signalledCallback = true;
      responseCallback.onFailure(RealCall.this, new IOException("Canceled"));
    } else {
      signalledCallback = true;
      responseCallback.onResponse(RealCall.this, response);
    }
  }

4. 攔截器

不論是 execute 方法還是 enqueue 方法傳送連結請求，最終都會呼叫 getResponseWithInterceptorChain 方法。

Response getResponseWithInterceptorChain() throws IOException {
  // Build a full stack of interceptors.
  List<Interceptor> interceptors = new ArrayList<>();
  interceptors.addAll(client.interceptors());
  interceptors.add(retryAndFollowUpInterceptor);
  interceptors.add(new BridgeInterceptor(client.cookieJar()));
  interceptors.add(new CacheInterceptor(client.internalCache()));
  interceptors.add(new ConnectInterceptor(client));
  if (!forWebSocket) {
    interceptors.addAll(client.networkInterceptors());
  }
  interceptors.add(new CallServerInterceptor(forWebSocket));

  Interceptor.Chain chain = new RealInterceptorChain(interceptors,
                null, null, null, 0,
                originalRequest, this, eventListener,
                client.connectTimeoutMillis(),
                client.readTimeoutMillis(),
                client.writeTimeoutMillis());

  return chain.proceed(originalRequest);
}

在請求往外發送時一次經過7個攔截器，第2~5個可以認為是 OkHttpCore 核心。

5. CacheInterceptor 詳解

網路請求中與快取有關的頭域：

相關響應頭：

下面將介紹快取有效性相關的 3 個概念：

1. 新鮮度檢測
2. 在驗證
3. 在驗證命中

在使用快取將 url 響應資源的副本儲存在本地時，當我們再次對該 url 資源發起請求時，可以快速從本地儲存中獲取該 url 資源，而不需要重新發起網路連線。

但是，伺服器的 url 資源可能在一定時間後被修改，因此我們不能一直使用快取資源，在一定時間之前，認為可以使用快取資源，在這個時間之後認為不能再使用快取資源，需要重新請求網路資源。這個條件的判斷就是 新鮮度檢測。就像我們在吃食品之前要看看它有沒有過期。

url 資源快取超過一定時間，我們也不會直接重新請求 url 資源，而是去伺服器檢視資源是否已經發生改變，這就叫 再驗證。

如果伺服器發現 url 資源沒有改變，就返回 304 Not Modified，並不在返回對應實體，這就叫 再驗證命中，此時我們可以繼續使用 url 資源快取。如果發生了變化，則返回 200 OK，並將改變後的 url 資源返回。

具體實現：

1. 新鮮度檢測

   http1.1 規範中，通過響應首部的 Cache-Control:max-age 和 Last-Modified 計算出絕對時間。http1.0 規範中，響應首部 Expires 的值就是絕對時間。

2. 再驗證

   超過絕對時間後要進行再驗證，需要根據響應首部具體的規範來進行 條件請求，通常有 5 種條件請求首部。

在 CacheInterceptor 原始碼中，首先獲取快取的 Response 物件（可能為 null）。然後用快取的 Response，以及當前的時間和 Request 構建 CacheStrategy 物件。

CacheStrategy strategy = new CacheStrategy
            .Factory(now, chain.request(), cacheCandidate).get();

CacheStrategy 有 networkRequest 和 cacheResponse 兩個變數，根據工廠方法傳入的三個引數，get 方法中有 5 種判斷條件來設定它們的值。

在 CacheInterceptor 的 intercept 方法中，會根據建立的 CacheStrategy 物件的兩個變數的值來進行處理。

參考資料