[轉載] Apache HttpClient 4.x 使用 GET, POST 範例

先前我曾經發了一篇介紹如何抓取網頁的教學：
利用Jakarta.Commons.HttpClient抓取網頁、網站(Parser)，不過當時用的是 HttpClient 3.1。
經過時間的演進 Apache 已經在 14 August 2009 發佈：HttpComponents HttpClient 4.0 (GA)。
由 3.1 到 4.0 因為底層幾乎全部重新改寫，所以也使有些舊的程式無法使用。
這篇就是我自己寫的一個簡單範例。

在看範例之前先把一些重要連結整理給大家：
想知道這次到底更動了哪些東西可以看：Apache HttpClient 首頁
官方的 Tutorial 在：Apache HttpClient Tutorial
而 API DOC、說明文件則在：Apache HttpClient apidocs

相關的程式碼、jar 檔在：HttpComponents HttpClient 4.0 (GA)
注意，在寫程式前必需先將四個 jar 檔正確匯入，最後兩個(*)是選用，
請參考：http://hc.apache.org/httpcomponents-client-ga/quickstart.html：

• commons-logging-x.x.x.jar
• commons-codec-x.x.x.jar
• httpcore-x.x.x.jar
• httpclient-x.x.x.jar
• apache-mime4j-x.x.x.jar (*)
• httpmime-x.x.x.jar (*)

說了這麼多，以下是程式的範例，
第一個是傳回在 google 查詢 httpclient 的結果。
第二則是傳回台大圖書館查詢 Head First Java 的結果。

 package demo.httpclient;
 
 import java.io.IOException;
 import java.util.ArrayList;
 
 import org.apache.commons.httpclient.HttpStatus;
 import org.apache.http.HttpResponse;
 import org.apache.http.NameValuePair;
 import org.apache.http.client.methods.HttpGet;
 import org.apache.http.client.methods.HttpPost;
 import org.apache.http.client.utils.URLEncodedUtils;
 import org.apache.http.entity.StringEntity;
 import org.apache.http.impl.client.DefaultHttpClient;
 import org.apache.http.message.BasicNameValuePair;
 import org.apache.http.util.EntityUtils;
 
 /**
 * Apache HttpClient 4.x 使用 GET, POST 查詢網頁的範例
 *
 * @author werdna at http://werdna1222coldcodes.blogspot.com/
 */ 
 public class HttpClientDemo extends DefaultHttpClient {
 
     public static void main(String[] args) throws IOException {
 
         DefaultHttpClient demo = new DefaultHttpClient();
         demo.getParams().setParameter("http.protocol.content-charset", "UTF-8");
 
         // Get Request Example，取得 google 查詢 httpclient 的結果
         HttpGet httpGet = new HttpGet("http://www.google.com.tw/search?q=httpclinet");
         HttpResponse response = demo.execute(httpGet);
         String responseString = EntityUtils.toString(response.getEntity());
         if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
             // 如果回傳是 200 OK 的話才輸出
             System.out.println(responseString);
         } else {
             System.out.println(response.getStatusLine());
         }
 
         // Post Request Example，查詢台大圖書館書籍
         ArrayList<NameValuePair> pairList = new ArrayList<NameValuePair>();
         pairList.add(new BasicNameValuePair("searchtype", "t"));
         pairList.add(new BasicNameValuePair("searchscope", "keyword"));
         pairList.add(new BasicNameValuePair("searcharg", "Head First Java"));
         pairList.add(new BasicNameValuePair("SORT", "D"));
 
         HttpPost httpPost = new HttpPost("http://tulips.ntu.edu.tw:1081/search*cht/a?");
         StringEntity entity = new StringEntity(URLEncodedUtils.format(pairList, "UTF-8"));
         httpPost.setEntity(entity);
         response = demo.execute(httpPost);
         responseString = EntityUtils.toString(response.getEntity());
         if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
             // 如果回傳是 200 OK 的話才輸出
             System.out.println(responseString);
         } else {
             System.out.println(response.getStatusLine());
         }
     }
 }

更多的程式範例可以參考其教學： 
HttpClient 4 HTTP request 
HttpClient 4 使用POST方式提交普通表單數據的例子

關鍵字：Apache、HttpClient、4、教學、示範、範例、設定
參考資料：

1. Apache HttpClient 首頁
2. HttpComponents HttpClient 4.0 (GA)
3. Apache HttpClient Tutorial
4. Apache HttpClient apidocs
5. HttpClient 4 HTTP request
6. HttpClient 4 使用POST方式提交普通表單數據的例子