前言

超文本傳輸協(xié)議（HTTP）也許是當今互聯(lián)網(wǎng)上使用的最重要的協(xié)議了。Web服務，有網(wǎng)絡功能的設備和網(wǎng)絡計算的發(fā)展，都持續(xù)擴展了HTTP協(xié)議的角色，超越了用戶使用的Web瀏覽器范疇，同時，也增加了需要HTTP協(xié)議支持的應用程序的數(shù)量。

盡管java.net包提供了基本通過HTTP訪問資源的功能，但它沒有提供全面的靈活性和其它很多應用程序需要的功能。HttpClient就是尋求彌補這項空白的組件，通過提供一個有效的，保持更新的，功能豐富的軟件包來實現(xiàn)客戶端最新的HTTP標準和建議。

為擴展而設計，同時為基本的HTTP協(xié)議提供強大的支持，HttpClient組件也許就是構(gòu)建HTTP客戶端應用程序，比如web瀏覽器，web服務端，利用或擴展HTTP協(xié)議進行分布式通信的系統(tǒng)的開發(fā)人員的關(guān)注點。

1. HttpClient的范圍

基于HttpCore[http://hc.apache.org/httpcomponents-core/index.html]的客戶端HTTP運輸實現(xiàn)庫

基于經(jīng)典（阻塞）I/O

內(nèi)容無關(guān)

2. 什么是HttpClient不能做的

HttpClient不是一個瀏覽器。它是一個客戶端的HTTP通信實現(xiàn)庫。HttpClient的目標是發(fā)送和接收HTTP報文。HttpClient不會去緩存內(nèi)容，執(zhí)行嵌入在HTML頁面中的javascript代碼，猜測內(nèi)容類型，重新格式化請求/重定向URI，或者其它和HTTP運輸無關(guān)的功能。

第一章 基礎

1.1 執(zhí)行請求

HttpClient最重要的功能是執(zhí)行HTTP方法。一個HTTP方法的執(zhí)行包含一個或多個HTTP請求/HTTP響應交換，通常由HttpClient的內(nèi)部來處理。而期望用戶提供一個要執(zhí)行的請求對象，而HttpClient期望傳輸請求到目標服務器并返回對應的響應對象，或者當執(zhí)行不成功時拋出異常。

很自然地，HttpClient API的主要切入點就是定義描述上述規(guī)約的HttpClient接口。

這里有一個很簡單的請求執(zhí)行過程的示例：

HttpClient httpclient = new DefaultHttpClient();

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

InputStream instream = entity.getContent();

int l;

byte[] tmp = new byte[2048];

while ((l = instream.read(tmp)) != -1) {

}

}

1.1.1 HTTP請求

所有HTTP請求有一個組合了方法名，請求URI和HTTP協(xié)議版本的請求行。

HttpClient支持所有定義在HTTP/1.1版本中的HTTP方法：GET，HEAD，POST，PUT，DELETE，TRACE和OPTIONS。對于每個方法類型都有一個特殊的類：HttpGet，HttpHead，HttpPost，HttpPut，HttpDelete，HttpTrace和HttpOptions。

請求的URI是統(tǒng)一資源定位符，它標識了應用于哪個請求之上的資源。HTTP請求URI包含一個協(xié)議模式，主機名稱，可選的端口，資源路徑，可選的查詢和可選的片段。

HttpGet httpget = new HttpGet(

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

HttpClient提供很多工具方法來簡化創(chuàng)建和修改執(zhí)行URI。

URI也可以編程來拼裝：

URI uri = URIUtils.createURI("http", "www.google.com", -1, "/search",

"q=httpclient&btnG=Google+Search&aq=f&oq=", null);

HttpGet httpget = new HttpGet(uri);

System.out.println(httpget.getURI());

輸出內(nèi)容為：

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

查詢字符串也可以從獨立的參數(shù)中來生成：

List<NameValuePair> qparams = new ArrayList<NameValuePair>();

qparams.add(new BasicNameValuePair("q", "httpclient"));

qparams.add(new BasicNameValuePair("btnG", "Google Search"));

qparams.add(new BasicNameValuePair("aq", "f"));

qparams.add(new BasicNameValuePair("oq", null));

URI uri = URIUtils.createURI("http", "www.google.com", -1, "/search",

URLEncodedUtils.format(qparams, "UTF-8"), null);

HttpGet httpget = new HttpGet(uri);

System.out.println(httpget.getURI());

輸出內(nèi)容為：

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

1.1.2 HTTP響應

HTTP響應是由服務器在接收和解釋請求報文之后返回發(fā)送給客戶端的報文。響應報文的第一行包含了協(xié)議版本，之后是數(shù)字狀態(tài)碼和相關(guān)聯(lián)的文本段。

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,

HttpStatus.SC_OK, "OK");

