爲何okhttpclient不能builder

1、概述
　　最近在羣裏聽到各類討論okhttp的話題，可見okhttp的口碑至關好了。再加上Google貌似在6.0版本里面刪除了HttpClient相關API，對於這個行爲不作評價。爲了更好的在應對網絡訪問，學習下okhttp仍是蠻必要的，本篇博客首先介紹okhttp的簡單使用，主要包含：
　　通常的get請求
　　通常的post請求
　　基於Http的文件上傳
　　文件下載
　　加載圖片
　　支持請求回調，直接返回對象、對象集合
　　支持session的保持
　　最後會對上述幾個功能進行封裝，完整的封裝類的地址見：https://github.com/hongyangAndroid/okhttp-utils
　　使用前，對於Android Studio的用戶，能夠選擇添加:
　　compile 'com.squareup.okhttp:okhttp:2.4.0'1

　　或者Eclipse的用戶，能夠下載最新的jar okhttp he latest JAR ，添加依賴就能夠用了。
　　注意:okhttp內部依賴okio，別忘了同時導入okio：
　　gradle: compile 'com.squareup.okio:okio:1.5.0'
　　最新的jar地址：okio the latest JAR
　　2、使用教程
　　（一）Http Get
　　對了網絡加載庫，那麼最多見的確定就是http get請求了，好比獲取一個網頁的內容。
　　//建立okHttpClient對象
OkHttpClient mOkHttpClient = new OkHttpClient();
//建立一個Request
final Request request = new Request.Builder()
                .url("https://github.com/hongyangAndroid")
                .build();
//new call
Call call = mOkHttpClient.newCall(request); 
//請求加入調度
call.enqueue(new Callback()
        {
            @Override
            public void onFailure(Request request, IOException e)
            {
            }

            @Override
            public void onResponse(final Response response) throws IOException
            {
                    //String htmlStr =  response.body().string();
            }
        });             

123456789101112131415161718192021222324

　　以上就是發送一個get請求的步驟，首先構造一個Request對象，參數最起碼有個url，固然你能夠經過Request.Builder設置更多的參數好比：header、method等。
　　而後經過request的對象去構造獲得一個Call對象，相似於將你的請求封裝成了任務，既然是任務，就會有execute()和cancel()等方法。
　　最後，咱們但願以異步的方式去執行請求，因此咱們調用的是call.enqueue，將call加入調度隊列，而後等待任務執行完成，咱們在Callback中便可獲得結果。
　　看到這，你會發現，總體的寫法仍是比較長的，因此封裝確定是要作的，否則每一個請求這麼寫，得累死。
　　ok，須要注意幾點：
　　onResponse回調的參數是response，通常狀況下，好比咱們但願得到返回的字符串，能夠經過response.body().string()獲取；若是但願得到返回的二進制字節數組，則調用response.body().bytes()；若是你想拿到返回的inputStream，則調用response.body().byteStream()
　　看到這，你可能會奇怪，居然還能拿到返回的inputStream，看到這個最起碼能意識到一點，這裏支持大文件下載，有inputStream咱們就能夠經過IO的方式寫文件。不過也說明一個問題，這個onResponse執行的線程並非UI線程。的確是的，若是你但願操做控件，仍是須要使用handler等，例如：
　　@Override
public void onResponse(final Response response) throws IOException
{
      final String res = response.body().string();
      runOnUiThread(new Runnable()
      {
          @Override
          public void run()
          {
            mTv.setText(res);
          }

      });
}

　　1
　　2
　　3
　　4
　　5
　　6
　　7
　　8
　　9
　　10
　　11
　　12
　　13
　　14
　　咱們這裏是異步的方式去執行，固然也支持阻塞的方式，上面咱們也說了Call有一個execute()方法，你也能夠直接調用call.execute()經過返回一個Response。
　　(二) Http Post 攜帶參數
　　看來上面的簡單的get請求，基本上整個的用法也就掌握了，好比post攜帶參數，也僅僅是Request的構造的不一樣。
　　Request request = buildMultipartFormRequest(
        url, new File[]{file}, new String[]{fileKey}, null);
FormEncodingBuilder builder = new FormEncodingBuilder();   
builder.add("username","張鴻洋");

Request request = new Request.Builder()
                   .url(url)
                .post(builder.build())
                .build();
 mOkHttpClient.newCall(request).enqueue(new Callback(){});12345678910

　　你們都清楚，post的時候，參數是包含在請求體中的；因此咱們經過FormEncodingBuilder。添加多個String鍵值對，而後去構造RequestBody，最後完成咱們Request的構造。
　　後面的就和上面同樣了。
　　（三）基於Http的文件上傳
　　接下來咱們在介紹一個能夠構造RequestBody的Builder，叫作MultipartBuilder。當咱們須要作相似於表單上傳的時候，就可使用它來構造咱們的requestBody。
　　File file = new File(Environment.getExternalStorageDirectory(), "balabala.mp4");

RequestBody fileBody = RequestBody.create(MediaType.parse("application/octet-stream"), file);

RequestBody requestBody = new MultipartBuilder()
     .type(MultipartBuilder.FORM)
     .addPart(Headers.of(
          "Content-Disposition", 
              "form-data; name=\"username\""), 
          RequestBody.create(null, "張鴻洋"))
     .addPart(Headers.of(
         "Content-Disposition", 
         "form-data; name=\"mFile\"; 
         filename=\"wjd.mp4\""), fileBody)
     .build();

Request request = new Request.Builder()
    .url("http://192.168.1.103:8080/okHttpServer/fileUpload")
    .post(requestBody)
    .build();

Call call = mOkHttpClient.newCall(request);
call.enqueue(new Callback()
{
    //...
});1234567891011121314151617181920212223242526

　　上述代碼向服務器傳遞了一個鍵值對username:張鴻洋和一個文件。咱們經過MultipartBuilder的addPart方法能夠添加鍵值對或者文件。
　　其實相似於咱們拼接模擬瀏覽器行爲的方式，若是你對這塊不瞭解，能夠參考：從原理角度解析Android （Java） http 文件上傳
　　ok，對於咱們最開始的目錄還剩下圖片下載，文件下載；這兩個一個是經過回調的Response拿到byte[]而後decode成圖片；文件下載，就是拿到inputStream作寫文件操做，咱們這裏就不贅述了。
　　關於用法，也能夠參考泡網OkHttp使用教程
　　接下來咱們主要看如何封裝上述的代碼。
　　3、封裝
　　因爲按照上述的代碼，寫多個請求確定包含大量的重複代碼，因此我但願封裝後的代碼調用是這樣的