Interceptor可以說是OkHttp的核心功能，它就是通過Interceptor來完成監控管理、重寫和重試請求的。下面是一個簡單的Interceptor，可以監控request的輸入引數和response的輸出內容。

class LoggingInterceptor implements Interceptor {
  @Override public Response intercept(Interceptor.Chain chain) throws IOException {
    Request request = chain.request();

    long t1 = System.nanoTime();
    logger.info(String.format("Sending request %s on %s%n%s"
 
,
        request.url(), chain.connection(), request.headers()));

    Response response = chain.proceed(request);

    long t2 = System.nanoTime();
    logger.info(String.format("Received response for %s in %.1fms%n%s",
        response.request().url(), (t2 - t1) / 1e6d, response.headers()));

    return
 
 response;
  }
}

裡面有個方法呼叫chain.proceed(request)，每個Interceptor實現裡都有這個呼叫方法，這個看起來簡單的方法卻是所有的HTTP請求、生成response的關鍵所在。

Interceptors可以被串聯起來（chained）。OkHttp使用lists來管理Interceptors,讓這些Interceptors按順序被呼叫。

Application Interceptors

我們只能通過Application Interceptors或者Network Interceptors來註冊自定義的Interceptors，其他Interceptors都是OkHttp幫你做好了的，比如RetryAndFollowUpInterceptor、BridgeInterceptor、CacheInterceptor、ConnectInterceptor、CallServerInterceptor。這裡的OkHttp會啟動一個攔截器呼叫鏈，攔截器遞迴呼叫之後最後返回請求的響應Response。這裡的攔截器分層的思想就是借鑑的網路裡的分層模型的思想。請求從最上面一層到最下一層，響應從最下一層到最上一層，每一層只負責自己的任務，對請求或響應做自己負責的那塊的修改。

Application Interceptors和Network Interceptors分別位於七層模型的第一層和第六層。這個從RealCall裡的getResponseWithInterceptorChain方法中就可以看出來：

Response getResponseWithInterceptorChain() throws IOException {
    // Build a full stack of interceptors.
    List<Interceptor> interceptors = new ArrayList<>();
    interceptors.addAll(client.interceptors()); // Application 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()); // Network Interceptors
    }
    interceptors.add(new CallServerInterceptor(forWebSocket));

    Interceptor.Chain chain = new RealInterceptorChain(
        interceptors, null, null, null, 0, originalRequest);
    return chain.proceed(originalRequest);
  }

我們通過這個LoggingInterceptor 來說明Application Interceptors和Network Interceptors的區別。

通過OkHttpClient.Builder的addInterceptor()註冊一個 application interceptor:

OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(new LoggingInterceptor())
    .build();

Request request = new Request.Builder()
    .url("http://www.publicobject.com/helloworld.txt")
    .header("User-Agent", "OkHttp Example")
    .build();

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

URL http://www.publicobject.com/helloworld.txt會重定向到https://publicobject.com/helloworld.txt,OkHttp會自動follow這次重定向。application interceptor會被呼叫once，並且會返回攜帶有重定向後的redirected response。

INFO: Sending request http://www.publicobject.com/helloworld.txt on null
User-Agent: OkHttp Example

INFO: Received response for https://publicobject.com/helloworld.txt in 1179.7ms
Server: nginx/1.4.6 (Ubuntu)
Content-Type: text/plain
Content-Length: 1759
Connection: keep-alive

我們可以看到，會重定向是因我request的URL和response的URL是不同的，日誌也列印了兩個不同的URLs。

Network Interceptors

註冊一個Network Interceptors的方式是非常類似的，只需要將addInterceptor()替換為addNetworkInterceptor()：

OkHttpClient client = new OkHttpClient.Builder()
    .addNetworkInterceptor(new LoggingInterceptor())
    .build();

Request request = new Request.Builder()
    .url("http://www.publicobject.com/helloworld.txt")
    .header("User-Agent", "OkHttp Example")
    .build();

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

當我們執行上面這段程式碼，這個interceptor會執行twice。一次是呼叫在初始的request http://www.publicobject.com/helloworld.txt，另外一次是呼叫在重定向後的redirect request https://publicobject.com/helloworld.txt。

INFO: Sending request http://www.publicobject.com/helloworld.txt on Connection{www.publicobject.com:80, proxy=DIRECT hostAddress=54.187.32.157 cipherSuite=none protocol=http/1.1}
User-Agent: OkHttp Example
Host: www.publicobject.com
Connection: Keep-Alive
Accept-Encoding: gzip

INFO: Received response for http://www.publicobject.com/helloworld.txt in 115.6ms
Server: nginx/1.4.6 (Ubuntu)
Content-Type: text/html
Content-Length: 193
Connection: keep-alive
Location: https://publicobject.com/helloworld.txt

INFO: Sending request https://publicobject.com/helloworld.txt on Connection{publicobject.com:443, proxy=DIRECT hostAddress=54.187.32.157 cipherSuite=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA protocol=http/1.1}
User-Agent: OkHttp Example
Host: publicobject.com
Connection: Keep-Alive
Accept-Encoding: gzip

INFO: Received response for https://publicobject.com/helloworld.txt in 80.9ms
Server: nginx/1.4.6 (Ubuntu)
Content-Type: text/plain
Content-Length: 1759
Connection: keep-alive

Application and Network interceptors 該如何選擇

這兩個interceptor都有他們各自的優缺點：

Application Interceptors

• 不需要關心由重定向、重試請求等造成的中間response產物。
• 總會被呼叫一次，即使HTTP response是從快取（cache）中獲取到的。
• 關注原始的request，而不關心注入的headers，比如If-None-Match。
• interceptor可以被取消呼叫，不呼叫Chain.proceed()。
• interceptor可以重試和多次呼叫Chain.proceed()。

Network Interceptors

• 可以操作由重定向、重試請求等造成的中間response產物。
• 如果是從快取中獲取cached responses ，導致中斷了network，是不會呼叫這個interceptor的。
• 資料在整個network過程中都可以通過Network Interceptors監聽。
• 可以獲取攜帶了request的Connection。

使用Interceptor的說明

在OkHttp 2.2版本才加入了Interceptor功能，而且，Interceptor不能使用OkUrlFactory，或者是基於OkHttp的低版本第三方庫，比如Retrofit ≤ 1.8 and Picasso ≤ 2.4 。