System.out.println(response.getProtocolVersion());

System.out.println(response.getStatusLine().getStatusCode());

System.out.println(response.getStatusLine().getReasonPhrase());

System.out.println(response.getStatusLine().toString());

輸出內(nèi)容為：

HTTP/1.1

200

OK

HTTP/1.1 200 OK

1.1.3 處理報文頭部

一個HTTP報文可以包含很多描述如內(nèi)容長度，內(nèi)容類型等信息屬性的頭部信息。

HttpClient提供獲取，添加，移除和枚舉頭部信息的方法。

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,

HttpStatus.SC_OK, "OK");

response.addHeader("Set-Cookie",

"c1=a; path=/; domain=localhost");

response.addHeader("Set-Cookie",

"c2=b; path=\"/\", c3=c; domain=\"localhost\"");

Header h1 = response.getFirstHeader("Set-Cookie");

System.out.println(h1);

Header h2 = response.getLastHeader("Set-Cookie");

System.out.println(h2);

Header[] hs = response.getHeaders("Set-Cookie");

System.out.println(hs.length);

輸出內(nèi)容為：

Set-Cookie: c1=a; path=/; domain=localhost

Set-Cookie: c2=b; path="/", c3=c; domain="localhost"

獲得給定類型的所有頭部信息最有效的方式是使用HeaderIterator接口。

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,

HttpStatus.SC_OK, "OK");

response.addHeader("Set-Cookie",

"c1=a; path=/; domain=localhost");

response.addHeader("Set-Cookie",

"c2=b; path=\"/\", c3=c; domain=\"localhost\"");

HeaderIterator it = response.headerIterator("Set-Cookie");

while (it.hasNext()) {

System.out.println(it.next());

}

輸出內(nèi)容為：

Set-Cookie: c1=a; path=/; domain=localhost

Set-Cookie: c2=b; path="/", c3=c; domain="localhost"

它也提供解析HTTP報文到獨立頭部信息元素的方法方法。

HttpResponse response = new BasicHttpResponse(HttpVersion.HTTP_1_1,

HttpStatus.SC_OK, "OK");

response.addHeader("Set-Cookie",

"c1=a; path=/; domain=localhost");

response.addHeader("Set-Cookie",

"c2=b; path=\"/\", c3=c; domain=\"localhost\"");

HeaderElementIterator it = new BasicHeaderElementIterator(

response.headerIterator("Set-Cookie"));

while (it.hasNext()) {

HeaderElement elem = it.nextElement();

System.out.println(elem.getName() + " = " + elem.getValue());

NameValuePair[] params = elem.getParameters();

for (int i = 0; i < params.length; i++) {

System.out.println(" " + params[i]);

}

}

輸出內(nèi)容為：

c1 = a

path=/

domain=localhost

c2 = b

path=/

c3 = c

domain=localhost

1.1.4 HTTP實體

HTTP報文可以攜帶和請求或響應相關(guān)的內(nèi)容實體。實體可以在一些請求和響應中找到，因為它們也是可選的。使用了實體的請求被稱為封閉實體請求。HTTP規(guī)范定義了兩種封閉實體的方法：POST和PUT。響應通常期望包含一個內(nèi)容實體。這個規(guī)則也有特例，比如HEAD方法的響應和204 No Content，304 Not Modified和205 Reset Content響應。

HttpClient根據(jù)其內(nèi)容出自何處區(qū)分三種類型的實體：

streamed流式：內(nèi)容從流中獲得，或者在運行中產(chǎn)生。特別是這種分類包含從HTTP響應中獲取的實體。流式實體是不可重復生成的。

self-contained自我包含式：內(nèi)容在內(nèi)存中或通過獨立的連接或其它實體中獲得。自我包含式的實體是可以重復生成的。這種類型的實體會經(jīng)常用于封閉HTTP請求的實體。

