Android探索之HttpURLConnection網絡請求

前言： 

     最近一直想着學習一下比較好的開源網絡框架okhttp，想着學習之前還是先總結一下Android原生提供的網絡請求。之前一直在使用HttpClient，但是android 6.0(api 23) SDK，不再提供org.apache.http.*(只保留幾個類).所以我們今天主要總結HttpURLConnection的使用。

HttpURLConnection介紹：

   HttpURLConnection是一種多用途、輕量極的HTTP客戶端，使用它來進行HTTP操作可以適用於大多數的應用程序。對於之前為何一直使用HttpClient而不使用HttpURLConnection也是有原因的。具體分析如下

• HttpClient是apache的開源框架，封裝了訪問http的請求頭，參數，內容體，響應等等，使用起來比較方便，而HttpURLConnection是java的標准類，什么都沒封裝，用起來太原始，不方便，比如重訪問的自定義，以及一些高級功能等。
• 從穩定性方面來說的話，HttpClient很穩定，功能強，BUG少，容易控制細節，而之前的HttpURLConnection一直存在着版本兼容的問題，不過在后續的版本中已經相繼修復掉了。

   從上面可以看出之前一直使用HttClient是由於HttpURLConnection不穩定導致，那么現在谷歌雖然修復了HttpURLConnection之前存在的一些問題之后，相比HttpClient有什么優勢呢？為何要廢除HttpClient呢？

• HttpUrlConnection是Android SDK的標准實現，而HttpClient是apache的開源實現；
• HttpUrlConnection直接支持GZIP壓縮；HttpClient也支持，但要自己寫代碼處理；
• HttpUrlConnection直接支持系統級連接池，即打開的連接不會直接關閉，在一段時間內所有程序可共用；HttpClient當然也能做到，但畢竟不如官方直接系統底層支持好；
• HttpUrlConnection直接在系統層面做了緩存策略處理，加快重復請求的速度。

HttpURLConnection使用：

     Get請求實現：

    private void requestGet(HashMap<String, String> paramsMap) {
        try {
            String baseUrl = "https://xxx.com/getUsers?";
            StringBuilder tempParams = new StringBuilder();
            int pos = 0;
            for (String key : paramsMap.keySet()) {
                if (pos > 0) {
                    tempParams.append("&");
                }
                tempParams.append(String.format("%s=%s", key, URLEncoder.encode(paramsMap.get(key),"utf-8")));
                pos++;
            }
            String requestUrl = baseUrl + tempParams.toString();
            // 新建一個URL對象
            URL url = new URL(requestUrl);
            // 打開一個HttpURLConnection連接
            HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
            // 設置連接主機超時時間
            urlConn.setConnectTimeout(5 * 1000);
            //設置從主機讀取數據超時
            urlConn.setReadTimeout(5 * 1000);
            // 設置是否使用緩存  默認是true
            urlConn.setUseCaches(true);
            // 設置為Post請求
            urlConn.setRequestMethod("GET");
            //urlConn設置請求頭信息
            //設置請求中的媒體類型信息。
            urlConn.setRequestProperty("Content-Type", "application/json");
            //設置客戶端與服務連接類型
            urlConn.addRequestProperty("Connection", "Keep-Alive");
            // 開始連接
            urlConn.connect();
            // 判斷請求是否成功
            if (urlConn.getResponseCode() == 200) {
                // 獲取返回的數據
                String result = streamToString(urlConn.getInputStream());
                Log.e(TAG, "Get方式請求成功，result--->" + result);
            } else {
                Log.e(TAG, "Get方式請求失敗");
            }
            // 關閉連接
            urlConn.disconnect();
        } catch (Exception e) {
            Log.e(TAG, e.toString());
        }
    }

    POST請求實現：

    private void requestPost(HashMap<String, String> paramsMap) {
        try {
            String baseUrl = "https://xxx.com/getUsers";
            //合成參數
            StringBuilder tempParams = new StringBuilder();
            int pos = 0;
            for (String key : paramsMap.keySet()) {
                if (pos > 0) {
                    tempParams.append("&");
                }
                tempParams.append(String.format("%s=%s", key,  URLEncoder.encode(paramsMap.get(key),"utf-8")));
                pos++;
            }
            String params =tempParams.toString();
            // 請求的參數轉換為byte數組
            byte[] postData = params.getBytes();
            // 新建一個URL對象
            URL url = new URL(baseUrl);
            // 打開一個HttpURLConnection連接
            HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
            // 設置連接超時時間
            urlConn.setConnectTimeout(5 * 1000);
            //設置從主機讀取數據超時
            urlConn.setReadTimeout(5 * 1000);
            // Post請求必須設置允許輸出 默認false
            urlConn.setDoOutput(true);
            //設置請求允許輸入 默認是true
            urlConn.setDoInput(true);
            // Post請求不能使用緩存
            urlConn.setUseCaches(false);
            // 設置為Post請求
            urlConn.setRequestMethod("POST");
            //設置本次連接是否自動處理重定向
            urlConn.setInstanceFollowRedirects(true);
            // 配置請求Content-Type
            urlConn.setRequestProperty("Content-Type", "application/json");
            // 開始連接
            urlConn.connect();
            // 發送請求參數
            DataOutputStream dos = new DataOutputStream(urlConn.getOutputStream());
            dos.write(postData);
            dos.flush();
            dos.close();
            // 判斷請求是否成功
            if (urlConn.getResponseCode() == 200) {
                // 獲取返回的數據
                String result = streamToString(urlConn.getInputStream());
                Log.e(TAG, "Post方式請求成功，result--->" + result);
            } else {
                Log.e(TAG, "Post方式請求失敗");
            }
            // 關閉連接
            urlConn.disconnect();
        } catch (Exception e) {
            Log.e(TAG, e.toString());
        }
    }

