之前已經講過了Retrofit2.0的初步認識，不是很清楚的同學可以參看我的文章連結：
Retrofit2.0初識：http://blog.csdn.net/burn_yourself/article/details/71799253


一般的，我們在寫網路通訊的時候，log除錯是必須的，那麼本篇文章就來講講 Retrofit2.0 和 它的 攔截器們，主要包括以下幾方面：
1. Header  攔截器
2. Cache 攔截器
3.log 攔截器


那麼，下面就一一講述新增。
首先，還是需要新增網路許可權，由於快取攔截器，涉及到網路狀態，於是還要多新增一個網路狀態許可權，本篇涉及到的許可權有：
    <uses-permission android:name="android.permission.INTERNET" />
    <!-- 獲取運營商資訊，用於支援提供運營商資訊相關的介面 -->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />


app 的 gradle 中新增包的引用：
    compile 'com.squareup.retrofit2:retrofit:2.2.0'
    compile 'com.squareup.retrofit2:converter-gson:2.2.0'
注意，由於retrofit2.0 本身就是對okhttp3的一個封裝，所以不必再新增對於okhttp3.X  的引用


由於Retrofit2.0中並沒有對於攔截器的處理，於是還是得在 OKhttp 中去處理攔截的問題，然後將 okhttp 物件 add 到 Retrofit 初始化的程式碼中。
大概思路如此，首先貼出 Retrofit2.0 通訊大致流程，還是以 retrofit2.0 中 獲取簡訊驗證碼為例：


1.宣告api：
public interface ApiService<T>{


    //註冊時獲取簡訊驗證碼
    @POST("api/login/pushSms")
    @FormUrlEncoded
    Call<ApiResponse<SmsCode>> postSms(@FieldMap Map<String, String> map);
｝


2.寫Retrofit物件，並配置網路：
package com.test.http.retrofit;


import com.test.http.interceptor.CacheInterceptor;
import com.test.http.interceptor.HeaderInterceptor;
import com.test.util.LogUtil;


import java.io.File;
import java.util.concurrent.TimeUnit;


import okhttp3.Cache;
import okhttp3.OkHttpClient;
import okhttp3.logging.HttpLoggingInterceptor;
import retrofit2.Retrofit;
import retrofit2.converter.gson.GsonConverterFactory;


/**
 * Created by Admin on 2017/5/12.
 */


public class HttpClient{


    public ApiService mApiService;


    private HttpClient() {
        Cache cache = new Cache(new File(BuildConfig.PATH_CACHE), BuildConfig.DEFAULT_CACHE_SIZE);


        OkHttpClient.Builder builder = new OkHttpClient.Builder()
                .addInterceptor(new HeaderInterceptor())//設定Header
                .addNetworkInterceptor(new CacheInterceptor())//設定快取
                .addInterceptor(new CacheInterceptor())
                .cache(cache)
                .connectTimeout(BuildConfig.DEFAULT_CONNECT_TIMEOUT, TimeUnit.SECONDS)//設定連線超時時間
                .readTimeout(BuildConfig.DEFAULT_READ_TIMEOUT, TimeUnit.SECONDS)//設定讀取超時時間
                .writeTimeout(BuildConfig.DEFAULT_WRITE_TIMEOUT, TimeUnit.SECONDS)//設定寫的超時時間
                .retryOnConnectionFailure(true);//錯誤重連
           //除錯模式列印Log日誌
            if (BuildConfig.DEBUG) {
                builder.addInterceptor(new LoggingInterceptor());
            }


        OkHttpClient client=builder.build();
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(BuildConfig.BASE_URL)
                .client(client)
                .addConverterFactory(GsonConverterFactory.create())
//                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .build();
        mApiService = retrofit.create(ApiService.class);
    }


    private static class HttpClientHolder {
        private static final HttpClient INSTANCE = new HttpClient();
    }


    public static HttpClient getInstance() {
        return HttpClientHolder.INSTANCE;
    }


