HttpURLConnection與HttpClient淺析

轉自：https://blog.csdn.net/u012838207/article/details/82867701

HttpURLConnection與HttpClient淺析

1. GET請求與POST請求

HTTP協議是如今Internet上使用得最多、最重要的協議了，愈來愈多的Java應用程序須要直接經過HTTP協議來訪問網絡資源。

在介紹HttpURLConnection前，咱們仍是再來講一下URL請求最經常使用的兩種方式：GET請求與POST請求。

GET請求的數據會附在URL以後（就是把數據放置在HTTP協議頭中），以?分割URL和傳輸數據，參數之間以&相連，如：http://localhost:8080/test.do?name=test&password=123456。

GET請求發送的參數若是數據是英文字母或數字，則按原樣發送，若是是空格，則轉換爲+，若是是中文或其餘字符，則直接把字符串用BASE64加密，得出如 %E4%BD%A0%E5%A5%BD 這相似的字符串，其中％XX中的XX爲該符號以16進製表示的ASCII。

POST請求的參數不是放在URL字符串裏面，而是放在HTTP請求的正文內，請求的參數被封裝起來以流的形式發送給服務端。

對於GET方式提交數據的大小，HTTP協議並無硬性限制，但某些瀏覽器及服務器會對它進行限制，如IE對URL長度的限制是2083字節(2K+35)。理論上POST也沒有限制，可傳較大量的數據。

POST的安全性要比GET的安全性高。好比：經過GET提交數據，用戶名和密碼將明文出如今URL上，由於登陸頁面有可能被瀏覽器緩存，若是其餘人查看瀏覽器的歷史紀錄，那麼別人就能夠拿到你的帳號和密碼了，除此以外，使用GET提交數據還可能會形成Cross-site request forgery（CSRF，跨站請求僞造）攻擊。

通常來講，Get是向服務器索取數據的一種請求，而Post是向服務器提交數據的一種請求。

2. HttpURLConnection簡介

在JDK的java.net包中已經提供了訪問HTTP協議的基本功能的類：HttpURLConnection。

HttpURLConnection是Java的標準類，它繼承自URLConnection，可用於向指定網站發送GET請求、POST請求。它在URLConnection的基礎上提供了以下便捷的方法：

int getResponseCode(); // 獲取服務器的響應代碼。 String getResponseMessage(); // 獲取服務器的響應消息。 String getResponseMethod(); // 獲取發送請求的方法。 void setRequestMethod(String method); // 設置發送請求的方法。

3. HttpURLConnection的使用

3.1 使用GET方式訪問HTTP

 1 package com.qf.demo;
 2 
 3 import java.io.BufferedReader;
 4 import java.io.IOException;
 5 import java.io.InputStreamReader;
 6 import java.net.HttpURLConnection;
 7 import java.net.URL;
 8 
 9 /**
10  * GET請求示例
11  * 
12  * @author 小明
13  *
14  */
15 public class GetDemo {
16 
17     public static void main(String[] args) {
18         try {
19             // 1. 獲得訪問地址的URL
20             URL url = new URL(
21                     "http://localhost:8080/Servlet/do_login.do?username=test&password=123456");
22             // 2. 獲得網絡訪問對象java.net.HttpURLConnection
23             HttpURLConnection connection = (HttpURLConnection) url
24                     .openConnection();
25             /* 3. 設置請求參數（過時時間，輸入、輸出流、訪問方式），以流的形式進行鏈接 */
26             // 設置是否向HttpURLConnection輸出
27             connection.setDoOutput(false);
28             // 設置是否從httpUrlConnection讀入
29             connection.setDoInput(true);
30             // 設置請求方式
31             connection.setRequestMethod("GET");
32             // 設置是否使用緩存
33             connection.setUseCaches(true);
34             // 設置此 HttpURLConnection 實例是否應該自動執行 HTTP 重定向
35             connection.setInstanceFollowRedirects(true);
36             // 設置超時時間
37             connection.setConnectTimeout(3000);
38             // 鏈接
39             connection.connect();
40             // 4. 獲得響應狀態碼的返回值 responseCode
41             int code = connection.getResponseCode();
42             // 5. 若是返回值正常，數據在網絡中是以流的形式獲得服務端返回的數據
43             String msg = "";
44             if (code == 200) { // 正常響應
45                 // 從流中讀取響應信息
46                 BufferedReader reader = new BufferedReader(
47                         new InputStreamReader(connection.getInputStream()));
48                 String line = null;
49 
50                 while ((line = reader.readLine()) != null) { // 循環從流中讀取
51                     msg += line + "\n";
52                 }
53                 reader.close(); // 關閉流
54             }
55             // 6. 斷開鏈接，釋放資源
56             connection.disconnect();
57 
58             // 顯示響應結果
59             System.out.println(msg);
60         } catch (IOException e) {
61             e.printStackTrace();
62         }
63     }
64 }

 

3.2 使用POST方式訪問HTTP

 1 package com.qf.demo;
 2 
 3 import java.io.BufferedReader;
 4 import java.io.IOException;
 5 import java.io.InputStreamReader;
 6 import java.io.OutputStream;
 7 import java.net.HttpURLConnection;
 8 import java.net.MalformedURLException;
 9 import java.net.URL;
