HttpClient详细解释

Http协议的重要性相信不用我多说了,HttpClient相比传统JDK自带的URLConnection,增加了易用性和灵活性(具体区别,日后我们再讨论),它不仅是客户端发送Http请求变得容易,而且也方便了开发人员测试接口(基于Http协议的),即提高了开发的效率,也方便提高代码的健壮性。因此熟练掌握HttpClient是很重要的必修内容,掌握HttpClient后,相信对于Http协议的了解会更加深入。

org.apache.commons.httpclient.HttpClient与org.apache.http.client.HttpClient的区别

[java]  view plain  copy
  1. Commons的HttpClient项目现在是生命的尽头,不再被开发,  
  2. 已被Apache HttpComponents项目HttpClient和的HttpCore  
  3. 模组取代,提供更好的性能和更大的灵活性。  

一、简介

HttpClient是Apache Jakarta Common下的子项目,用来提供高效的、最新的、功能丰富的支持HTTP协议的客户端编程工具包,并且它支持HTTP协议最新的版本和建议。HttpClient已经应用在很多的项目中,比如Apache Jakarta上很著名的另外两个开源项目Cactus和HTMLUnit都使用了HttpClient。

下载地址: http://hc.apache.org/downloads.cgi



二、特性

1. 基于标准、纯净的java语言。实现了Http1.0和Http1.1

2. 以可扩展的面向对象的结构实现了Http全部的方法(GET, POST, PUT, DELETE, HEAD, OPTIONS, and TRACE)。

3. 支持HTTPS协议。

4. 通过Http代理建立透明的连接。

5. 利用CONNECT方法通过Http代理建立隧道的https连接。

6. Basic, Digest, NTLMv1, NTLMv2, NTLM2 Session, SNPNEGO/Kerberos认证方案。

7. 插件式的自定义认证方案。

8. 便携可靠的套接字工厂使它更容易的使用第三方解决方案。

9. 连接管理器支持多线程应用。支持设置最大连接数,同时支持设置每个主机的最大连接数,发现并关闭过期的连接。

10. 自动处理Set-Cookie中的Cookie。

11. 插件式的自定义Cookie策略。

12. Request的输出流可以避免流中内容直接缓冲到socket服务器。

13. Response的输入流可以有效的从socket服务器直接读取相应内容。

14. 在http1.0和http1.1中利用KeepAlive保持持久连接。

15. 直接获取服务器发送的response code和 headers。

16. 设置连接超时的能力。

17. 实验性的支持http1.1 response caching。

18. 源代码基于Apache License 可免费获取。

三、使用方法

使用HttpClient发送请求、接收响应很简单,一般需要如下几步即可。

1. 创建HttpClient对象。

2. 创建请求方法的实例,并指定请求URL。如果需要发送GET请求,创建HttpGet对象;如果需要发送POST请求,创建HttpPost对象。

3. 如果需要发送请求参数,可调用HttpGet、HttpPost共同的setParams(HetpParams params)方法来添加请求参数;对于HttpPost对象而言,也可调用setEntity(HttpEntity entity)方法来设置请求参数。

4. 调用HttpClient对象的execute(HttpUriRequest request)发送请求,该方法返回一个HttpResponse。

5. 调用HttpResponse的getAllHeaders()、getHeaders(String name)等方法可获取服务器的响应头;调用HttpResponse的getEntity()方法可获取HttpEntity对象,该对象包装了服务器的响应内容。程序可通过该对象获取服务器的响应内容。

6. 释放连接。无论执行方法是否成功,都必须释放连接

相关jar包
[java]  view plain  copy
  1. commons-cli-1.2.jar  
  2. commons-codec-1.9.jar  
  3. commons-logging-1.2.jar  
  4. fluent-hc-4.5.1.jar  
  5. httpclient-4.5.1.jar  
  6. httpclient-cache-4.5.1.jar  
  7. httpclient-win-4.5.1.jar  
  8. httpcore-4.4.3.jar  
  9. httpcore-ab-4.4.3.jar  
  10. httpcore-nio-4.4.3.jar  
  11. httpmime-4.5.1.jar  
  12. jna-4.1.0.jar  
  13. jna-platform-4.1.0.jar  