wrapping包裝式：內(nèi)容從另外一個實體中獲得。

當從一個HTTP響應中獲取流式內(nèi)容時，這個區(qū)別對于連接管理很重要。對于由應用程序創(chuàng)建而且只使用HttpClient發(fā)送的請求實體，流式和自我包含式的不同就不那么重要了。這種情況下，建議考慮如流式這種不能重復的實體，和可以重復的自我包含式實體。

1.1.4.1 重復實體

實體可以重復，意味著它的內(nèi)容可以被多次讀取。這就僅僅是自我包含式的實體了（像ByteArrayEntity或StringEntity）。

1.1.4.2 使用HTTP實體

因為一個實體既可以代表二進制內(nèi)容又可以代表字符內(nèi)容，它也支持字符編碼（支持后者也就是字符內(nèi)容）。

實體是當使用封閉內(nèi)容執(zhí)行請求，或當請求已經(jīng)成功執(zhí)行，或當響應體結(jié)果發(fā)功到客戶端時創(chuàng)建的。

要從實體中讀取內(nèi)容，可以通過HttpEntity#getContent()方法從輸入流中獲取，這會返回一個java.io.InputStream對象，或者提供一個輸出流到HttpEntity#writeTo(OutputStream)方法中，這會一次返回所有寫入到給定流中的內(nèi)容。

當實體通過一個收到的報文獲取時，HttpEntity#getContentType()方法和HttpEntity#getContentLength()方法可以用來讀取通用的元數(shù)據(jù)，如Content-Type和Content-Length頭部信息（如果它們是可用的）。因為頭部信息Content-Type可以包含對文本MIME類型的字符編碼，比如text/plain或text/html，HttpEntity#getContentEncoding()方法用來讀取這個信息。如果頭部信息不可用，那么就返回長度-1，而對于內(nèi)容類型返回NULL。如果頭部信息Content-Type是可用的，那么就會返回一個Header對象。

當為一個傳出報文創(chuàng)建實體時，這個元數(shù)據(jù)不得不通過實體創(chuàng)建器來提供。

StringEntity myEntity = new StringEntity("important message",

"UTF-8");

System.out.println(myEntity.getContentType());

System.out.println(myEntity.getContentLength());

System.out.println(EntityUtils.getContentCharSet(myEntity));

System.out.println(EntityUtils.toString(myEntity));

System.out.println(EntityUtils.toByteArray(myEntity).length);

輸出內(nèi)容為

Content-Type: text/plain; charset=UTF-8

17

UTF-8

important message

17

1.1.5 確保低級別資源釋放

當完成一個響應實體，那么保證所有實體內(nèi)容已經(jīng)被完全消耗是很重要的，所以連接可以安全的放回到連接池中，而且可以通過連接管理器對后續(xù)的請求重用連接。處理這個操作的最方便的方法是調(diào)用HttpEntity#consumeContent()方法來消耗流中的任意可用內(nèi)容。HttpClient探測到內(nèi)容流尾部已經(jīng)到達后，會立即會自動釋放低層連接，并放回到連接管理器。HttpEntity#consumeContent()方法調(diào)用多次也是安全的。

也可能會有特殊情況，當整個響應內(nèi)容的一小部分需要獲取，消耗剩余內(nèi)容而損失性能，還有重用連接的代價太高，則可以僅僅通過調(diào)用HttpUriRequest#abort()方法來中止請求。

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

InputStream instream = entity.getContent();

int byteOne = instream.read();

int byteTwo = instream.read();

// Do not need the rest

httpget.abort();

}

連接不會被重用，但是由它持有的所有級別的資源將會被正確釋放。

1.1.6 消耗實體內(nèi)容

推薦消耗實體內(nèi)容的方式是使用它的HttpEntity#getContent()或HttpEntity#writeTo(OutputStream)方法。HttpClient也自帶EntityUtils類，這會暴露出一些靜態(tài)方法，這些方法可以更加容易地從實體中讀取內(nèi)容或信息。代替直接讀取java.io.InputStream，也可以使用這個類中的方法以字符串/字節(jié)數(shù)組的形式獲取整個內(nèi)容體。然而，EntityUtils的使用是強烈不鼓勵的，除非響應實體源自可靠的HTTP服務器和已知的長度限制。

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

