1.1. 請求執行

HttpClient最基本的功能就是執行Http方法。一個Http方法的執行涉及到一個或者多個Http請求/Http響應的互動，通常這個過程都會自動被HttpClient處理，對使用者透明。使用者只需要提供Http請求物件，HttpClient就會將http請求傳送給目標伺服器，並且接收伺服器的響應，如果http請求執行不成功，httpclient就會丟擲異樣。

下面是個很簡單的http請求執行的例子：

1. CloseableHttpClient httpclient = HttpClients.createDefault();  
2. HttpGet httpget = new
    HttpGet("http://localhost/");  
3. CloseableHttpResponse response = httpclient.execute(httpget);  
4. try {  
5.     <...>  
6. } finally {  
7.     response.close();  
8. }  

1.1.1. HTTP請求

所有的Http請求都有一個請求行(request line)，包括方法名、請求的URI和Http版本號。

HttpClient支援HTTP/1.1這個版本定義的所有Http方法：GET,HEAD,POST,PUT,DELETE

,TRACE和OPTIONS。對於每一種http方法，HttpClient都定義了一個相應的類：HttpGet, HttpHead, HttpPost, HttpPut, HttpDelete, HttpTrace和HttpOpquertions。

Request-URI即統一資源定位符，用來標明Http請求中的資源。Http request URIs包含協議名、主機名、主機埠（可選）、資源路徑、query（可選）和片段資訊（可選）。

1. HttpGet httpget = new HttpGet(  
2.      "http://www.google.com/search?hl=en&q=httpclient&btnG=Google+Search&aq=f&oq="
   );  

HttpClient提供URIBuilder工具類來簡化URIs的建立和修改過程。

1. URI uri = new URIBuilder()  
2.         .setScheme("http")  
3.         .setHost("www.google.com")  
4.         .setPath("/search")  
5.         .setParameter("q", "httpclient")  
6.         .setParameter("btnG", "Google Search")  
7.         .setParameter("aq", "f")  
8.         .setParameter("oq", "")  
9.         .build();  
10. HttpGet httpget = new HttpGet(uri);  
11. System.out.println(httpget.getURI());  

上述程式碼會在控制檯輸出：

1. http://www.google.com/search?q=httpclient&btnG=Google+Search&aq=f&oq=

1.1.2. HTTP響應

伺服器收到客戶端的http請求後，就會對其進行解析，然後把響應發給客戶端，這個響應就是HTTP response.HTTP響應第一行是協議版本，之後是數字狀態碼和相關聯的文字段。

1. HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,   
2. HttpStatus.SC_OK, "OK");  
3. System.out.println(response.getProtocolVersion());  
4. System.out.println(response.getStatusLine().getStatusCode());  
5. System.out.println(response.getStatusLine().getReasonPhrase());  
6. System.out.println(response.getStatusLine().toString());  

上述程式碼會在控制檯輸出：

1. HTTP/1.1
2. 200
3. OK  
4. HTTP/1.1200 OK  

1.1.3. 訊息頭

一個Http訊息可以包含一系列的訊息頭，用來對http訊息進行描述，比如訊息長度，訊息型別等等。HttpClient提供了方法來獲取、新增、移除、列舉訊息頭。

1. HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,   
2.     HttpStatus.SC_OK, "OK");  
3. response.addHeader("Set-Cookie",   
4.     "c1=a; path=/; domain=localhost");  
5. response.addHeader("Set-Cookie",   
6.     "c2=b; path=\"/\", c3=c; domain=\"localhost\"");  
7. Header h1 = response.getFirstHeader("Set-Cookie");  
8. System.out.println(h1);  
9. Header h2 = response.getLastHeader("Set-Cookie");  
10. System.out.println(h2);  
11. Header[] hs = response.getHeaders("Set-Cookie");  
12. System.out.println(hs.length);  

上述程式碼會在控制檯輸出：

