運用Apache HttpClient實作Get與Post動作

運用Apache HttpClient實作Get與Post動作 <script type="text/javascript"> </script>

Published by Sam Wang under Java on 上午 9:58 HttpClient 簡介 :

HTTP 協定是現在 Internet 上使用得最多、最重要的協定，越來越多的 Java 應用程序需要直接通過 HTTP 協定來訪問網路資源。 雖然在 JDK 的 java.net 包中已經提供了訪問 HTTP 協定的基本功能，但是對於大部分應用程序來說，JDK 類別庫本身提供的功能還不夠豐富和靈活。 HttpClient 是 Apache Jakarta Common 下的子項目，用來提供高效能、最新、功能豐富的支持 HTTP 協定的client端開發工具，並且它支持 HTTP 協定最新的版本和建議。 HttpClient 已經應用在很多的項目中，比如 Apache Jakarta 上很著名的另外兩個開源項目 Cactus 和 HTMLUnit 都使用了 HttpClient，更多使用 HttpClient 的應用可以參見http://wiki.apache.org/jakarta-httpclient/HttpClientPowered 。 HttpClient 項目非常活躍，使用的人還是非常多的。目前 HttpClient 正式版本是 3.1。

HttpClient 功能介紹

以下列出的是 HttpClient 提供的主要的功能，要知道更多詳細的功能可以參見 HttpClient 的主頁。

1. 實現了所有 HTTP 的方法（GET,POST,PUT,HEAD 等）

2. 支持自動轉向

3. 支持 HTTPS 協議

4. 支持代理服務器

 

下面將逐一介紹怎樣使用這些功能。首先，我們必須安裝好 HttpClient。

HttpClient 可以在http://hc.apache.org/downloads.cgi 下載

HttpClient用到了logging，你可以從這個地址http://commons.apache.org/downloads/download_logging.cgi 下載到 common-logging，從下載後的壓縮包中取出 commons-logging.jar 加到 CLASSPATH 中

HttpClient用到了codec，你可以從這個地址http://commons.apache.org/downloads/download_codec.cgi 下載到最新的 common-codec，從下載後的壓縮包中取出 commons-codec-1.x.jar 加到 CLASSPATH 中

 

Get Method:

 

import


 java


.


io


.


IOException


;










import


 org


.


apache


.


commons


.


httpclient


.


*


;






import


 org


.


apache


.


commons


.


httpclient


.


methods


.


*


;






import


 org


.


apache


.


commons


.


httpclient


.


params


.


HttpMethodParams


;










public


 class


 HttpGet



{



    private


 static


 String


 url = "http://www.apache.org/"


; // 目標網址.










    public


 static


 void


 main(String


[] args)



    {



        // 建立HttpClient實體.






        HttpClient client = new


 HttpClient();







        // 建立GetMethod實體, 並指派網址, GetMethod會自動處理該網轉址動作, 如果不想自動轉址請呼叫 setFollowRedirects(false).






        GetMethod method = new


 GetMethod(url);







        // 這段代碼用意為連接不到時自動重新��試三次.






        method.getParams().setParameter(HttpMethodParams.RETRY_HANDLER, new


 DefaultHttpMethodRetryHandler(3, false


));







        try


 {



            // 返回狀態值.






            int


 statusCode = client.executeMethod(method);



            if


 (statusCode != HttpStatus.SC_OK) {



                System


.err.println("Method failed: "


 + method.getStatusLine());



            }







            // 取得回傳資訊.






            byte


[] responseBody = method.getResponseBody();



            System


.out.println(new


 String


(responseBody));







        } catch


 (HttpException httpexc) {



            System


.err.println("Fatal protocol violation: "


 + httpexc.getMessage());



            httpexc.printStackTrace();



        } catch


 (IOException


 ioexc) {



            System


.err.println("Fatal transport error: "


 + ioexc.getMessage());



            ioexc.printStackTrace();



        } finally


 {







            // ** 無論如何都必須釋放連接.






            method.releaseConnection();



        }



    }



}

由於是執行在網路上的程序，運行executeMethod方法時，需要處理兩個異常，分別是HttpException和IOException。 第一種異常的原因主要可能是在建立GetMethod的時候輸入網址錯誤，比如不小心將"http"寫成"htp"，或者遠端返回的資訊內容不正常等，並且該異常發生是不可恢復的。