long len = entity.getContentLength();

if (len != -1 && len < 2048) {

System.out.println(EntityUtils.toString(entity));

} else {

// Stream content out

}

}

在一些情況下可能會不止一次的讀取實體。此時實體內(nèi)容必須以某種方式在內(nèi)存或磁盤上被緩沖起來。最簡單的方法是通過使用BufferedHttpEntity類來包裝源實體完成。這會引起源實體內(nèi)容被讀取到內(nèi)存的緩沖區(qū)中。在其它所有方式中，實體包裝器將會得到源實體。

HttpGet httpget = new HttpGet("http://localhost/");

HttpResponse response = httpclient.execute(httpget);

HttpEntity entity = response.getEntity();

if (entity != null) {

entity = new BufferedHttpEntity(entity);

}

1.1.7 生成實體內(nèi)容

HttpClient提供一些類，它們可以用于生成通過HTTP連接獲得內(nèi)容的有效輸出流。為了封閉實體從HTTP請求中獲得的輸出內(nèi)容，那些類的實例可以和封閉如POST和PUT請求的實體相關(guān)聯(lián)。HttpClient為很多公用的數(shù)據(jù)容器，比如字符串，字節(jié)數(shù)組，輸入流和文件提供了一些類：StringEntity，ByteArrayEntity，InputStreamEntity和FileEntity。

File file = new File("somefile.txt");

FileEntity entity = new FileEntity(file, "text/plain; charset=\"UTF-8\"");

HttpPost httppost = new HttpPost("http://localhost/action.do");

httppost.setEntity(entity);

請注意InputStreamEntity是不可重復的，因為它僅僅能從低層數(shù)據(jù)流中讀取一次內(nèi)容。通常來說，我們推薦實現(xiàn)一個定制的HttpEntity類，這是自我包含式的，用來代替使用通用的InputStreamEntity。FileEntity也是一個很好的起點。

1.1.7.1 動態(tài)內(nèi)容實體

通常來說，HTTP實體需要基于特定的執(zhí)行上下文來動態(tài)地生成。通過使用EntityTemplate實體類和ContentProducer接口，HttpClient提供了動態(tài)實體的支持。內(nèi)容生成器是按照需求生成它們內(nèi)容的對象，將它們寫入到一個輸出流中。它們是每次被請求時來生成內(nèi)容。所以用EntityTemplate創(chuàng)建的實體通常是自我包含而且可以重復的。

ContentProducer cp = new ContentProducer() {

public void writeTo(OutputStream outstream) throws IOException {

Writer writer = new OutputStreamWriter(outstream, "UTF-8");

writer.write("<response>");

writer.write(" <content>");

writer.write(" important stuff");

writer.write(" </content>");

writer.write("</response>");

writer.flush();

}

};

HttpEntity entity = new EntityTemplate(cp);

HttpPost httppost = new HttpPost("http://localhost/handler.do");

httppost.setEntity(entity);

1.1.7.2 HTML表單

許多應用程序需要頻繁模擬提交一個HTML表單的過程，比如，為了來記錄一個Web應用程序或提交輸出數(shù)據(jù)。HttpClient提供了特殊的實體類UrlEncodedFormEntity來這個滿足過程。

List<NameValuePair> formparams = new ArrayList<NameValuePair>();

formparams.add(new BasicNameValuePair("param1", "value1"));

formparams.add(new BasicNameValuePair("param2", "value2"));

UrlEncodedFormEntity entity = new UrlEncodedFormEntity(formparams, "UTF-8");

HttpPost httppost = new HttpPost("http://localhost/handler.do");

httppost.setEntity(entity);

UrlEncodedFormEntity實例將會使用URL編碼來編碼參數(shù)，生成如下的內(nèi)容：

param1=value1&param2=value2

1.1.7.3 內(nèi)容分塊

通常，我們推薦讓HttpClient選擇基于被傳遞的HTTP報文屬性的最適合的編碼轉(zhuǎn)換。這是可能的，但是，設置HttpEntity#setChunked()方法為true是通知HttpClient分塊編碼的首選。請注意HttpClient將會使用標識作為提示。當使用的HTTP協(xié)議版本，如HTTP/1.0版本，不支持分塊編碼時，這個值會被忽略。

StringEntity entity = new StringEntity("important message",

"text/plain; charset=\"UTF-8\"");