最简单post请求, 源自 http://my.oschina.net/xinxingegeya/blog/282683
[java]  view plain  copy
  1. package a;  
  2.    
  3. import java.io.FileInputStream;  
  4. import java.io.IOException;  
  5. import java.util.ArrayList;  
  6. import java.util.List;  
  7. import java.util.Properties;  
  8.    
  9. import org.apache.http.HttpEntity;  
  10. import org.apache.http.HttpResponse;  
  11. import org.apache.http.NameValuePair;  
  12. import org.apache.http.client.HttpClient;  
  13. import org.apache.http.client.config.RequestConfig;  
  14. import org.apache.http.client.entity.UrlEncodedFormEntity;  
  15. import org.apache.http.client.methods.HttpPost;  
  16. import org.apache.http.impl.client.DefaultHttpClient;  
  17. import org.apache.http.message.BasicNameValuePair;  
  18. import org.apache.http.util.EntityUtils;  
  19.    
  20. public class First {  
  21.     public static void main(String[] args) throws Exception{  
  22.         List<NameValuePair> formparams = new ArrayList<NameValuePair>();  
  23.         formparams.add(new BasicNameValuePair("account"""));  
  24.         formparams.add(new BasicNameValuePair("password"""));  
  25.         HttpEntity reqEntity = new UrlEncodedFormEntity(formparams, "utf-8");  
  26.     
  27.         RequestConfig requestConfig = RequestConfig.custom()  
  28.         .setConnectTimeout(5000)//一、连接超时:connectionTimeout-->指的是连接一个url的连接等待时间  
  29.                 .setSocketTimeout(5000)// 二、读取数据超时:SocketTimeout-->指的是连接上一个url,获取response的返回等待时间  
  30.                 .setConnectionRequestTimeout(5000)  
  31.                 .build();  
  32.     
  33.         HttpClient client = new DefaultHttpClient();  
  34.         HttpPost post = new HttpPost("http://cnivi.com.cn/login");  
  35.         post.setEntity(reqEntity);  
  36.         post.setConfig(requestConfig);  
  37.         HttpResponse response = client.execute(post);  
  38.     
  39.         if (response.getStatusLine().getStatusCode() == 200) {  
  40.             HttpEntity resEntity = response.getEntity();  
  41.             String message = EntityUtils.toString(resEntity, "utf-8");  
  42.             System.out.println(message);  
  43.         } else {  
  44.             System.out.println("请求失败");  
  45.         }  
  46.     }  
  47.    
  48. }  


四、实例

主文件

[java]  view plain  copy
  1. package com.test;  
  2.       
  3. import java.io.File;  
  4. import java.io.FileInputStream;  
  5. import java.io.IOException;  
  6. import java.io.UnsupportedEncodingException;  
  7. import java.security.KeyManagementException;  
  8. import java.security.KeyStore;  
  9. import java.security.KeyStoreException;  
  10. import java.security.NoSuchAlgorithmException;  
  11. import java.security.cert.CertificateException;  
  12. import java.util.ArrayList;  
  13. import java.util.List;  
  14. import javax.net.ssl.SSLContext;  
  15. import org.apache.http.HttpEntity;  
  16. import org.apache.http.NameValuePair;  
  17. import org.apache.http.ParseException;  
  18. import org.apache.http.client.ClientProtocolException;  
  19. import org.apache.http.client.entity.UrlEncodedFormEntity;  
  20. import org.apache.http.client.methods.CloseableHttpResponse;  
  21. import org.apache.http.client.methods.HttpGet;  
  22. import org.apache.http.client.methods.HttpPost;  
  23. import org.apache.http.conn.ssl.SSLConnectionSocketFactory;  
  24. import org.apache.http.conn.ssl.SSLContexts;  
  25. import org.apache.http.conn.ssl.TrustSelfSignedStrategy;  
  26. import org.apache.http.entity.ContentType;  
  27. import org.apache.http.entity.mime.MultipartEntityBuilder;  
  28. import org.apache.http.entity.mime.content.FileBody;  
  29. import org.apache.http.entity.mime.content.StringBody;  
  30. import org.apache.http.impl.client.CloseableHttpClient;  
  31. import org.apache.http.impl.client.HttpClients;  
  32. import org.apache.http.message.BasicNameValuePair;  
  33. import org.apache.http.util.EntityUtils;  
  34. import org.apache.http.client.config.RequestConfig;  
  35. import org.junit.Test;  
  36. public class HttpClientTest {  
  37.   //方法见下........  
  38. }  

HttpClientUtils工具类