    public ApiService getApiService() {
        return mApiService;
    }


}


activity中呼叫與接收：
 private void send(Map<String,String>map){
        HttpClient.getInstance().getApiService().postSms(map).enqueue(new Callback<ApiResponse<SmsCode>>() {
            @Override
            public void onResponse(Call<ApiResponse<SmsCode>>call, Response<ApiResponse<SmsCode>>response) {
                int code=response.code();
                ApiResponse apiResponse=response.body();
                SmsCode sms= (SmsCode) apiResponse.getData();


                Log.e(TAG, "sms: "+sms.getStatus());
            }


            @Override
            public void onFailure(Call call, Throwable t) {


                Log.e(TAG, "t"+t.getMessage());
            }
        });
    }


大家細心的話會發現 類 HttpClient 中已經新增得有 攔截器了，HeaderInterceptor，CacheInterceptor,LoggingInterceptor.


攔截器都要實現 Interceptor 介面，首先看 HeaderInterceptor 是怎麼實現的
/**
 * Created by Admin on 2017/5/13.
 * header攔截器，對Header統一處理，涉及到header加密的也在此處理
 */
public class HeaderInterceptor implements Interceptor{
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        //處理業務邏輯，可以對header統一處理，涉及到header加密的也在此處理
        //......
        
        request = builder.build();
        return chain.proceed(request);
    }
}


然後介紹的是 CacheInterceptor ：
package com.test.http.interceptor;


import com.test.http.retrofit.BuildConfig;
import com.test.util.NetUtil;


import java.io.IOException;


import okhttp3.CacheControl;
import okhttp3.Interceptor;
import okhttp3.Request;
import okhttp3.Response;


/**
 * Created by Administrator on 2016/11/3.
 * 快取攔截器
 */


public class CacheInterceptor implements Interceptor {
    @Override
    public Response intercept(Chain chain) throws IOException {
        Request request = chain.request();
        if (!NetUtil.isNetworkConnected()) {//沒網強制從快取讀取(必須得寫，不然斷網狀態下，退出應用，或者等待一分鐘後，就獲取不到快取）
            request = request.newBuilder()
                    .cacheControl(CacheControl.FORCE_CACHE)
                    .build();
        }
        Response response = chain.proceed(request);
        if (NetUtil.isNetworkConnected()) {//有網情況下，從伺服器獲取
            int maxAge = BuildConfig.DEFAULT_COOKIE_NETWORK_TIME;
            // 有網路時, 快取最大儲存時長為60s
            response.newBuilder()
                    .header("Cache-Control", "public, max-age=" + maxAge)
                    .removeHeader("Pragma")
                    .build();
        } else {//沒網情況下，一律從快取獲取
            // 無網路時，設定超時為30天
            int maxStale = BuildConfig.DEFAULT_COOKIE_NO_NETWORK_TIME;
            response.newBuilder()
                    .header("Cache-Control", "public, only-if-cached, max-stale=" + maxStale)
                    .removeHeader("Pragma")
                    .build();
        }
        return response;
    }
}


最後介紹我們的 LoggingInterceptor，其實個人認為 LoggingInterceptor 還是比較重要的，Retrofit2.0 中log攔截器的實現有兩種方式，一種是自定義，另一種是呼叫 okhpp中自帶的 log攔截器，
那麼，先介紹 LoggingInterceptor 的實現：
/**
 * Created by Admin on 2017/5/13.
 * 自定義log列印攔截器
 */


public class LoggingInterceptor implements Interceptor{


