HttpClient是一個實現了http協議的開源Java客戶端工具庫，可以通過程式傳送http請求。

1.1.HttpClient傳送請求和接收響應

1.1.1.程式碼示例

以Get請求為例，以下程式碼獲得google主頁內容並將返回結果打印出來。

public final static void main(String[] args) throws Exception {

HttpClient httpclient = new DefaultHttpClient();

try {

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

com/");

System.out.println("executing request " + httpget.getURI());

// 建立response處理器

ResponseHandler<String> responseHandler = new BasicResponseHandler();

String responseBody = httpclient.execute(httpget, responseHandler);

System.out.println("----------------------------------------");

System.out.println(responseBody);

System.out.println("----------------------------------------");

} finally {

//HttpClient不再使用時，關閉連線管理器以保證所有資源的釋放

httpclient.getConnectionManager().shutdown();

}

}

1.1.2.時序圖

httpClient執行一次請求，即執行一次httpclient.execute()方法，時序圖如下：

 

1.1.3.

時序圖說明

1.1.3.1.時序圖編號說明

²1.1、1.2、1.3等均為操作1的子操作，即：操作1 execute()中又分別呼叫了操作1.1 createClientConnectionManager()、操作1.2 createClientRequestDirector()以及操作1.3 requestDirector 物件的execute()方法等，以此類推。

²按時間先後順序分別編號為1,2,3等，以此類推。

1.1.3.2.主要類說明

 

²對於圖中各物件，httpClient jar包中均提供對應的介面及相應的實現類。

²圖中直接與伺服器進行socket通訊的是最右端介面OperatedClientConnection某一實現類的物件，圖中從右到左進行了層層的封裝，最終開發人員直接使用的是介面HttpClient某一實現類的物件進行請求的傳送和響應的接收（如2.1.1程式碼示例）。

²時序圖中各物件所在類關係如下圖類圖所示（僅列出圖中所出現的各個類及方法，引數多的方法省略部分引數，其他類屬性和操作請參照原始碼）：

1.1.3.2.1.介面OperatedClientConnection

²該介面對應一個http連線，與伺服器端建立socket連線進行通訊。

1.1.3.2.2.介面ManagedClientConnection

²該介面對一個http連線OperatedClientConnection進行封裝，ManagedClientConnection維持一個PoolEntry<HttpRoute, OperatedClientConnection>路由和連線的對應。提供方法獲得對應連線管理器，對http連線的各類方法，如建立連線，獲得相應，關閉連線等進行封裝。

1.1.3.2.3.介面RequestDirector

²RequestDirector為訊息的傳送執行者，該介面負責訊息路由的選擇和可能的重定向，訊息的鑑權，連線的分配回收（呼叫ClientConnectionManager相關方法），建立，關閉等並控制連線的保持。

²連線是否保持以及保持時間預設原則如下：

n連線是否保持：客戶端如果希望保持長連線，應該在發起請求時告訴伺服器希望伺服器保持長連線（http 1.0設定connection欄位為keep-alive，http 1.1欄位預設保持）。根據伺服器的響應來確定是否保持長連線，判斷原則如下：

u檢查返回response報文頭的Transfer-Encoding欄位，若該欄位值存在且不為chunked，則連線不保持，直接關閉。其他情況進入下一步。

u檢查返回的response報文頭的Content-Length欄位，若該欄位值為空或者格式不正確（多個長度，值不是整數），則連線不保持，直接關閉。其他情況進入下一步

u檢查返回的response報文頭的connection欄位（若該欄位不存在，則為Proxy-Connection欄位）值

l如果這倆欄位都不存在，則http 1.1版本預設為保持，將連線標記為保持， 1.0版本預設為連線不保持，直接關閉。

l如果欄位存在，若欄位值為close 則連線不保持，直接關閉；若欄位值為keep-alive則連線標記為保持。

n連線保持時間：連線交換至連線管理時，若連線標記為保持，則將由連線管理器保持一段時間；若連線沒有標記為保持，則直接從連線池中刪除並關閉entry。連線保持時，保持時間規則如下：

u保持時間計時開始時間為連線交換至連線池的時間。

u保持時長計算規則為：獲取keep-alive欄位中timeout屬性的值，

l若該欄位存在，則保持時間為 timeout屬性值*1000，單位毫秒。

l若該欄位不存在，則連線保持時間設定為-1，表示為無窮。

n響應頭日誌示例：