entity.setChunked(true);

HttpPost httppost = new HttpPost("http://localhost/acrtion.do");

httppost.setEntity(entity);

1.1.8 響應控制器

控制響應的最簡便和最方便的方式是使用ResponseHandler接口。這個放完完全減輕了用戶關(guān)于連接管理的擔心。當使用ResponseHandler時，HttpClient將會自動關(guān)注并保證釋放連接到連接管理器中去，而不管請求執(zhí)行是否成功或引發(fā)了異常。

HttpClient httpclient = new DefaultHttpClient();

HttpGet httpget = new HttpGet("http://localhost/");

ResponseHandler<byte[]> handler = new ResponseHandler<byte[]>() {

public byte[] handleResponse(

HttpResponse response) throws ClientProtocolException, IOException {

HttpEntity entity = response.getEntity();

if (entity != null) {

return EntityUtils.toByteArray(entity);

} else {

return null;

}

}

};

byte[] response = httpclient.execute(httpget, handler);

1.2 HTTP執(zhí)行的環(huán)境

最初，HTTP是被設計成無狀態(tài)的，面向請求-響應的協(xié)議。然而，真實的應用程序經(jīng)常需要通過一些邏輯相關(guān)的請求-響應交換來持久狀態(tài)信息。為了開啟應用程序來維持一個過程狀態(tài)，HttpClient允許HTTP請求在一個特定的執(zhí)行環(huán)境中來執(zhí)行，簡稱為HTTP上下文。如果相同的環(huán)境在連續(xù)請求之間重用，那么多種邏輯相關(guān)的請求可以參與到一個邏輯會話中。HTTP上下文功能和java.util.Map<String,Object>很相似。它僅僅是任意命名參數(shù)值的集合。應用程序可以在請求之前或在檢查上下文執(zhí)行完成之后來填充上下文屬性。

在HTTP請求執(zhí)行的這一過程中，HttpClient添加了下列屬性到執(zhí)行上下文中：

'http.connection'：HttpConnection實例代表了連接到目標服務器的真實連接。

'http.target_host'：HttpHost實例代表了連接目標。

'http.proxy_host'：如果使用了，HttpHost實例代表了代理連接。

'http.request'：HttpRequest實例代表了真實的HTTP請求。

'http.response'：HttpResponse實例代表了真實的HTTP響應。

'http.request_sent'：java.lang.Boolean對象代表了暗示真實請求是否被完全傳送到目標連接的標識。

比如，為了決定最終的重定向目標，在請求執(zhí)行之后，可以檢查http.target_host屬性的值：

DefaultHttpClient httpclient = new DefaultHttpClient();

HttpContext localContext = new BasicHttpContext();

HttpGet httpget = new HttpGet("http://www.google.com/");

HttpResponse response = httpclient.execute(httpget, localContext);

HttpHost target = (HttpHost) localContext.getAttribute(

ExecutionContext.HTTP_TARGET_HOST);

System.out.println("Final target: " + target);

HttpEntity entity = response.getEntity();

if (entity != null) {

entity.consumeContent();

}

輸出內(nèi)容為：

Final target: http://www.google.ch

1.3 異常處理

HttpClient能夠拋出兩種類型的異常：在I/O失敗時，如套接字連接超時或被重置的java.io.IOException異常，還有標志HTTP請求失敗的信號，如違反HTTP協(xié)議的HttpException異常。通常I/O錯誤被認為是非致命的和可以恢復的，而HTTP協(xié)議錯誤則被認為是致命的而且是不能自動恢復的。

1.3.1 HTTP運輸安全

要理解HTTP協(xié)議并不是對所有類型的應用程序都適合的，這一點很重要。HTTP是一個簡單的面向請求/響應的協(xié)議，最初被設計用來支持取回靜態(tài)或動態(tài)生成的內(nèi)容。它從未向支持事務性操作方向發(fā)展。比如，如果成功收到和處理請求，HTTP服務器將會考慮它的其中一部分是否完成，生成一個響應并發(fā)送一個狀態(tài)碼到客戶端。如果客戶端因為讀取超時，請求取消或系統(tǒng)崩潰導致接收響應實體失敗時，服務器不會試圖回滾事務。如果客戶端決定重新這個請求，那么服務器將不可避免地不止一次執(zhí)行這個相同的事務。在一些情況下，這會導致應用數(shù)據(jù)損壞或者不一致的應用程序狀態(tài)。