10 
11 /**
12  * POST請求示例
13  * 
14  * @author 小明
15  *
16  */
17 public class PostDemo {
18 
19     public static void main(String[] args) {
20         try {
21             // 1. 獲取訪問地址URL
22             URL url = new URL("http://localhost:8080/Servlet/do_login.do");
23             // 2. 建立HttpURLConnection對象
24             HttpURLConnection connection = (HttpURLConnection) url
25                     .openConnection();
26             /* 3. 設置請求參數等 */
27             // 請求方式
28             connection.setRequestMethod("POST");
29             // 超時時間
30             connection.setConnectTimeout(3000);
31             // 設置是否輸出
32             connection.setDoOutput(true);
33             // 設置是否讀入
34             connection.setDoInput(true);
35             // 設置是否使用緩存
36             connection.setUseCaches(false);
37             // 設置此 HttpURLConnection 實例是否應該自動執行 HTTP 重定向
38             connection.setInstanceFollowRedirects(true);
39             // 設置使用標準編碼格式編碼參數的名-值對
40             connection.setRequestProperty("Content-Type",
41                     "application/x-www-form-urlencoded");
42             // 鏈接
43             connection.connect();
44             /* 4. 處理輸入輸出 */
45             // 寫入參數到請求中
46             String params = "username=test&password=123456";
47             OutputStream out = connection.getOutputStream();
48             out.write(params.getBytes());
49             out.flush();
50             out.close();
51             // 從鏈接中讀取響應信息
52             String msg = "";
53             int code = connection.getResponseCode();
54             if (code == 200) {
55                 BufferedReader reader = new BufferedReader(
56                         new InputStreamReader(connection.getInputStream()));
57                 String line;
58 
59                 while ((line = reader.readLine()) != null) {
60                     msg += line + "\n";
61                 }
62                 reader.close();
63             }
64             // 5. 斷開鏈接
65             connection.disconnect();
66 
67             // 處理結果
68             System.out.println(msg);
69         } catch (MalformedURLException e) {
70             e.printStackTrace();
71         } catch (IOException e) {
72             e.printStackTrace();
73         }
74     }
75 }

 

3.3 說明

• HttpURLConnection對象不能直接構造，須要經過URL類中的openConnection()方法來得到。
• HttpURLConnection的connect()函數，實際上只是創建了一個與服務器的TCP鏈接，並無實際發送HTTP請求。HTTP請求實際上直到咱們獲取服務器響應數據（如調用getInputStream()、getResponseCode()等方法）時才正式發送出去。
• 對HttpURLConnection對象的配置都須要在connect()方法執行以前完成。
• HttpURLConnection是基於HTTP協議的，其底層經過socket通訊實現。若是不設置超時（timeout），在網絡異常的狀況下，可能會致使程序僵死而不繼續往下執行。
• HTTP正文的內容是經過OutputStream流寫入的， 向流中寫入的數據不會當即發送到網絡，而是存在於內存緩衝區中，待流關閉時，根據寫入的內容生成HTTP正文。
• 調用getInputStream()方法時，返回一個輸入流，用於從中讀取服務器對於HTTP請求的返回信息。
• 咱們可使用HttpURLConnection.connect()方法手動的發送一個HTTP請求，可是若是要獲取HTTP響應的時候，請求就會自動的發起，好比咱們使用HttpURLConnection.getInputStream()方法的時候，因此徹底沒有必要調用connect()方法。

4. HttpClient簡介

在通常狀況下，若是隻是須要向Web站點的某個簡單頁面提交請求並獲取服務器響應，HttpURLConnection徹底能夠勝任。但在絕大部分狀況下，Web站點的網頁可能沒這麼簡單，這些頁面並非經過一個簡單的URL就可訪問的，可能須要用戶登陸並且具備相應的權限纔可訪問該頁面。在這種狀況下，就須要涉及Session、Cookie的處理了，若是打算使用HttpURLConnection來處理這些細節，固然也是可能實現的，只是處理起來難度就大了。

爲了更好地處理向Web站點請求，包括處理Session、Cookie等細節問題，Apache開源組織提供了一個HttpClient項目，看它的名稱就知道，它是一個簡單的HTTP客戶端（並非瀏覽器），能夠用於發送HTTP請求，接收HTTP響應。但不會緩存服務器的響應，不能執行HTML頁面中嵌入的Javascript代碼；也不會對頁面內容進行任何解析、處理。

簡單來講，HttpClient就是一個加強版的HttpURLConnection，HttpURLConnection能夠作的事情HttpClient所有能夠作；HttpURLConnection沒有提供的有些功能，HttpClient也提供了，但它只是關注於如何發送請求、接收響應，以及管理HTTP鏈接。

5. HttpClient的使用

使用HttpClient發送請求、接收響應很簡單，只要以下幾步便可。