[java]  view plain  copy
  1. package com.bobo.code.web.controller.technology.httpcomponents;  
  2.    
  3.    
  4. import org.apache.http.HttpEntity;  
  5. import org.apache.http.HttpHost;  
  6. import org.apache.http.HttpResponse;  
  7. import org.apache.http.NameValuePair;  
  8. import org.apache.http.client.HttpClient;  
  9. import org.apache.http.client.config.RequestConfig;  
  10. import org.apache.http.client.methods.HttpUriRequest;  
  11. import org.apache.http.client.methods.RequestBuilder;  
  12. import org.apache.http.conn.routing.HttpRoute;  
  13. import org.apache.http.impl.client.CloseableHttpClient;  
  14. import org.apache.http.impl.client.HttpClientBuilder;  
  15. import org.apache.http.impl.client.HttpClients;  
  16. import org.apache.http.impl.conn.PoolingHttpClientConnectionManager;  
  17. import org.apache.http.message.BasicNameValuePair;  
  18. import org.apache.http.util.EntityUtils;  
  19.     
  20. import java.io.IOException;  
  21. import java.util.*;  
  22.     
  23. public class HttpClientUtils {  
  24.     
  25.     private static PoolingHttpClientConnectionManager connectionManager = null;  
  26.     private static HttpClientBuilder httpBuilder = null;  
  27.     private static RequestConfig requestConfig = null;  
  28.     
  29.     private static int MAXCONNECTION = 10;  
  30.     
  31.     private static int DEFAULTMAXCONNECTION = 5;  
  32.     
  33.     private static String IP = "cnivi.com.cn";  
  34.     private static int PORT = 80;  
  35.     
  36.     static {  
  37.         //设置http的状态参数  
  38.         requestConfig = RequestConfig.custom()  
  39.                 .setSocketTimeout(5000)  
  40.                 .setConnectTimeout(5000)  
  41.                 .setConnectionRequestTimeout(5000)  
  42.                 .build();  
  43.     
  44.         HttpHost target = new HttpHost(IP, PORT);  
  45.         connectionManager = new PoolingHttpClientConnectionManager();  
  46.         connectionManager.setMaxTotal(MAXCONNECTION);//客户端总并行链接最大数  
  47.         connectionManager.setDefaultMaxPerRoute(DEFAULTMAXCONNECTION);//每个主机的最大并行链接数  
  48.         connectionManager.setMaxPerRoute(new HttpRoute(target), 20);  
  49.         httpBuilder = HttpClients.custom();  
  50.         httpBuilder.setConnectionManager(connectionManager);  
  51.     }  
  52.     
  53.     public static CloseableHttpClient getConnection() {  
  54.         CloseableHttpClient httpClient = httpBuilder.build();  
  55.         return httpClient;  
  56.     }  
  57.     
  58.     
  59.     public static HttpUriRequest getRequestMethod(Map<String, String> map, String url, String method) {  
  60.         List<NameValuePair> params = new ArrayList<NameValuePair>();  
  61.         Set<Map.Entry<String, String>> entrySet = map.entrySet();  
  62.         for (Map.Entry<String, String> e : entrySet) {  
  63.             String name = e.getKey();  
  64.             String value = e.getValue();  
  65.             NameValuePair pair = new BasicNameValuePair(name, value);  
  66.             params.add(pair);  
  67.         }  
  68.         HttpUriRequest reqMethod = null;  
  69.         if ("post".equals(method)) {  
  70.             reqMethod = RequestBuilder.post().setUri(url)  
  71.                     .addParameters(params.toArray(new BasicNameValuePair[params.size()]))  
  72.                     .setConfig(requestConfig).build();  
  73.         } else if ("get".equals(method)) {  
  74.             reqMethod = RequestBuilder.get().setUri(url)  
  75.                     .addParameters(params.toArray(new BasicNameValuePair[params.size()]))  
  76.                     .setConfig(requestConfig).build();  
  77.         }  
  78.         return reqMethod;  
  79.     }  
  80.     
  81.     public static void main(String args[]) throws IOException {  
  82.         Map<String, String> map = new HashMap<String, String>();  
  83.         map.put("account""");  
  84.         map.put("password""");  
  85.     
  86.         HttpClient client = getConnection();  
  87.         HttpUriRequest post = getRequestMethod(map, "http://cnivi.com.cn/login""post");  
  88.         HttpResponse response = client.execute(post);  
  89.     
  90.         if (response.getStatusLine().getStatusCode() == 200) {  
  91.             HttpEntity entity = response.getEntity();  
  92.             String message = EntityUtils.toString(entity, "utf-8");  
  93.             System.out.println(message);  
  94.         } else {  
  95.             System.out.println("请求失败");  
  96.         }  
  97.     }  
  98. }  

get方式

