内容发布更新时间 : 2024/12/23 23:57:52星期一 下面是文章的全部内容请认真阅读。
HttpClient 4.0的使用详解
分类：
java编程（28）
版权声明：本文为博主原创文章，未经博主允许不得转载。
HttpClient程序包是一个实现了 HTTP协议的客户端编程工具包，要想熟练的掌握它，必须熟悉 HTTP协议。对于HTTP协议来说，无非就是用户请求数据，服务器端响应用户请求，并将内容结果返回给用户。HTTP1.1由以下几种请求组成：GET,HEAD, POST, PUT, DELETE, TRACE ,OPTIONS，因此对应到HttpClient程序包中分别用HttpGet,HttpHead, HttpPost, HttpPut, HttpDelete, HttpTrace, HttpOptions 这几个类来创建请求。所有的这些类均实现了HttpUriRequest接口，故可以作为execute的执行参数使用。 l HTTP请求
当然在所有请求中最常用的还是GET与POST两种请求，创建请求的方式如下： HttpUriRequest request = newHttpPost(\HttpUriRequest request = newHttpGet(“http://127.0.0.1:8080/index.html”);
HTTP请求格式告诉我们，有两种方式可以为request提供参数：request-line方式与request-body方式。
? request-line方式是指在请求行上通过URI直接提供参数。 （1）可以在生成request对象时提供带参数的URI，如： HttpUriRequest request =
newHttpGet(\
（2）HttpClient程序包还提供了URIUtils工具类，可以通过它生成带参数的URI，如： URI uri =URIUtils.createURI(\ \HttpUriRequest request = newHttpGet(uri);
System.out.println(request.getURI()); 上例的实例结果如下：
http://localhost/index.html?param1=value1¶m2=value2
（3）需要注意的是，如果参数中含有中文，需将参数进行URLEncoding处理，如： String param =\中国\URI uri =URIUtils.createURI(\System.out.println(uri); 上例的实例结果如下：
http://localhost/index.html?param1=??-???¶m2=value2 （4）对于参数的URLEncoding处理，HttpClient程序包为我们准备了另一个工具类：URLEncodedUtils。通过它，我们可以直观的（但是比较复杂）生成URI，如：
[java] view plain copy print?
1. List params = newArrayList(); 2.
3. params.add(newBasicNameValuePair(\, \中国\)); 4.
5. params.add(newBasicNameValuePair(\, \)); 6.
7. String param =URLEncodedUtils.format(params, \); 8.
9. URI uri =URIUtils.createURI(\, \, 8080,\,p
aram, null); 10.
11. System.out.println(uri);
上例的实例结果如下：
http://localhost/index.html?param1=??-???¶m2=value2 ? request-body方式是指在请求的request-body中提供参数
与 request-line方式不同，request-body方式是在request-body中提供参数，此方式只能用于进行POST请求。在HttpClient程序包中有两个类可以完成此项工作，它们分别是UrlEncodedFormEntity类与MultipartEntity类。这 两个类均实现了HttpEntity接口。 （1）UrlEncodedFormEntity类，故名思意该类主要用于form表单提交。通过该类创建的对象可以模拟传统的HTML表单传送POST请求中的参数。如下面的表单：
[html] view plain copy print?
1.
3.
5.
7.
即可以通过下面的代码实现：
[java] view plain copy print?
1. List formParams = newArrayList(); 2.
3. formParams.add(newBasicNameValuePair(\, \中国\)); 4.
5. formParams.add(newBasicNameValuePair(\, \)); 6.
7. HttpEntity entity = newUrlEncodedFormEntity(formParams, \); 8.
9. HttpPost request = newHttpPost(“http://localhost/index.html”); 10.
11. request.setEntity(entity);
当然，如果想查看HTTP数据格式，可以通过HttpEntity对象的各种方法取得。如：
[java] view plain copy print?
1. List formParams = newArrayList(); 2.
3. formParams.add(newBasicNameValuePair(\, \中国\)); 4.
5. formParams.add(newBasicNameValuePair(\, \)); 6.
7. UrlEncodedFormEntity entity =new UrlEncodedFormEntity(formParams, \);
8.
9. System.out.println(entity.getContentType()); 10.
11. System.out.println(entity.getContentLength()); 12.
13. System.out.println(EntityUtils.getContentCharSet(entity)); 14.
15. System.out.println(EntityUtils.toString(entity));
上例的实例结果如下：
Content-Type: application/x-www-form-urlencoded; charset=UTF-8 39 UTF-8
param1=??-???¶m2=value2
（2）除了传统的application/x-www-form-urlencoded表单，还有另一个经常用到的是上传文件用的表单，这种表单的类型为 multipart/form-data。在HttpClient程序扩展包（HttpMime）中专门有一个类与之对应，那就是MultipartEntity类。此类同样实现了HttpEntity接口。如下面的表单：
[html] view plain copy print?
1. 3. enctype=\> 4. 5. 7. 9. 11. 可以用下面的代码实现： [java] view plain copy print? 1. MultipartEntity entity = newMultipartEntity(); 2. 3. entity.addPart(\,new StringBody(\中国\, Charset.forName(\))); 4. 5. entity.addPart(\,new StringBody(\, Charset.forName(\))); 6. 7. entity.addPart(\,new FileBody(new File(\))); 8. 9. HttpPost request = newHttpPost(“http://localhost/index.html”); 10. 11. request.setEntity(entity); l HTTP响应 HttpClient 程序包对于HTTP响应的处理较请求来说简单多了，其过程同样使用了HttpEntity接口。我们可以从HttpEntity对象中取出数据流（InputStream），该数据流就是服务器返回的响应数据。需要注意的是，HttpClient程序包不负责 解析数据流中的内容。如： [java] view plain copy print? 1. HttpUriRequest request = ...; 2. 3. HttpResponse response =httpClient.execute(request); 4. 5. // 从response中取出HttpEntity对象 6. 7. HttpEntity entity =response.getEntity(); 8. 9. // 查看entity的各种指标 10. 11. System.out.println(entity.getContentType()); 12.