1. Set-Cookie: c1=a; path=/; domain=localhost  
2. Set-Cookie: c2=b; path="/", c3=c; domain="localhost"
3. 2

最有效的獲取指定型別的訊息頭的方法還是使用HeaderIterator介面。

1. HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,   
2.     HttpStatus.SC_OK, "OK");  
3. response.addHeader("Set-Cookie",   
4.     "c1=a; path=/; domain=localhost");  
5. response.addHeader("Set-Cookie",   
6.     "c2=b; path=\"/\", c3=c; domain=\"localhost\"");  
7. HeaderIterator it = response.headerIterator("Set-Cookie");  
8. while (it.hasNext()) {  
9.     System.out.println(it.next());  
10. }  

上述程式碼會在控制檯輸出：

1. Set-Cookie: c1=a; path=/; domain=localhost  
2. Set-Cookie: c2=b; path="/", c3=c; domain="localhost"

HeaderIterator也提供非常便捷的方式，將Http訊息解析成單獨的訊息頭元素。

1. HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,   
2.     HttpStatus.SC_OK, "OK");  
3. response.addHeader("Set-Cookie",   
4.     "c1=a; path=/; domain=localhost");  
5. response.addHeader("Set-Cookie",   
6.     "c2=b; path=\"/\", c3=c; domain=\"localhost\"");  
7. HeaderElementIterator it = new BasicHeaderElementIterator(  
8.     response.headerIterator("Set-Cookie"));  
9. while (it.hasNext()) {  
10.     HeaderElement elem = it.nextElement();   
11.     System.out.println(elem.getName() + " = " + elem.getValue());  
12.     NameValuePair[] params = elem.getParameters();  
13.     for (int i = 0; i < params.length; i++) {  
14.         System.out.println(" " + params[i]);  
15.     }  
16. }  

上述程式碼會在控制檯輸出：

1. c1 = a  
2. path=/  
3. domain=localhost  
4. c2 = b  
5. path=/  
6. c3 = c  
7. domain=localhost  

1.1.4. HTTP實體

Http訊息可以攜帶http實體，這個http實體既可以是http請求，也可以是http響應的。Http實體，可以在某些http請求或者響應中發現，但不是必須的。Http規範中定義了兩種包含請求的方法：POST和PUT。HTTP響應一般會包含一個內容實體。當然這條規則也有異常情況，如Head方法的響應，204沒有內容，304沒有修改或者205內容資源重置。

HttpClient根據來源的不同，劃分了三種不同的Http實體內容。

• streamed流式: 內容是通過流來接受或者在執行中產生。特別是，streamed這一類包含從http響應中獲取的實體內容。一般說來，streamed實體是不可重複的。
• self-contained自我包含式:內容在記憶體中或通過獨立的連線或其它實體中獲得。self-contained型別的實體內容通常是可重複的。這種型別的實體通常用於關閉http請求。
• wrapping包裝式: 這種型別的內容是從另外的http實體中獲取的。

當從Http響應中讀取內容時，上面的三種區分對於連線管理器來說是非常重要的。對於由應用程式建立而且只使用HttpClient傳送的請求實體，streamed和self-contained兩種型別的不同就不那麼重要了。這種情況下，建議考慮如streamed流式這種不能重複的實體，和可以重複的self-contained自我包含式實體。

1.1.4.1. 可重複的實體

一個實體是可重複的，也就是說它的包含的內容可以被多次讀取。這種多次讀取只有self contained（自包含）的實體能做到（比如ByteArrayEntity或者StringEntity)。

1.1.4.2. 使用Http實體

由於一個Http實體既可以表示二進位制內容，又可以表示文字內容，所以Http實體要支援字元編碼（為了支援後者，即文字內容）。

當需要執行一個完整內容的Http請求或者Http請求已經成功，伺服器要傳送響應到客戶端時，Http實體就會被建立。

相關推薦