處理網絡流：將輸入流轉換成字符串

    /**
     * 將輸入流轉換成字符串
     *
     * @param is 從網絡獲取的輸入流
     * @return
     */
    public String streamToString(InputStream is) {
        try {
            ByteArrayOutputStream baos = new ByteArrayOutputStream();
            byte[] buffer = new byte[1024];
            int len = 0;
            while ((len = is.read(buffer)) != -1) {
                baos.write(buffer, 0, len);
            }
            baos.close();
            is.close();
            byte[] byteArray = baos.toByteArray();
            return new String(byteArray);
        } catch (Exception e) {
            Log.e(TAG, e.toString());
            return null;
        }
    }

   以上就是HttpConnection的get、post的簡單實現，如何實現文件的下載和上傳呢？

文件下載：

private void downloadFile(String fileUrl){
        try {
            // 新建一個URL對象
            URL url = new URL(fileUrl);
            // 打開一個HttpURLConnection連接
            HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
            // 設置連接主機超時時間
            urlConn.setConnectTimeout(5 * 1000);
            //設置從主機讀取數據超時
            urlConn.setReadTimeout(5 * 1000);
            // 設置是否使用緩存  默認是true
            urlConn.setUseCaches(true);
            // 設置為Post請求
            urlConn.setRequestMethod("GET");
            //urlConn設置請求頭信息
            //設置請求中的媒體類型信息。
            urlConn.setRequestProperty("Content-Type", "application/json");
            //設置客戶端與服務連接類型
            urlConn.addRequestProperty("Connection", "Keep-Alive");
            // 開始連接
            urlConn.connect();
            // 判斷請求是否成功
            if (urlConn.getResponseCode() == 200) {
                String filePath="";
                File  descFile = new File(filePath);
                FileOutputStream fos = new FileOutputStream(descFile);;
                byte[] buffer = new byte[1024];
                int len;
                InputStream inputStream = urlConn.getInputStream();
                while ((len = inputStream.read(buffer)) != -1) {
                    // 寫到本地
                    fos.write(buffer, 0, len);
                }
            } else {
                Log.e(TAG, "文件下載失敗");
            }
            // 關閉連接
            urlConn.disconnect();
        } catch (Exception e) {
            Log.e(TAG, e.toString());
        }
    }

文件上傳：

    private void upLoadFile(String filePath, HashMap<String, String> paramsMap) {
        try {
            String baseUrl = "https://xxx.com/uploadFile";
            File file = new File(filePath);
            //新建url對象
            URL url = new URL(baseUrl);
            //通過HttpURLConnection對象,向網絡地址發送請求
            HttpURLConnection urlConn = (HttpURLConnection) url.openConnection();
            //設置該連接允許讀取
            urlConn.setDoOutput(true);
            //設置該連接允許寫入
            urlConn.setDoInput(true);
            //設置不能適用緩存
            urlConn.setUseCaches(false);
            //設置連接超時時間
            urlConn.setConnectTimeout(5 * 1000);   //設置連接超時時間
            //設置讀取超時時間
            urlConn.setReadTimeout(5 * 1000);   //讀取超時
            //設置連接方法post
            urlConn.setRequestMethod("POST");
            //設置維持長連接
            urlConn.setRequestProperty("connection", "Keep-Alive");
            //設置文件字符集
            urlConn.setRequestProperty("Accept-Charset", "UTF-8");
            //設置文件類型
            urlConn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + "*****");
            String name = file.getName();
            DataOutputStream requestStream = new DataOutputStream(urlConn.getOutputStream());
            requestStream.writeBytes("--" + "*****" + "\r\n");
            //發送文件參數信息
            StringBuilder tempParams = new StringBuilder();
            tempParams.append("Content-Disposition: form-data; name=\"" + name + "\"; filename=\"" + name + "\"; ");
            int pos = 0;
            int size=paramsMap.size();
            for (String key : paramsMap.keySet()) {
                tempParams.append( String.format("%s=\"%s\"", key, paramsMap.get(key), "utf-8"));
                if (pos < size-1) {
                    tempParams.append("; ");
                }
                pos++;
            }
            tempParams.append("\r\n");
            tempParams.append("Content-Type: application/octet-stream\r\n");
            tempParams.append("\r\n");
            String params = tempParams.toString();
            requestStream.writeBytes(params);
            //發送文件數據
            FileInputStream fileInput = new FileInputStream(file);
            int bytesRead;
            byte[] buffer = new byte[1024];
            DataInputStream in = new DataInputStream(new FileInputStream(file));
            while ((bytesRead = in.read(buffer)) != -1) {
                requestStream.write(buffer, 0, bytesRead);
            }
            requestStream.writeBytes("\r\n");
            requestStream.flush();
            requestStream.writeBytes("--" + "*****" + "--" + "\r\n");
            requestStream.flush();
            fileInput.close();
            int statusCode = urlConn.getResponseCode();
            if (statusCode == 200) {
                // 獲取返回的數據
                String result = streamToString(urlConn.getInputStream());
                Log.e(TAG, "上傳成功，result--->" + result);
            } else {
                Log.e(TAG, "上傳失敗");
            }
        } catch (IOException e) {
            Log.e(TAG, e.toString());
        }
    }

 

權限：

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

 

知識擴展：

• 關於ResponseCode（http://univasity.iteye.com/blog/963433）
  
  
• 關於 Content-Type（http://blog.csdn.net/blueheart20/article/details/45174399）