compile 'com.squareup.okhttp3:okhttp:3.5.0'
compile 'com.squareup.okio:okio:1.11.0'

<uses-permission android:name="android.permission.INTERNET"/>

        // step 1: 創(chuàng)建 OkHttpClient 對(duì)象    
        OkHttpClient okHttpClient = new OkHttpClient();

        // step 2： 創(chuàng)建一個(gè)請(qǐng)求顶滩，不指定請(qǐng)求方法時(shí)默認(rèn)是GET礁鲁。
        Request.Builder requestBuilder = new Request.Builder().url("http://www.baidu.com");
        //可以省略，默認(rèn)是GET請(qǐng)求
        requestBuilder.method("GET",null);

        // step 3：創(chuàng)建 Call 對(duì)象
        Call call = okHttpClient.newCall(requestBuilder.build());

        //step 4: 開始異步請(qǐng)求
        call.enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                // TODO: 17-1-4  請(qǐng)求失敗
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                // TODO: 17-1-4 請(qǐng)求成功
                //獲得返回體
                ResponseBody body = response.body();
            }
        });

接下來我們就要將OkHttpClick的對(duì)象與Request的對(duì)象建立起來聯(lián)系愉棱，使用okHttpClick的newCall()方法得到一個(gè)Call對(duì)象奔滑，這個(gè)Call對(duì)象的作用就是相當(dāng)于將請(qǐng)求封裝成了一個(gè)任務(wù)朋其，既然是任務(wù)梅猿，自然就會(huì)有execute()和cancel()等方法袱蚓。

最后喇潘，我們希望以異步的方式去執(zhí)行請(qǐng)求颖低，所以我們調(diào)用的是call.enqueue枫甲，將call加入調(diào)度隊(duì)列想幻，然后等待任務(wù)執(zhí)行完成脏毯，我們?cè)贑allback中即可得到結(jié)果食店。但要注意的是,call的回調(diào)是子線程吉嫩，所以是不能直接操作界面的嗅定。使用時(shí)需要自行處理忙迁。當(dāng)請(qǐng)求成功時(shí)就會(huì)回調(diào)onResponse()方法碎乃，我們可以看到返回的結(jié)果是 Response對(duì)象，在此我們比較關(guān)注的是請(qǐng)求中的返回體body（ResponseBody類型）恰梢，大多數(shù)的情況下我們希望獲得字符串從而進(jìn)行json解析獲得數(shù)據(jù)删豺，所以可以通過body.string()的方式獲得字符串呀页。

查看ResponseBody的API文檔可以看到，body還可以獲取byte[]丸氛、Reader缓窜、InputStream禾锤，其中最驚奇一點(diǎn)就是可以返回InputStream恩掷，這至少說明了OkHttp是可以支持大文件的下載的黄娘，這樣一來我們就可以輕松的使用InputStream進(jìn)行I/O方式的文件寫入啦１普５ǔā竿秆！幽钢。

讓我們實(shí)現(xiàn)一下吧：

        //step 1: 不變的第一步創(chuàng)建 OkHttpClick
        OkHttpClient okHttpClient = new OkHttpClient();

        //step 2: 創(chuàng)建Requset
        Request request = new Request.Builder()
                .url("http://www.ssyer.com/uploads/org_2017010593503_775.jpg")
                .build();
        
        //step 3:建立聯(lián)系匪燕，創(chuàng)建Call
        mOkHttpClient.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
            }

            @Override
            public void onResponse(Call call, Response response) {
                InputStream inputStream = response.body().byteStream();
                FileOutputStream fileOutputStream = null;
                try {
                    File file = new File(Environment.getExternalStorageDirectory() + "大獅子.jpg");
                    fileOutputStream = new FileOutputStream(file);
                    byte[] buffer = new byte[2048];
                    int len = 0;
                    while ((len = inputStream.read(buffer)) != -1) {
                        fileOutputStream.write(buffer, 0, len);
                    }
                    fileOutputStream.flush();
                } catch (IOException e) {
                    e.printStackTrace();
                }

                Log.d("downloadAsynFile", "文件下載成功");
            }
        });

3.1.1 同步的Get

當(dāng)然Get也支持阻塞方式的同步請(qǐng)求，不過在開發(fā)中這種方法很少被使用书闸。上面我們也說了Call有一個(gè)execute()方法嫌术，你也可以直接調(diào)用call.execute()返回一個(gè)Response度气。然后利用isSuccessful()判讀是否成功,進(jìn)行相應(yīng)的結(jié)果解析磷籍。

3.2 異步的Http Post

在看過了Get請(qǐng)求方式弛矛，相信你對(duì)于請(qǐng)求的用法也用基本的掌握了汪诉，Post的使用使用方法和Get雖然存在些許差異，但是本質(zhì)是不變的拟烫。那么下面就讓我們以攜帶鍵值對(duì)的Post為例硕淑，先熟悉一下Post的使用方法吧置媳。

