http://tomfish88.iteye.com/category/138221?show_full=true

----------------

HttpClient程序包是一個實現了 HTTP 協議的客戶端編程工具包，要想熟練的掌握它，必須熟悉 HTTP協議。一個最簡單的調用如下：

import java.io.IOException; 
import org.apache.http.HttpResponse; 
import org.apache.http.client.ClientProtocolException; 
 
import org.apache.http.client.HttpClient; 
import org.apache.http.client.methods.HttpGet; 
import org.apache.http.client.methods.HttpUriRequest; 
import org.apache.http.impl.client.DefaultHttpClient; 

public class Test { 
    public static void main(String[] args) { 

       // 核心應用類 
       HttpClient httpClient = new
 
 DefaultHttpClient(); 

        // HTTP請求 
        HttpUriRequest request = 
                new HttpGet("http://localhost/index.html"); 

        // 打印請求信息 
        System.out.println(request.getRequestLine()); 
        try { 
            // 發送請求，返回響應 
            HttpResponse response = httpClient.execute(request); 

            
 
// 打印響應信息 
            System.out.println(response.getStatusLine()); 
        } catch (ClientProtocolException e) { 
            // 協議錯誤 
            e.printStackTrace(); 
        } catch (IOException e) { 
            // 網絡異常 
            e.printStackTrace(); 
        } 
    } 
} 

如果HTTP服務器正常並且存在相應的服務，則上例會打印出兩行結果：

GET http://localhost/index.html HTTP/1.1
HTTP/1.1 200 OK

核心對象httpClient的調用非常直觀，其execute方法傳入一個request對象，返回一個response對象。使用 httpClient發出HTTP請求時，系統可能拋出兩種異常，分別是ClientProtocolException和IOException。第一種異常的發生通常是協議錯誤導致，如在構造HttpGet對象時傳入的協議不對（例如不小心將”http”寫成”htp”），或者服務器端返回的內容不符合HTTP協議要求等；第二種異常一般是由於網絡原因引起的異常，如HTTP服務器未啟動等。
從實際應用的角度看，HTTP協議由兩大部分組成：HTTP請求和HTTP響應。那麽HttpClient程序包是如何實現HTTP客戶端應用的呢？實現過程中需要註意哪些問題呢？
HTTP請求

HTTP 1.1由以下幾種請求組成：GET, HEAD, POST, PUT, DELETE, TRACE and OPTIONS， 程序包中分別用HttpGet, HttpHead, HttpPost, HttpPut, HttpDelete, HttpTrace, and HttpOptions 這幾個類創建請求。所有的這些類均實現了HttpUriRequest接口，故可以作為execute的執行參數使用。
所有請求中最常用的是GET與POST兩種請求，與創建GET請求的方法相同，可以用如下方法創建一個POST請求：

HttpUriRequest request = new HttpPost(
"http://localhost/index.html");


HTTP請求格式告訴我們，有兩個位置或者說兩種方式可以為request提供參數：request-line方式與request-body方式。
request-line

request-line方式是指在請求行上通過URI直接提供參數。
（1）
我們可以在生成request對象時提供帶參數的URI，如：

HttpUriRequest request = new HttpGet(
"http://localhost/index.html?param1=value1&param2=value2");

（2）
另外，HttpClient程序包為我們提供了URIUtils工具類，可以通過它生成帶參數的URI，如：

URI uri = URIUtils.createURI("http", "localhost", -1, "/index.html",
"param1=value1&param2=value2", null);
HttpUriRequest request = new HttpGet(uri);
System.out.println(request.getURI());

上例的打印結果如下：

http://localhost/index.html?param1=value1&param2=value2

（3）
需要註意的是，如果參數中含有中文，需將參數進行URLEncoding處理，如：

String param = "param1=" + URLEncoder.encode("中國", "UTF-8") + "&param2=value2";
URI uri = URIUtils.createURI("http", "localhost", 8080,
"/sshsky/index.html", param, null);
System.out.println(uri);

上例的打印結果如下：

http://localhost/index.html?param1=%E4%B8%AD%E5%9B%BD&param2=value2

（4）
對於參數的URLEncoding處理，HttpClient程序包為我們準備了另一個工具類：URLEncodedUtils。通過它，我們可以直觀的（但是比較復雜）生成URI，如：

List params = new ArrayList();
params.add(new BasicNameValuePair("param1", "中國"));
params.add(new BasicNameValuePair("param2", "value2"));
String param = URLEncodedUtils.format(params, "UTF-8");
URI uri = URIUtils.createURI("http", "localhost", 8080,
"/sshsky/index.html", param, null);
System.out.println(uri);

上例的打印結果如下：

http://localhost/index.html?param1=%E4%B8%AD%E5%9B%BD&param2=value2

request-body

與request-line方式不同，request-body方式是在request-body中提供參數，此方式只能用於POST請求。在 HttpClient程序包中有兩個類可以完成此項工作，它們分別是UrlEncodedFormEntity類與MultipartEntity類。這兩個類均實現了HttpEntity接口。
（1）
使用最多的是UrlEncodedFormEntity類。通過該類創建的對象可以模擬傳統的HTML表單傳送POST請求中的參數。如下面的表單：

<form action="http://localhost/index.html" method="POST">
<input type="text" name="param1" value="中國"/>
<input type="text" name="param2" value="value2"/>
<inupt type="submit" value="submit"/>
</form>

我們可以用下面的代碼實現：

List formParams = new ArrayList();
formParams.add(new BasicNameValuePair("param1", "中國"));
formParams.add(new BasicNameValuePair("param2", "value2"));
HttpEntity entity = new UrlEncodedFormEntity(formParams, "UTF-8");

HttpPost request = new HttpPost(“http://localhost/index.html”);
request.setEntity(entity);

當然，如果想查看HTTP數據格式，可以通過HttpEntity對象的各種方法取得。如：

List formParams = new ArrayList();
formParams.add(new BasicNameValuePair("param1", "中國"));
formParams.add(new BasicNameValuePair("param2", "value2"));
UrlEncodedFormEntity entity = new UrlEncodedFormEntity(formParams, "UTF-8");

System.out.println(entity.getContentType());
System.out.println(entity.getContentLength());
System.out.println(EntityUtils.getContentCharSet(entity));
System.out.println(EntityUtils.toString(entity));

上例的打印結果如下：

Content-Type: application/x-www-form-urlencoded; charset=UTF-8
39
UTF-8
param1=%E4%B8%AD%E5%9B%BD&param2=value2

（2）
除了傳統的application/x-www-form-urlencoded表單，我們另一個經常用到的是上傳文件用的表單，這種表單的類型為 multipart/form-data。在HttpClient程序擴展包（HttpMime）中專門有一個類與之對應，那就是 MultipartEntity類。此類同樣實現了HttpEntity接口。如下面的表單：

<form action="http://localhost/index.html" method="POST"
enctype="multipart/form-data">
<input type="text" name="param1" value="中國"/>
<input type="text" name="param2" value="value2"/>
<input type="file" name="param3"/>
<inupt type="submit" value="submit"/>
</form>

我們可以用下面的代碼實現：

MultipartEntity entity = new MultipartEntity();
entity.addPart("param1", new StringBody("中國", Charset.forName("UTF-8")));
entity.addPart("param2", new StringBody("value2", Charset.forName("UTF-8")));
entity.addPart("param3", new FileBody(new File("C:\\1.txt")));

HttpPost request = new HttpPost(“http://localhost/index.html”);
request.setEntity(entity);

HTTP請求如何帶參