1. 建立HttpClient對象。
2. 若是須要發送GET請求，建立HttpGet對象；若是須要發送POST請求，建立HttpPost對象。
3. 若是須要發送請求參數，可調用HttpGet、HttpPost共同的setParams(HttpParams params)方法來添加請求參數；對於HttpPost對象而言，也可調用setEntity(HttpEntity entity)方法來設置請求參數。
4. 調用HttpClient對象的execute(HttpUriRequest request)發送請求，執行該方法返回一個HttpResponse。
5. 調用HttpResponse的getAllHeaders()、getHeaders(String name)等方法可獲取服務器的響應頭；調用HttpResponse的getEntity()方法可獲取HttpEntity對象，該對象包裝了服務器的響應內容。程序可經過該對象獲取服務器的響應內容。

5.1 使用GET方式訪問HTTP

 1 package com.qf.client;
 2 
 3 import java.io.IOException;
 4 
 5 import org.apache.http.HttpEntity;
 6 import org.apache.http.client.ClientProtocolException;
 7 import org.apache.http.client.methods.CloseableHttpResponse;
 8 import org.apache.http.client.methods.HttpGet;
 9 import org.apache.http.impl.client.CloseableHttpClient;
10 import org.apache.http.impl.client.HttpClientBuilder;
11 import org.apache.http.util.EntityUtils;
12 
13 /**
14  * GET請求示例
15  * 
16  * @author 小明
17  *
18  */
19 public class GetDemo {
20 
21     public static void main(String[] args) {
22         // 1. 建立HttpClient對象
23         CloseableHttpClient httpClient = HttpClientBuilder.create().build();
24         // 2. 建立HttpGet對象
25         HttpGet httpGet = new HttpGet(
26                 "http://localhost:8080/Servlet/do_login.do?username=test&password=123456");
27         CloseableHttpResponse response = null;
28         try {
29             // 3. 執行GET請求
30             response = httpClient.execute(httpGet);
31             System.out.println(response.getStatusLine());
32             // 4. 獲取響應實體
33             HttpEntity entity = response.getEntity();
34             // 5. 處理響應實體
35             if (entity != null) {
36                 System.out.println("長度：" + entity.getContentLength());
37                 System.out.println("內容：" + EntityUtils.toString(entity));
38             }
39         } catch (ClientProtocolException e) {
40             e.printStackTrace();
41         } catch (IOException e) {
42             e.printStackTrace();
43         } finally {
44             // 6. 釋放資源
45             try {
46                 response.close();
47                 httpClient.close();
48             } catch (IOException e) {
49                 e.printStackTrace();
50             }
51         }
52     }
53 }

5.2 使用POST方式訪問HTTP

 1 package com.qf.client;
 2 
 3 import java.io.IOException;
 4 import java.io.UnsupportedEncodingException;
 5 import java.util.ArrayList;
 6 import java.util.List;
 7 
 8 import org.apache.http.HttpEntity;
 9 import org.apache.http.NameValuePair;
10 import org.apache.http.client.ClientProtocolException;
11 import org.apache.http.client.entity.UrlEncodedFormEntity;
12 import org.apache.http.client.methods.CloseableHttpResponse;
13 import org.apache.http.client.methods.HttpPost;
14 import org.apache.http.impl.client.CloseableHttpClient;
15 import org.apache.http.impl.client.HttpClientBuilder;
16 import org.apache.http.message.BasicNameValuePair;
17 import org.apache.http.util.EntityUtils;
18 
19 /**
20  * POST請求測試
21  * 
22  * @author 小明
23  *
24  */
25 public class PostDemo {
26 
27     public static void main(String[] args) {
28         // 1. 建立HttpClient對象
29         CloseableHttpClient httpClient = HttpClientBuilder.create().build();
30         // 2. 建立HttpPost對象
31         HttpPost post = new HttpPost(
32                 "http://localhost:8080/Servlet/do_login.do");
33         // 3. 設置POST請求傳遞參數
34         List<NameValuePair> params = new ArrayList<NameValuePair>();
35         params.add(new BasicNameValuePair("username", "test"));
36         params.add(new BasicNameValuePair("password", "12356"));
37         try {
38             UrlEncodedFormEntity entity = new UrlEncodedFormEntity(params);
39             post.setEntity(entity);
40         } catch (UnsupportedEncodingException e) {
41             e.printStackTrace();
42         }
43         // 4. 執行請求並處理響應
44         try {
45             CloseableHttpResponse response = httpClient.execute(post);
46             HttpEntity entity = response.getEntity();
47             if (entity != null){
48                 System.out.println("響應內容：");
49                 System.out.println(EntityUtils.toString(entity));
50             }
51             response.close();
52         } catch (ClientProtocolException e) {
53             e.printStackTrace();
54         } catch (IOException e) {
55             e.printStackTrace();
56         } finally {
57             // 釋放資源
58             try {
59                 httpClient.close();
60             } catch (IOException e) {
61                 e.printStackTrace();
62             }
63         }
64     }
65 }

5.3 說明

HttpClient相比傳統JDK自帶的URLConnection，增長了易用性和靈活性，它不只使客戶端發送HTTP請求變得容易，並且也方便了開發人員測試接口（基於Http協議的），即提升了開發的效率，也方便提升代碼的健壯性。