3.2.1 Post 上傳鍵值對(duì)

        //step 1: 同樣的需要?jiǎng)?chuàng)建一個(gè)OkHttpClick對(duì)象
        OkHttpClient okHttpClient = new OkHttpClient();

        //step 2: 創(chuàng)建  FormBody.Builder
        FormBody formBody = new FormBody.Builder()
                .add("name", "dsd")
                .build();

        //step 3: 創(chuàng)建請(qǐng)求
        Request request = new Request.Builder().url("http://www.baidu.com")
                .post(formBody)
                .build();

        //step 4： 建立聯(lián)系 創(chuàng)建Call對(duì)象
        okHttpClient.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                // TODO: 17-1-4  請(qǐng)求失敗
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                // TODO: 17-1-4 請(qǐng)求成功
            }
        });

是不是和Get很相似啊。大家都清楚公条，在使用Post的時(shí)候拇囊，參數(shù)是包含在請(qǐng)求體中的。所以我們通過FormBody靶橱，添加多個(gè)String鍵值對(duì)寥袭，然后為Request添加post(formBody)完成我們Request的構(gòu)造。之后的步驟就和Get的步驟一樣了关霸，是不是很簡(jiǎn)單按啤！

3.2.2 Post異步上傳文件

直接上代碼

       // step 1: 創(chuàng)建 OkHttpClient 對(duì)象
        OkHttpClient okHttpClient = new OkHttpClient();

        //step 2:創(chuàng)建 RequestBody 以及所需的參數(shù)
        //2.1 獲取文件
        File file = new File(Environment.getExternalStorageDirectory() + "test.txt");
        //2.2 創(chuàng)建 MediaType 設(shè)置上傳文件類型
        MediaType MEDIATYPE = MediaType.parse("text/plain; charset=utf-8");
        //2.3 獲取請(qǐng)求體
        RequestBody requestBody = RequestBody.create(MEDIATYPE, file);

        //step 3：創(chuàng)建請(qǐng)求
        Request request = new Request.Builder().url("http://www.baidu.com")
                .post(requestBody)
                .build();

        //step 4 建立聯(lián)系
        okHttpClient.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                // TODO: 17-1-4  請(qǐng)求失敗
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                // TODO: 17-1-4 請(qǐng)求成功
            }
        });

當(dāng)然這里需要添加權(quán)限滴队寇，你是不是忘記了呢识埋。

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/> 
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> 

第一步與之前都相同相恃，但是從第二步開始就用了一定的差異了。在step2 中我們需要通過MediaType.parse("text/plain; charset=utf-8")為上傳文件設(shè)置一定類型（MIME）在這里我們上傳的純文本文件所以選擇"text/plain類型，而編碼格式為utf-8。下面為大家列出常見的文件類型，方便使用。

參數(shù)	說明
text/html	HTML格式
text/plain	純文本格式
text/xml	XML格式
image/gif	gif圖片格式
image/jpeg	jpg圖片格式
image/png	png圖片格式
application/xhtml+xml	XHTML格式
application/xml	XML數(shù)據(jù)格式
application/atom+xml	Atom XML聚合格式
application/json	JSON數(shù)據(jù)格式
application/pdf	pdf格式
application/msword	Word文檔格式
application/octet-stream	二進(jìn)制流數(shù)據(jù)

其實(shí)MIME文件類型特批多坚俗，有興趣的朋友可以可參見w3school上的MIME 參考手冊(cè)。

在創(chuàng)建RequestBody的時(shí)候可以看到破停，我們不僅僅可以上傳File文件黑界，還可以上傳String，ByteString，byte數(shù)組等類型，其中上傳byte數(shù)據(jù)時(shí)可以選擇三個(gè)參數(shù)的creta方法浦辨，需要指定偏移量和需要寫入的byte長(zhǎng)度，哈哈這不是說明可以直接進(jìn)行多線程、斷點(diǎn)上傳嗎艰躺！通過這些類型页响，我們可以上傳Json串涩哟，圖片等內(nèi)容真是方便又好用啊锻弓。

總結(jié)

經(jīng)過上面的介紹我相信大家對(duì)OkHttp簡(jiǎn)單使用有了一定的了解杂拨，OkHttp3使用起來是不是很簡(jiǎn)單呢炸渡，但是每一次請(qǐng)求的步驟都有著大量重復(fù)的地方，這要是在實(shí)際開發(fā)中藕夫，還不把人累著啊，本著節(jié)約開（tou）發(fā)周（lan）期的目的，咳咳沽瘦，后面的文章會(huì)進(jìn)一步的帶領(lǐng)大家學(xué)習(xí)OkHttp3的高級(jí)用法和OkHttp工具類的封裝哦并村，敬請(qǐng)期待。

參考：

1. https://github.com/square/okhttp
2. Android OkHttp完全解析 是時(shí)候來了解OkHttp了