Android--第三方控件--okHttp

　　Android中有很多的第三方控件，其中OkHttp是一個很強大的用於網絡加載的第三方框架，當然了，它的內部也是使用原生的代碼封裝好的。今天我們就來看一下OkHttp的簡單用法：

　　說到網絡請求，肯定就分get和post兩種了，這里我們說一下get和post的簡單實用：

　　首先我們需要先在我們的項目中引入OkHttp的依賴，在你的項目的gradle下面的dependencies下添加依賴：

　

compile 'com.squareup.okhttp3:okhttp:3.4.1'

　　然后同步項目，會自動下載OkHttp相關的依賴。或者也可以這樣，選中此工作空間的設置：

----》選中你要添加依賴（要使用OkHttp）的項目，選擇添加類庫依賴

在搜索框中輸入你想要下載的第三方框架，點搜索哪個按鈕，選中想要下載的，點擊OK，完成。

 

1. Get方式：我們先看一段代碼：

   private void httpget() {
           //okhttpclient :okthttp主要類
           OkHttpClient   client=new OkHttpClient();
           /*
           Request:請求服務端
           Request.Builder():設計模式:將一個復雜的對象的構建與他的表示分離,使得同樣的構建過程可以創建不同的表示，他的每一個屬性的設置都返回一個builder對象，也就是說可以一直使用.XX的形式為其設置屬性
           build:結束,返回Request對象
            */
           Request request=new Request.Builder().url(path).build();
           //Call 將你的請求封裝成任務
           Call call=client.newCall(request);
           //請求調度
           call.enqueue(new Callback() {
               //失敗
               @Override
               public void onFailure(Call call, IOException e) {
   
               }
               //成功
               @Override
               public void onResponse(Call call, Response response) throws IOException {
                   //返回String
                   String json=response.body().string();
                   Log.i("TAG","----->get"+json);
                   //返回byte[]
                               response.body().bytes();
                   //返回流
                               response.body().byteStream();
               }
           });
       }

   　　如上所示，我們要使用OkHttp的時候，首先要先new一個OkHttpClient對象，OkHttpClient是其一個主要的類，Response對象用來構建我們需要額外傳遞的值(如head，method等)和一些其他需要設置的參數，而Call對象是用來封裝任務並執行調度的。我們調用call.enqueue()方法，將call加入調度隊列，在enqueue()方法中我們通過匿名內部類的形式實現這個CallBack接口，並實現其中的兩個方法，onFailure()方法是請求網絡失敗的時候會執行的方法，onResponse()是請求成功的時候會執行的方法。我們主要看onResponse()方法，可以看到，我們在onResponse()方法中通過回傳的Response對象得到我們想要的網絡請求的數據。通過response.body()方法我們能得到ResponseBody對象，在這個對象中我們可以通過方法獲得到字符串、字節數組和輸入流。也就是說這個地方是支持大文件下載的。不過也說明了onResponse()方法不是在主線程中執行的，同樣的，onFailure()方法也是在子線程中執行，只要我們調用了enqueue()，OkHttp會為我們開啟一個子線程。我們可以通過使用handler來實現UI更新。當然，我們也可以像這樣通過call.excute()方法直接返回一個Response()對象：

   OkHttpClient client = new OkHttpClient();
           Request request = new Request.Builder().url(path).build();
           try {
               Response res = client.newCall(request).execute();
               Log.d("tag", "onResponse: "+res.body().string());
           } catch (IOException e) {
               e.printStackTrace();
           }

2. Post方式：

   private void httppost() {
           //okhttpclient :okthttp主要類
           OkHttpClient client=new OkHttpClient();
           /*
           RequestBody:請求體,攜帶參數去服務端訪問
           FormBody:設置表單參數,用它來設置要攜帶的參數
           FormBody.Builder():設計模式:將一個復雜的對象的構建與他的表示分離,使得同樣的構建過程可以創建不同的表示
           build:結束,返回一個RequestBody
            */
           RequestBody body=new FormBody.Builder().add("name","xiaoming").add("age","18").build();
           //創建Request
           Request request=new Request.Builder().url(path).post(body).build();
           //Call 將你的請求封裝成任務
           Call call=client.newCall(request);
           //請求調度
           call.enqueue(new Callback() {
               //失敗
               @Override
               public void onFailure(Call call, IOException e) {
   
               }
               //成功
               @Override
               public void onResponse(Call call, Response response) throws IOException {
                      String  json= response.body().string();
                   Log.i("TAG","----->post"+json);
   
                   response.body().byteStream();
                          response.body().bytes();
               }
           });
       }

   get方式請求如果熟悉了，post其實與它一樣，只是在構建的時候需要多傳遞幾個參數而已。可以看到，我們在上面構建Request對象的時候先構建了一個RequestBody對象，有代碼可見，RequestBody對象也是一個Builder設計模式，設置完參數后不要忘了調用其build()方法完成構建。在封裝Request對象的時候有點不同：

    Request request=new Request.Builder().url(path).post(body).build();

   　　可以看到我們在設置了其url屬性后又調用了post，並將剛才構建的RequestBody()對象傳遞進去。這說明我們使用的post方式。下面的請求調度方法與get相同，不再贅述。

　　可以看到，網絡訪問的代碼還是不少的，如果每次網絡訪問我們都要寫這么多的代碼的話，那可毀了，所以我們下面去封裝一個工具類，這里以get方式為例：

package ggcomic.rabbit.lx.ggcomic.utils;

import java.io.IOException;

import okhttp3.Call;
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;

/**
 * OkHttp網絡加載(單例模式)
 * Created by Lx on 2016/9/12.
 */
public class OkHttpUtils {
    public OkHttpUtils() {
    }

    public static OkHttpUtils okHttpUtils = new OkHttpUtils();

    public static OkHttpUtils getInstance() {
        return okHttpUtils;
    }

    OkHttpClient client = new OkHttpClient();

    /**
     * 官方
     * 直接得到string字符串
     * @param path
     * @return
     * @throws IOException
     */
    public String run(String path) throws IOException {
        Request request = new Request.Builder().url(path).build();
        //官方封裝的方法，沒有請求調度，在使用該工具類的時候要啟動一個線程，
        // 使用client.newCall(request).enqueue(new CallBack(){...})的時候不需要啟動線程
        Response response = client.newCall(request).execute();
        return response.body().string();
    }

    /**
     * 非官方
     * 獲得call實例
     * @param path
     * @return
     */
    public Call getCallInstance(String path) {
        Request request = new Request.Builder().url(path).build();
        Call call = client.newCall(request);
        return call;
    }

}

這里我們使用了單例模式的餓漢式寫法。這里工具類的寫法有兩種，一種是官方的，一種是非官方的，看代碼可以知道，官方封裝的方法無法處理請求失敗時的操作，因為它直接返回給我們一個Response對象，而非官方的是我自己的寫法，這里返回一個Call對象，我們在代碼中使用非官方的寫法：

OkHttpUtils.getInstance().getCallInstance(String url).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                handler.post(new Runnable() {
                    @Override
                    public void run() {
                        //網絡連接失敗時的操作
                    }
                });
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                //網絡連接成功時的操作
            }
        });

我們先是調用getInstance()方法得到一個OkHttp實例，然后再調用其中的方法，在里面完成相應的操作即可。

到這里OkHttp的簡單的使用就結束了，其實算算沒有多少代碼，還是比較簡單的對吧~如果想要深入的了解OkHttp，請移文鴻洋大神的這篇博客：

Android OkHttp完全解析 是時候來了解OkHttp了

寫的特別的全面。