盡管HTTP從來都沒有被設計來支持事務性處理，但它也能被用作于一個傳輸協(xié)議對關(guān)鍵的任務應用提供被滿足的確定狀態(tài)。要保證HTTP傳輸層的安全，系統(tǒng)必須保證HTTP方法在應用層的冪等性。

1.3.2 冪等的方法

HTTP/1.1 明確地定義了冪等的方法，描述如下

[方法也可以有“冪等”屬性在那些（除了錯誤或過期問題）N的副作用>0的相同請求和獨立的請求是相同的]

換句話說，應用程序應該保證準備著來處理多個相同方法執(zhí)行的實現(xiàn)。這是可以達到的，比如，通過提供一個獨立的事務ID和其它避免執(zhí)行相同邏輯操作的方法。

請注意這個問題對于HttpClient是不具體的。基于應用的瀏覽器特別受和非冪等的HTTP方法相關(guān)的相同問題的限制。

HttpClient假設沒有實體包含方法，比如GET和HEAD是冪等的，而實體包含方法，比如POST和PUT則不是。

1.3.3 異常自動恢復

默認情況下，HttpClient會試圖自動從I/O異常中恢復。默認的自動恢復機制是受很少一部分已知的異常是安全的這個限制。

HttpClient不會從任意邏輯或HTTP協(xié)議錯誤（那些是從HttpException類中派生出的）中恢復的。

HttpClient將會自動重新執(zhí)行那么假設是冪等的方法。

HttpClient將會自動重新執(zhí)行那些由于運輸異常失敗，而HTTP請求仍然被傳送到目標服務器（也就是請求沒有完全被送到服務器）失敗的方法。

HttpClient將會自動重新執(zhí)行那些已經(jīng)完全被送到服務器，但是服務器使用HTTP狀態(tài)碼（服務器僅僅丟掉連接而不會發(fā)回任何東西）響應時失敗的方法。在這種情況下，假設請求沒有被服務器處理，而應用程序的狀態(tài)也沒有改變。如果這個假設可能對于你應用程序的目標Web服務器來說不正確，那么就強烈建議提供一個自定義的異常處理器。

1.3.4 請求重試處理

為了開啟自定義異常恢復機制，應該提供一個HttpRequestRetryHandler接口的實現(xiàn)。

DefaultHttpClient httpclient = new DefaultHttpClient();

HttpRequestRetryHandler myRetryHandler = new HttpRequestRetryHandler() {

public boolean retryRequest(IOException exception,

int executionCount,HttpContext context) {

if (executionCount >= 5) {

// 如果超過最大重試次數(shù)，那么就不要繼續(xù)了

return false;

}

if (exception instanceof NoHttpResponseException) {

// 如果服務器丟掉了連接，那么就重試

return true;

}

if (exception instanceof SSLHandshakeException) {

// 不要重試SSL握手異常

return false;

}

HttpRequest request = (HttpRequest) context.getAttribute(

ExecutionContext.HTTP_REQUEST);

boolean idempotent = !(request instanceof HttpEntityEnclosingRequest);

if (idempotent) {

// 如果請求被認為是冪等的，那么就重試

return true;

}

return false;

}

};

httpclient.setHttpRequestRetryHandler(myRetryHandler);

1.4 中止請求

在一些情況下，由于目標服務器的高負載或客戶端有很多活動的請求，那么HTTP請求執(zhí)行會在預期的時間框內(nèi)而失敗。這時，就可能不得不過早地中止請求，解除封鎖在I/O執(zhí)行中的線程封鎖。被HttpClient執(zhí)行的HTTP請求可以在執(zhí)行的任意階段通過調(diào)用HttpUriRequest#abort()方法而中止。這個方法是線程安全的，而且可以從任意線程中調(diào)用。當一個HTTP請求被中止時，它的執(zhí)行線程就封鎖在I/O操作中了，而且保證通過拋出InterruptedIOException異常來解鎖。

1.5 HTTP協(xié)議攔截器