[java]  view plain  copy
  1. /** 
  2.      * 发送 get请求 
  3.      */   
  4.     public void get() {   
  5.         CloseableHttpClient httpclient = HttpClients.createDefault();   
  6.         try {   
  7.             // 创建httpget.     
  8.             HttpGet httpget = new HttpGet("http://www.baidu.com/");   
  9.             System.out.println("executing request " + httpget.getURI());   
  10.             // 执行get请求.     
  11.             CloseableHttpResponse response = httpclient.execute(httpget);   
  12.             try {   
  13.                 // 获取响应实体     
  14.                 HttpEntity entity = response.getEntity();   
  15.                 System.out.println("--------------------------------------");   
  16.                 // 打印响应状态     
  17.                 System.out.println(response.getStatusLine());   
  18.                 if (entity != null) {   
  19.                     // 打印响应内容长度     
  20.                     System.out.println("Response content length: " + entity.getContentLength());   
  21.                     // 打印响应内容     
  22.                     System.out.println("Response content: " + EntityUtils.toString(entity));   
  23.                 }   
  24.                 System.out.println("------------------------------------");   
  25.             } finally {   
  26.                 response.close();   
  27.             }   
  28.         } catch (ClientProtocolException e) {   
  29.             e.printStackTrace();   
  30.         } catch (ParseException e) {   
  31.             e.printStackTrace();   
  32.         } catch (IOException e) {   
  33.             e.printStackTrace();   
  34.         } finally {   
  35.             // 关闭连接,释放资源     
  36.             try {   
  37.                 httpclient.close();   
  38.             } catch (IOException e) {   
  39.                 e.printStackTrace();   
  40.             }   
  41.         }   
  42.     }   

post方式

[java]  view plain  copy
  1. /** 
  2.      * 发送 post请求访问本地应用并根据传递参数不同返回不同结果 
  3.      */   
  4.     public void post() {   
  5.         // 创建默认的httpClient实例.     
  6.         CloseableHttpClient httpclient = HttpClients.createDefault();   
  7.         // 创建httppost     
  8.         HttpPost httppost = new HttpPost("http://localhost:8080/myDemo/Ajax/serivceJ.action");   
  9.         // 创建参数队列     
  10.         List<NameValuePair> formparams = new ArrayList<NameValuePair>();   
  11.         formparams.add(new BasicNameValuePair("type""house"));   
  12.         UrlEncodedFormEntity uefEntity;   
  13.         try {   
  14.             uefEntity = new UrlEncodedFormEntity(formparams, "UTF-8");   
  15.             httppost.setEntity(uefEntity);   
  16.             System.out.println("executing request " + httppost.getURI());   
  17.             CloseableHttpResponse response = httpclient.execute(httppost);   
  18.             try {   
  19.                 HttpEntity entity = response.getEntity();   
  20.                 if (entity != null) {   
  21.                     System.out.println("--------------------------------------");   
  22.                     System.out.println("Response content: " + EntityUtils.toString(entity, "UTF-8"));   
  23.                     System.out.println("--------------------------------------");   
  24.                 }   
  25.             } finally {   
  26.                 response.close();   
  27.             }   
  28.         } catch (ClientProtocolException e) {   
  29.             e.printStackTrace();   
  30.         } catch (UnsupportedEncodingException e1) {   
  31.             e1.printStackTrace();   
  32.         } catch (IOException e) {   
  33.             e.printStackTrace();   
  34.         } finally {   
  35.             // 关闭连接,释放资源     
  36.             try {   
  37.                 httpclient.close();   
  38.             } catch (IOException e) {   
  39.                 e.printStackTrace();   
  40.             }   
  41.         }   
  42.     }   

post方式乱码补充 
如果有乱码,可以偿试使用 StringEntity 来替换HttpEntity:

[java]  view plain  copy
  1. StringEntity content =new StringEntity(soapRequestData.toString(), Charset.forName("UTF-8"));// 第二个参数,设置后才会对,内容进行编码  
  2.         content.setContentType("application/soap+xml; charset=UTF-8");  
  3.         content.setContentEncoding("UTF-8");  
  4.         httppost.setEntity(content);  

具体SOAP协议代码如下:

[java]  view plain  copy
  1. package com.isoftstone.core.service.impl;  
  2.   
  3. import java.io.BufferedReader;  
  4. import java.io.File;  
  5. import java.io.FileInputStream;  
  6. import java.io.FileReader;  
  7. import java.io.IOException;  
  8. import java.io.InputStreamReader;  
  9. import java.nio.charset.Charset;  
  10. import java.util.Scanner;  
  11.   
  12. import org.apache.http.HttpEntity;  
  13. import org.apache.http.HttpResponse;  
  14. import org.apache.http.client.ClientProtocolException;  
  15. import org.apache.http.client.HttpClient;  
  16. import org.apache.http.client.entity.EntityBuilder;  
  17. import org.apache.http.client.methods.HttpPost;  
  18. import org.apache.http.entity.ContentType;  
  19. import org.apache.http.entity.StringEntity;  
  20. import org.apache.http.impl.client.HttpClients;  
  21. import org.apache.http.util.EntityUtils;  
  22. import org.apache.log4j.Logger;  
  23. import org.jdom.Document;  
  24. import org.jdom.Element;  
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值