Android 網絡請求詳解

我們知道大多數的 Android 應用程序都是通過和服務器進行交互來獲取數據的。如果使用 HTTP 協議來發送和接收網絡數據，就免不了使用 HttpURLConnection 和 HttpClient，而 Android 中主要提供了上述兩種方式來進行 HTTP 操作。並且這兩種方式都支持 HTTPS 協議、以流的形式進行上傳和下載、配置超時時間、IPv6、以及連接池等功能。

但是 Googl e發布 6.0 版本的時候聲明原生剔除 HttpClient，但是筆者認為 HttpClient 會提供相應的 jar 包做支持，畢竟 Google 對向下兼容這方面一直都做的很好，相信在選擇網絡功能的時候我們會選自己喜歡的方法。

HttpURLConnection

接著我們來看一下如何使用 HttpURLConnection 來處理簡單的網絡請求。

// Get方式請求  
public static void requestByGet() throws Exception {  
    String path = "10.128.7.34:3000/name=helloworld&password=android";  
    // 新建一個URL對象  
    URL url = new URL(path);  
    // 打開一個HttpURLConnection連接  
    HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();  
    // 設置連接超時時間  
    urlConn.setConnectTimeout(6 * 1000);  
    // 開始連接  
    urlConn.connect();  
    // 判斷請求是否成功  
    if (urlConn.getResponseCode() == HTTP_200) {  
        // 獲取返回的數據  
        byte[] data = readStream(urlConn.getInputStream());  
        Log.i(TAG_GET, new String(data, "UTF-8"));  
    } else {  
        Log.i(TAG_GET, "Get方式請求失敗");  
    }  
    // 關閉連接  
    urlConn.disconnect();  
}

// Post方式請求  
public static void requestByPost() throws Throwable {  
    String path = "http://10.128.7.34:3000/login";  
    // 請求的參數轉換為byte數組  
    String params = "name+ URLEncoder.encode("helloworld", "UTF-8")  
            + "&password=" + URLEncoder.encode("android", "UTF-8");  
    byte[] postData = params.getBytes();  
    // 新建一個URL對象  
    URL url = new URL(path);  
    // 打開一個HttpURLConnection連接  
    HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();  
    // 設置連接超時時間  
    urlConn.setConnectTimeout(5 * 1000);  
    // Post請求必須設置允許輸出  
    urlConn.setDoOutput(true);  
    // Post請求不能使用緩存  
    urlConn.setUseCaches(false);  
    // 設置為Post請求  
    urlConn.setRequestMethod("POST");  
    urlConn.setInstanceFollowRedirects(true);  
    // 配置請求Content-Type  
    urlConn.setRequestProperty("Content-Type",  
            "application/x-www-form-urlencode");  
    // 開始連接  
    urlConn.connect();  
    // 發送請求參數  
    DataOutputStream dos = new DataOutputStream(urlConn.getOutputStream());  
    dos.write(postData);  
    dos.flush();  
    dos.close();  
    // 判斷請求是否成功  
    if (urlConn.getResponseCode() == HTTP_200) {  
        // 獲取返回的數據  
        byte[] data = readStream(urlConn.getInputStream());  
        Log.i(TAG_POST, new String(data, "UTF-8"));  
    } else {  
        Log.i(TAG_POST, "Post方式請求失敗");  
    }  
}

關於HttpURLConnection的相關開源工程

由於 Google 已經表明了推薦廣大開發者使用 HttpURLConnection，那麼想必是有一定原因的。

xUtils3

這裡就推薦大伙都很熟悉的開源項目 xUtils 的“弟弟“，xUtils3。xUtils 包含了 view 注入，圖片處理，數據庫操作以及網絡請求封裝，xUtils 使用的網絡請求封裝是基於 HttpClient 的。xUtils3 使用的網絡請求是基於 HttpURLConnection，我們著重說明一下xUtils3。