HTTP協(xié)議攔截器是一個實現(xiàn)了特定HTPP協(xié)議方面的慣例。通常協(xié)議攔截器希望作用于一個特定頭部信息上，或者一族收到報文的相關(guān)頭部信息，或使用一個特定的頭部或一族相關(guān)的頭部信息填充發(fā)出的報文。協(xié)議攔截器也可以操縱包含在報文中的內(nèi)容實體，透明的內(nèi)容壓縮/解壓就是一個很好的示例。通常情況下這是由包裝器實體類使用了“裝飾者”模式來裝飾原始的實體完成的。一些協(xié)議攔截器可以從一個邏輯單元中來結(jié)合。

協(xié)議攔截器也可以通過共享信息來共同合作-比如處理狀態(tài)-通過HTTP執(zhí)行上下文。協(xié)議攔截器可以使用HTTP內(nèi)容來為一個或多個連續(xù)的請求存儲一個處理狀態(tài)。

通常攔截器執(zhí)行的順序不應該和它們基于的特定執(zhí)行上下文狀態(tài)有關(guān)。如果協(xié)議攔截器有相互依存關(guān)系，那么它們必須按特定順序來執(zhí)行，正如它們希望執(zhí)行的順序一樣，它們應該在相同的序列中被加到協(xié)議處理器。

協(xié)議攔截器必須實現(xiàn)為線程安全的。和Servlet相似，協(xié)議攔截器不應該使用實例變量，除非訪問的那些變量是同步的。

這個示例給出了本地內(nèi)容在連續(xù)的請求中怎么被用于持久一個處理狀態(tài)的：

DefaultHttpClient httpclient = new DefaultHttpClient();

HttpContext localContext = new BasicHttpContext();

AtomicInteger count = new AtomicInteger(1);

localContext.setAttribute("count", count);

httpclient.addRequestInterceptor(new HttpRequestInterceptor() {

public void process(final HttpRequest request,

final HttpContext context) throws HttpException, IOException {

AtomicInteger count = (AtomicInteger) context.getAttribute("count");

request.addHeader("Count", Integer.toString(count.getAndIncrement()));

}

});

HttpGet httpget = new HttpGet("http://localhost/");

for (int i = 0; i < 10; i++) {

HttpResponse response = httpclient.execute(httpget, localContext);

HttpEntity entity = response.getEntity();

if (entity != null) {

entity.consumeContent();

}

}

1.6 HTTP參數(shù)

HttpParams接口代表了定義組件運行時行為的一個不變的值的集合。很多情況下，HttpParams和HttpContext相似。二者之間的主要區(qū)別是它們在運行時使用的不同。這兩個接口表示了對象的集合，它們被視作為訪問對象值的鍵的Map，但是服務于不同的目的：

HttpParams旨在包含簡單對象：整型，浮點型，字符串，集合，還有運行時不變的對象。

HttpParams希望被用在“一次寫入-多處準備”模式下。HttpContext旨在包含很可能在HTTP報文處理這一過程中發(fā)生改變的復雜對象

HttpParams的目標是定義其它組件的行為。通常每一個復雜的組件都有它自己的HttpParams對象。HttpContext的目標是來表示一個HTTP處理的執(zhí)行狀態(tài)。通常相同的執(zhí)行上下文在很多合作的對象中共享。

1.6.1 參數(shù)層次

在HTTP請求執(zhí)行過程中，HttpRequest對象的HttpParams是和用于執(zhí)行請求的HttpClient實例的HttpParams聯(lián)系在一起的。這使得設置在HTTP請求級別的參數(shù)優(yōu)先于設置在HTTP客戶端級別的HttpParams。推薦的做法是設置普通參數(shù)對所有的在HTTP客戶端級別的HTTP請求共享，而且可以選擇性重寫具體在HTTP請求級別的參數(shù)。

DefaultHttpClient httpclient = new DefaultHttpClient();

httpclient.getParams().setParameter(CoreProtocolPNames.PROTOCOL_VERSION,HttpVersion.HTTP_1_0);

httpclient.getParams().setParameter(CoreProtocolPNames.HTTP_CONTENT_CHARSET,"UTF-8");

HttpGet httpget = new HttpGet("http://www.google.com/");

httpget.getParams().setParameter(CoreProtocolPNames.PROTOCOL_VERSION,HttpVersion.HTTP_1_1);

httpget.getParams().setParameter(CoreProtocolPNames.USE_EXPECT_CONTINUE,Boolean.FALSE);