17:59:42.051 [main] DEBUG org.apache.http.headers - << Keep-Alive: timeout=5, max=100

17:59:42.051 [main] DEBUG org.apache.http.headers - << Connection: Keep-Alive

17:59:42.051 [main] DEBUG org.apache.http.headers - << Content-Type: text/html; charset=utf-8

17:59:42.062 [main] DEBUG c.ebupt.omp.sop.srmms.SopHttpClient - Connection can be kept alive for 5000 MILLISECONDS

n若需要修改連線的保持及重用預設原則，則需編寫子類繼承自AbstractHttpClient，分別覆蓋其createConnectionReuseStrategy() 和createConnectionKeepAliveStrategy() 方法。

1.1.3.2.4.介面ClientConnectionManager

²ClientConnectionManager為連線池管理器，是執行緒安全的。Jar包中提供的具體實現類有BasicClientConnectionManager和PoolingClientConnectionManager。其中BasicClientConnectionManager只管理一個連線。PoolingClientConnectionManager管理連線池。

²若有特殊需要，開發人員可自行編寫連線管理器實現該介面。

²連線管理器自動管理連線的分配以及回收工作，並支援連線保持以及重用。連線保持以及重用由RequestDirector進行控制。

1.1.3.2.5.介面HttpClient

²介面HttpClient為開發人員直接使用的傳送請求和接收響應的介面，是執行緒安全的。jar包中提供的實現類有：AbstractHttpClient, DefaultHttpClient, AutoRetryHttpClient, ContentEncodingHttpClient, DecompressingHttpClient, SystemDefaultHttpClient。其中其他所有類都繼承自抽象類AbStractHttpClient，該類使用了門面模式，對http協議的處理進行了預設的封裝,包括預設連線管理器，預設訊息頭，預設訊息傳送等，開發人員可以覆蓋其中的方法更改其預設設定。

²AbstractHttpClient預設設定連線管理器為BasicClientConnectionManager。若要修改連線管理器，則應該採用以下方式之一：

n初始化時，傳入連線池，例如：

ClientConnectionManager connManager= new PoolingClientConnectionManager();

HttpClient httpclient = new DefaultHttpClient(connManager);

n編寫httpClient介面的實現類，繼承自AbstractHttpClient並覆蓋其createClientConnectionManager()方法，在方法中建立自己的連線管理器。

1.1.3.3.方法說明

²createClientConnectionManager()，建立連線池，該方法為protected。子類可覆蓋修改預設連線池。

²createClientRequestDirector()，建立請求執行者，該方法為protected。子類可覆蓋但一般不需要。

²httpClient中呼叫1.2方法所建立的請求執行者requestDirector的execute()方法。該方法中依次呼叫如下方法：

n1.3.1呼叫連線管理器的requestConnection(route, userToken)方法，該方法呼叫連線池httpConnPool的lease方法，建立一個Future<HttpPoolEntry>。Futrue用法參見Java標準API。返回clientConnectionRequest。

n1.3.2.呼叫clientConnectionRequest的getConnection(timeout, TimeUnit.MILLISECONDS)方法，該方法負責將連線池中可用連線分配給當前請求，具體如下：

u建立clientConnectionOperator。

u執行1.3.1中建立的Future的任務，該任務獲得當前可用的poolEntry<router，OperatedClientConnection>並封裝成managedClientConnectionImpl返回。

n1.3.3. 呼叫 tryConnect(roureq, context)方法，該方法最終呼叫OperatedClientConnection的openning方法，與伺服器建立socket連線。

n1.3.4. 呼叫 tryExecute(roureq, context)方法，該方法最終呼叫OperatedClientConnection的receiveResponseHeader（）和receiveResponseEntity（）獲得伺服器響應。

n1.3.5 判斷連線是否保持用來重用，若保持，則設定保持時間，並將連線標記為可重用不保持則呼叫managedClientConnectionImpl的close方法關閉連線，該方法最終呼叫OperatedClientConnection的close()方法關閉連線。

²最終respose返回至httpClient。

²傳送請求的執行緒需處理當前連線，若已被標記為重用，則交還至連線池管理器；否則，關閉當前連線。（使用響應處理器ResponseHanler）。本次請求結束。

1.2.httpClient連線池

若連線管理器配置為PoolingClientConnectionManager，則httpClient將使用連線池來管理連線的分配，回收等操作。

1.2.1.連線池結構

連線池結構圖如下，其中：

相關推薦