RequestParams params = new RequestParams("http://10.128.7.34:3000/upload");  
        // 加到url裡的參數, http://xxxx/s?wd=xUtils
        params.addQueryStringParameter("wd", "xUtils");
        // 添加到請求 body 體的參數, 只有 POST, PUT, PATCH, DELETE 請求支持.
        // params.addBodyParameter("wd", "xUtils");

        // 使用 multipart 表單上傳文件
        params.setMultipart(true);
        params.addBodyParameter(
                "file",
                new File("/sdcard/test.jpg"),
                null); // 如果文件沒有擴展名, 最好設置contentType 參數.
        params.addBodyParameter(
                "file2",
                new FileInputStream(new File("/sdcard/test2.jpg")),
                "image/jpeg",
                // 測試中文文件名
                "你+& /" 好.jpg"); // InputStream 參數獲取不到文件名, 最好設置, 除非服務端不關心這個參數.
        x.http().post(params, new Callback.CommonCallback<String>() {
            @Override
            public void onSuccess(String result) {
                Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();
            }

            @Override
            public void onCancelled(CancelledException cex) {
                Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();
            }

            @Override
            public void onFinished() {

            }
        });

具有 cache 功能

RequestParams params = new RequestParams("http://10.128.7.34:3000/upload");  
        params.wd = "xUtils";
        // 默認緩存存活時間, 單位:毫秒.(如果服務沒有返回有效的max-age 或 Expires)
        params.setCacheMaxAge(1000 * 60);
        Callback.Cancelable cancelable
                // 使用 CacheCallback, xUtils 將為該請求緩存數據.
                = x.http().get(params, new Callback.CacheCallback<String>() {

            private boolean hasError = false;
            private String result = null;

            @Override
            public boolean onCache(String result) {
                // 得到緩存數據, 緩存過期後不會進入這個方法.
                // 如果服務端沒有返回過期時間, 參考params.setCacheMaxAge(maxAge)方法.
                //
                // * 客戶端會根據服務端返回的 header 中 max-age 或 expires 來確定本地緩存是否給 onCache 方法.
                //   如果服務端沒有返回 max-age 或 expires, 那麼緩存將一直保存, 除非這裡自己定義了返回false的
                //   邏輯, 那麼xUtils將請求新數據, 來覆蓋它.
                //
                // * 如果信任該緩存返回 true, 將不再請求網絡;
                //   返回 false 繼續請求網絡, 但會在請求頭中加上ETag, Last-Modified等信息,
                //   如果服務端返回 304, 則表示數據沒有更新, 不繼續加載數據.
                //
                this.result = result;
                return false; // true: 信任緩存數據, 不在發起網絡請求; false 不信任緩存數據.
            }

            @Override
            public void onSuccess(String result) {
                // 注意: 如果服務返回 304 或 onCache 選擇了信任緩存, 這裡將不會被調用,
                // 但是 onFinished 總會被調用.
                this.result = result;
            }

            @Override
            public void onError(Throwable ex, boolean isOnCallback) {
                hasError = true;
                Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();
                if (ex instanceof HttpException) { // 網絡錯誤
                    HttpException httpEx = (HttpException) ex;
                    int responseCode = httpEx.getCode();
                    String responseMsg = httpEx.getMessage();
                    String errorResult = httpEx.getResult();
                    // ...
                } else { // 其他錯誤
                    // ...
                }
            }

            @Override
            public void onCancelled(CancelledException cex) {
                Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();
            }

            @Override
            public void onFinished() {
                if (!hasError && result != null) {
                    // 成功獲取數據
                    Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();
                }
            }
        });

post請求直接更改 post 方式，以及需要提交的參數即可，篇幅問題這裡就不在一一列舉了。通過以上代碼可以看到，我們在使用 xUtils 來請求網絡的時候會非常的方便，只用在回調函數裡面做對應的代碼邏輯處理即可，不用關心線程問題，極大的解放了我們的生產力。Android Stuido Gradle使用方法如下：

compile ‘org.xutils:xutils:3.1.+’

Volley

在 Android 2.3 及以上版本，使用的是 HttpURLConnection，而在Android 2.2 及以下版本，使用的是 HttpClient。鑒於現在的手機行業發展速度，我們已經不考慮 Android2.2 了。

簡單提供一些 Volley 的實例：

//簡單的 GET 請求
mQueue = Volley.newRequestQueue(getApplicationContext());  
mQueue.add(new JsonObjectRequest(Method.GET, url, null,  
            new Listener() {  
                @Override  
                public void onResponse(JSONObject response) {  
                    Log.d(TAG, "response : " + response.toString());  
                }  
            }, null));  
mQueue.start();

//對 ImageView 的操作
ImageListener listener = ImageLoader.getImageListener(imageView, android.R.drawable.ic_launcher, android.R.drawable.ic_launcher);  
mImageLoader.get(url, listener);  

//對 ImageView 網絡加載的處理
mImageView.setImageUrl(url, imageLoader);

當然我們也可以定制自己的 request

mRequestQueue.add( new GsonRequest(url, ListResponse.class, null,  
    new Listener() {  
        public void onResponse(ListResponse response) {  
            appendItemsToList(response.item);  
            notifyDataSetChanged();  
        }  
    }  
}

HttpClient

同樣，我們來看一下 HttpClient 的簡單請求。

// HttpGet 方式請求  
public static void requestByHttpGet() throws Exception {  
    String path = "http://10.128.7.34:3000/name=helloworld&password=android";  
    // 新建 HttpGet 對象  
    HttpGet httpGet = new HttpGet(path);  
    // 獲取 HttpClient 對象  
    HttpClient httpClient = new DefaultHttpClient();  
    // 獲取 HttpResponse 實例  
    HttpResponse httpResp = httpClient.execute(httpGet);  
    // 判斷是夠請求成功  
    if (httpResp.getStatusLine().getStatusCode() == HTTP_200) {  
        // 獲取返回的數據  
        String result = EntityUtils.toString(httpResp.getEntity(), "UTF-8");  
        Log.i(TAG_HTTPGET, "HttpGet 方式請求成功，返回數據如下：");  
        Log.i(TAG_HTTPGET, result);  
    } else {  
        Log.i(TAG_HTTPGET, "HttpGet 方式請求失敗");  
    }  
}

// HttpPost 方式請求  
public static void requestByHttpPost() throws Exception {  
    String path = "https://reg.163.com/login";  
    // 新建 HttpPost 對象  
    HttpPost httpPost = new HttpPost(path);  
    // Post 參數  
    List<NameValuePair> params = new ArrayList<NameValuePair>();  
    params.add(new BasicNameValuePair("name", "helloworld"));  
    params.add(new BasicNameValuePair("password", "android"));  
    // 設置字符集  
    HttpEntity entity = new UrlEncodedFormEntity(params, HTTP.UTF_8);  
    // 設置參數實體  
    httpPost.setEntity(entity);  
    // 獲取 HttpClient 對象  
    HttpClient httpClient = new DefaultHttpClient();  
    // 獲取 HttpResponse 實例  
    HttpResponse httpResp = httpClient.execute(httpPost);  
    // 判斷是夠請求成功  
    if (httpResp.getStatusLine().getStatusCode() == HTTP_200) {  
        // 獲取返回的數據  
        String result = EntityUtils.toString(httpResp.getEntity(), "UTF-8");  
        Log.i(TAG_HTTPGET, "HttpPost 方式請求成功，返回數據如下：");  
        Log.i(TAG_HTTPGET, result);  
    } else {  
        Log.i(TAG_HTTPGET, "HttpPost 方式請求失敗");  
    }  
}

關於 HttpClinet 的相關開源工程

HttpClient 也擁有這大量優秀的開源工程，afinal、xUtils 以及AsyncHttpClient，也可以為廣大開發者提供已經造好的輪子。由於xUtils 是基於 afinal 重寫的，現在 xUtils3 也有替代 xUtils 的趨勢，所以我們在這就簡單介紹一下 AsyncHttpClient。

AsyncHttpClient

見名知意，AsyncHttpClient 對處理異步 Http 請求相當擅長，並通過匿名內部類處理回調結果，Http 異步請求均位於非 UI 線程，不會阻塞 UI 操作,通過線程池處理並發請求處理文件上傳、下載、響應結果自動打包 JSON 格式。使用起來會很方便。

//GET請求
AsyncHttpClient client = new AsyncHttpClient();  
//當然這裡也可以換成 new JsonHttpResponseHandler(),我們就能直接獲得 JSON 數據了。
client.get("http://www.google.com", new AsyncHttpResponseHandler() {

    @Override
    public void onStart() {
        // called before request is started
    }

    @Override
    public void onSuccess(int statusCode, Header[] headers, byte[] response) {
        // called when response HTTP status is "200 OK"
    }

    @Override
    public void onFailure(int statusCode, Header[] headers, byte[] errorResponse, Throwable e) {
        // called when response HTTP status is "4XX" (eg. 401, 403, 404)
    }

    @Override
    public void onRetry(int retryNo) {
        // called when request is retried
    }
});

//POST 請求
AsyncHttpClient client = new AsyncHttpClient();  
RequestParams params = new RequestParams();  
params.put("key", "value");  
params.put("more", "data");  
//同上，這裡一樣可以改成處理 JSON 數據的方法
client.get("http://www.google.com", params, new  
    TextHttpResponseHandler() {
        @Override
        public void onSuccess(int statusCode, Header[] headers, String response） {
            System.out.println(response);
        }

        @Override
        public void onFailure(int statusCode, Header[] headers, String responseBody, Throwable error） {
            Log.d("ERROR", error);
        }    
    }
);

經過上面的代碼發現，AsyncHttpClient 使用起來也是異常簡潔，主要靠回調方法來處理成功或失敗之後的邏輯。仔細想想，xUtils 的處理方式和這個處理方式很類似，看來好用設計還是很受人青睐的。

OKHttp

如果兩種網絡請求都想使用怎麼辦？那麼 OkHttp 是一個最佳解決方案了。

OkHttp 在網絡請求方面的口碑很好，就連 Google 自己也有使用OkHttp。雖然 Google6.0 中剔除了 HttpClient 的 Api，但是由於OkHttp 的影響力以及其強大的功能，使用 OkHttp 無需重寫您程序中的網絡代碼。同時最重要的一點 OkHttp 實現了幾乎和java.net.HttpURLConnection 一樣的 API。如果您用了 Apache HttpClient，則 OkHttp 也提供了一個對應的 okhttp-apache 模塊。足以說明 OkHttp 的強大，下面是一些例子。

• 一般的 get 請求
• 一般的 post 請求
• 基於 Http 的文件上傳
• 文件下載
• 加載圖片
• 支持請求回調，直接返回對象、對象集合
• 支持 session 的保持

簡單代碼實例

//GET 請求
OkHttpClient client = new OkHttpClient();

String run(String url) throws IOException {  
  Request request = new Request.Builder()
      .url(url)
      .build();

  Response response = client.newCall(request).execute();
  return response.body().string();
}

//POST 請求
public static final MediaType JSON  
    = MediaType.parse("application/json; charset=utf-8");

OkHttpClient client = new OkHttpClient();

String post(String url, String json) throws IOException {  
  RequestBody body = RequestBody.create(JSON, json);
  Request request = new Request.Builder()
      .url(url)
      .post(body)
      .build();
  Response response = client.newCall(request).execute();
  return response.body().string();
}

Android Studio Gradle 使用方式:

compile ‘com.squareup.okhttp:okhttp:2.7.0′

總結

Android 開發應用少不了使用網絡，移動互聯時代，搶占終端入口變得異常重要，那麼我們在開發過程中，不管使用哪一種網絡請求，HttpURLConnection 或者是 HttpClient，都可以滿足我們和服務器的溝通。