    @Override
    public Response intercept(Chain chain) throws IOException {
        //這個chain裡面包含了request和response，所以你要什麼都可以從這裡拿
        //=========傳送===========
        Request request = chain.request();
        long requestTime = System.currentTimeMillis();//請求發起的時間
        HttpUrl requestUrl=request.url();
        Connection requestConnection=chain.connection();
        Headers requestHeaders=request.headers();
        //打印發送資訊
        LogUtil.e("===LoggingInterceptor===傳送==requestUrl="+requestUrl);
        LogUtil.e("===LoggingInterceptor===傳送==requestConnection="+requestConnection);
        LogUtil.e("===LoggingInterceptor===傳送==requestHeaders="+requestHeaders);


        //=========接收===========
        long responseTime = System.currentTimeMillis();//收到響應的時間
        Response response = chain.proceed(chain.request());
        ResponseBody responseBody = response.peekBody(1024 * 1024);
        HttpUrl responseUrl=response.request().url();
        String content = response.body().string();
        Headers responseHeaders=response.headers();
        long delayTime=responseTime-requestTime;
        //列印接收資訊
        LogUtil.e("=====LoggingInterceptor===接收==responseUrl="+responseUrl);
        LogUtil.e("=====LoggingInterceptor===接收==responseHeaders="+responseHeaders);
        LogUtil.e("=====LoggingInterceptor===接收==delayTime="+delayTime);
        LogUtil.e("=====LoggingInterceptor===接收==content="+content);


        return response;
    }
}
這裡最需要注意的是 方法中 對 request 和 response 的獲取和處理


自定義 Log除錯類在 HttpClient 中的呼叫順序是 ，先對 okhttp。builder 做些其它基本配置，然後
  除錯模式列印Log日誌
        if (BuildConfig.DEBUG) {
           builder.addInterceptor(new LoggingInterceptor());
        }


最後，在retrofit中加入 okhttp物件
        OkHttpClient client=builder.build();
        Retrofit retrofit = new Retrofit.Builder()
                .baseUrl(BuildConfig.BASE_URL)
                .client(client)
                .addConverterFactory(GsonConverterFactory.create())
//                .addCallAdapterFactory(RxJavaCallAdapterFactory.create())
                .build();
        mApiService = retrofit.create(ApiService.class);


OKHttp 呼叫系統 Log列印的話，需要在 app。gradle 中新增引用：
compile 'com.squareup.okhttp3:logging-interceptor:3.4.1'


然後在程式碼中這樣寫：
        //呼叫系統log攔截器
        if (BuildConfig.DEBUG) {
            HttpLoggingInterceptor logging = new HttpLoggingInterceptor(
                    new HttpLoggingInterceptor.Logger() {
                        @Override
                       public void log(String message) {
                            LogUtil.e("=======message=="+message);
                        }
                    });
            logging.setLevel(HttpLoggingInterceptor.Level.BODY);
            builder.addInterceptor(logging);
        }


message中會打印出 通訊中各種詳細資訊。


最後，貼出 網路配置檔案程式碼：
/**
 * Created by Admin on 2017/5/12.
 * 網路通訊相關配置
 */


public class BuildConfig {


    public static boolean DEBUG=true;


    /**正試**/
    private final static String RELEASE_URL = "";
    /**測試**/
    private static final String DEBUG_URL = "http://192.168.0.10/";


    public final static String BASE_URL = BuildConfig.DEBUG ? DEBUG_URL : RELEASE_URL;


    public static final int DEFAULT_CACHE_SIZE = 150 * 1024 * 1024; // 50 MiB
    /*超時時間-預設10秒*/
    public static final int DEFAULT_CONNECT_TIMEOUT = 20;
    public static final int DEFAULT_READ_TIMEOUT = 20;
    public static final int DEFAULT_WRITE_TIMEOUT = 20;
    /*有網情況下的本地快取時間預設60秒*/
    public static final int DEFAULT_COOKIE_NETWORK_TIME = 0;
    /*無網路的情況下本地快取時間預設30天*/
    public static final int DEFAULT_COOKIE_NO_NETWORK_TIME = 24 * 60 * 60 * 30;


    public static final String PATH_DATA = MyApplication.getInstance().getCacheDir().getAbsolutePath() + File.separator + "data";
    public static final String PATH_CACHE = PATH_DATA + "/NetCache";


}


OK，今天關於 Retrofit2.0 攔截器就講到這裡，睡覺去了。大家有什麼疑問，或者我理解得有誤的地方，歡迎交流