第二種異常一般是由於網路原因引起的異常，對於這種異常 （IOException），HttpClient會根據你指定的恢復策略自動試著重新執行executeMethod方法。

HttpClient的恢復策略可以自定義（通過實現接口HttpMethodRetryHandler來實現）。通過httpClient的方法 setParameter設置你實現的恢復策略，這裡使用的是系統提供的預設恢復方式，該方式在碰到第二類異常的時候將自動重試3次。

executeMethod返回值是一個整數，表示了執行該方法後服務器返回的狀態碼，該狀態碼能表示出該方法執行是否成功、需要認證或者頁面轉址（預設狀態下GetMethod是自動處理轉址）等。

POST Method:

 

import


 java


.


io


.


IOException


;






import


 org


.


apache


.


commons


.


httpclient


.


*


;






import


 org


.


apache


.


commons


.


httpclient


.


methods


.


*


;










public


 class


 HttpPost



{



    private


 static


 String


 url = "http://www.apache.org/"


; // 目標網址.










    public


 static


 void


 main(String


[] args)



    {



        // 建立HttpClient實體.






        HttpClient client = new


 HttpClient();







        // 建立PostMethod實體, 並指派網址






        PostMethod post = new


 PostMethod(url);







        // 建立NameValuePair陣列�儲欲傳送的資料, 對照為 (名稱, 內容)






        NameValuePair[] data = { new


 NameValuePair("Name"


, "Sam Wang"


), new


 NameValuePair("Passwd"


, "Test1234"


) };







        // 將NameValuePair陣列設置到請求內容中






        post.setRequestBody(data);







        try


 {



            // 返回狀態值.






            int


 statusCode = client.executeMethod(post);



            if


 (statusCode != HttpStatus.SC_OK) {



                System


.err.println("Method failed: "


 + post.getStatusLine());



            }







            // 取得回傳資訊.






            byte


[] responseBody = post.getResponseBody();



            System


.out.println(new


 String


(responseBody));







        } catch


 (HttpException httpexc) {



            System


.err.println("Fatal protocol violation: "


 + httpexc.getMessage());



            httpexc.printStackTrace();



        } catch


 (IOException


 ioexc) {



            System


.err.println("Fatal transport error: "


 + ioexc.getMessage());



            ioexc.printStackTrace();



        } finally


 {







            // ** 無論如何都必須釋放連接.






            post.releaseConnection();



        }



    }



}

PostMethod運作重點大致上和GetMethod相同, 唯一不同的是傳送變數必須用NameValuePair[]陣列儲存, 再設置到requestBody中。

 

 

 

HttpClient 3_configuration

想多了解的人, 當然, 自己多看看 Java Doc 囉.
以下列出幾個常用的.

1. Add Headers

    GetMethod method = new GetMethod();


    method.addRequestHeader("headerName", "headerValue");


    // or 


    method.addRequestHeader(new Header("headerName", "headerValue"));

2. 設定 timeout 時間

    HttpMethodParams params = new HttpMethodParams();


    params.setSoTimeout(3000);





    // or 


    method.getParams().setSoTimeout(3000);

3. 多執行序下使用 HttpClient

    HttpClient client = new HttpClient(new MultiThreadedHttpConnectionManager());


    // or 


    MultiThreadedHttpConnectionManager config = new MultiThreadedHttpConnectionManager());


    // set other config


    HttpClient client = new HttpClient();


    client.setHttpConnectionManager(config);

補充: 如果您的程式會一直使用 httpclient 發送 request, 建意將 httpclient 宣告成只有一份(ex: static or singleton), 減少不必要要的 port 被開啟, 又要等待 system close.

4. 失敗時, retry 3 次

    // set per default


    client.getParams().setParameter(HttpMethodParams.RETRY_HANDLER, 


new DefaultHttpMethodRetryHandler()); 


    // or 


    DefaultMethodRetryHandler retryhandler = new DefaultMethodRetryHandler(10, true);


    client.getParams().setParameter(HttpMethodParams.RETRY_HANDLER, retryhandler);





    // 如果想了解哪些情況下, 才會 retry, 請參考官網 http://hc.apache.org/httpclient-3.x/tutorial.html




  

目前這些囉, 有想到什麼常用的到時候再補充唷.