httpclient.addRequestInterceptor(new HttpRequestInterceptor() {

public void process(final HttpRequest request,

final HttpContext context) throws HttpException, IOException {

System.out.println(request.getParams().getParameter(

CoreProtocolPNames.PROTOCOL_VERSION));

System.out.println(request.getParams().getParameter(

CoreProtocolPNames.HTTP_CONTENT_CHARSET));

System.out.println(request.getParams().getParameter(

CoreProtocolPNames.USE_EXPECT_CONTINUE));

System.out.println(request.getParams().getParameter(

CoreProtocolPNames.STRICT_TRANSFER_ENCODING));

}

});

輸出內(nèi)容為：

HTTP/1.1

UTF-8

false

null

1.6.2 HTTP參數(shù)bean

HttpParams接口允許在處理組件的配置上很大的靈活性。很重要的是，新的參數(shù)可以被引入而不會影響老版本的二進制兼容性。然而，和常規(guī)的Java bean相比，HttpParams也有一個缺點：HttpParams不能使用DI框架來組合。為了緩解這個限制，HttpClient包含了一些bean類，它們可以用來按順序使用標準的Java eban慣例初始化HttpParams對象。

HttpParams params = new BasicHttpParams();

HttpProtocolParamBean paramsBean = new HttpProtocolParamBean(params);

paramsBean.setVersion(HttpVersion.HTTP_1_1);

paramsBean.setContentCharset("UTF-8");

paramsBean.setUseExpectContinue(true);

System.out.println(params.getParameter(

CoreProtocolPNames.PROTOCOL_VERSION));

System.out.println(params.getParameter(

CoreProtocolPNames.HTTP_CONTENT_CHARSET));

System.out.println(params.getParameter(

CoreProtocolPNames.USE_EXPECT_CONTINUE));

System.out.println(params.getParameter(

CoreProtocolPNames.USER_AGENT));

輸出內(nèi)容為：

HTTP/1.1

UTF-8

false

null

1.7 HTTP請求執(zhí)行參數(shù)

這些參數(shù)會影響到請求執(zhí)行的過程：

'http.protocol.version'：如果沒有在請求對象中設置明確的版本信息，它就定義了使用的HTTP協(xié)議版本。這個參數(shù)期望得到一個ProtocolVersion類型的值。如果這個參數(shù)沒有被設置，那么就使用HTTP/1.1。

'http.protocol.element-charset'：定義了編碼HTTP協(xié)議元素的字符集。這個參數(shù)期望得到一個java.lang.String類型的值。如果這個參數(shù)沒有被設置，那么就使用US-ASCII。

'http.protocol.eontent-charset'：定義了為每個內(nèi)容主體編碼的默認字符集。這個參數(shù)期望得到一個java.lang.String類型的值。如果這個參數(shù)沒有被設置，那么就使用ISO-8859-1。

'http.useragent'：定義了頭部信息User-Agent的內(nèi)容。這個參數(shù)期望得到一個java.lang.String類型的值。如果這個參數(shù)沒有被設置，那么HttpClient將會為它自動生成一個值。

'http.protocol.strict-transfer-encoding'：定義了響應頭部信息中是否含有一個非法的Transfer-Encoding，都要拒絕掉。

'http.protocol.expect-continue'：為包含方法的實體激活Expect: 100-Continue握手。Expect: 100-Continue握手的目的是允許客戶端使用請求體發(fā)送一個請求信息來決定源服務器是否希望在客戶端發(fā)送請求體之前得到這個請求（基于請求頭部信息）。Expect: 100-Continue握手的使用可以對需要目標服務器認證的包含請求的實體（比如POST和PUT）導致明顯的性能改善。Expect: 100-Continue握手應該謹慎使用，因為它和HTTP服務器，不支持HTTP/1.1協(xié)議的代理使用會引起問題。這個參數(shù)期望得到一個java.lang.Boolean類型的值。如果這個參數(shù)沒有被設置，那么HttpClient將會試圖使用握手。

'http.protocol.wait-for-continue'：定義了客戶端應該等待100-Continue響應最大的毫秒級時間間隔。這個參數(shù)期望得到一個java.lang.Integer類型的值。如果這個參數(shù)沒有被設置，那么HttpClient將會在恢復請求體傳輸之前為確認等待3秒。