HttpClient 是 Apache Jakarta Common 下的子项目，可以用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包，并且它支持 HTTP 协议最新的版本和建议。当前官网最新版介绍页是：http://hc.apache.org/httpcomponents-client-4.5.x/index.html

 

       许多需要后台模拟请求的系统或者框架都用的是httpclient。所以作为一个java开发人员，有必要学一学。本文提供了一个简单的demo，供初学者参考。

 

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

  1. 创建CloseableHttpClient对象。
  2. 创建请求方法的实例，并指定请求URL。如果需要发送GET请求，创建HttpGet对象；如果需要发送POST请求，创建HttpPost对象。
  3. 如果需要发送请求参数，可可调用setEntity(HttpEntity entity)方法来设置请求参数。setParams方法已过时（4.4.1版本）。
  4. 调用HttpGet、HttpPost对象的setHeader(String name, String value)方法设置header信息，或者调用setHeaders(Header[] headers)设置一组header信息。
  5. 调用CloseableHttpClient对象的execute(HttpUriRequest request)发送请求，该方法返回一个CloseableHttpResponse。
  6. 调用HttpResponse的getEntity()方法可获取HttpEntity对象，该对象包装了服务器的响应内容。程序可通过该对象获取服务器的响应内容；调用CloseableHttpResponse的getAllHeaders()、getHeaders(String name)等方法可获取服务器的响应头。
  7. 释放连接。无论执行方法是否成功，都必须释放连接

       具体代码如下(HttpClient-4.4.1)：

/** 
* 简单httpclient实例
* 
* @author arron
* @date 2015年11月11日 下午6:36:49 
* @version 1.0 
*/
public class SimpleHttpClientDemo {

/**
* 模拟请求
* 
* @param url    资源地址
* @param map    参数列表
* @param encoding    编码
* @return
* @throws ParseException
* @throws IOException
*/
public static String send(String url, Map<String,String> map,String encoding) throws ParseException, IOException{
String body = "";

//创建httpclient对象
CloseableHttpClient client = HttpClients.createDefault();
//创建post方式请求对象
HttpPost httpPost = new HttpPost(url);

//装填参数
List<NameValuePair> nvps = new ArrayList<NameValuePair>();
if(map!=null){
for (Entry<String, String> entry : map.entrySet()) {
nvps.add(new BasicNameValuePair(entry.getKey(), entry.getValue()));
}
}
//设置参数到请求对象中
httpPost.setEntity(new UrlEncodedFormEntity(nvps, encoding));

System.out.println("请求地址："+url);
System.out.println("请求参数："+nvps.toString());

//设置header信息
//指定报文头【Content-type】、【User-Agent】
httpPost.setHeader("Content-type", "application/x-www-form-urlencoded");
httpPost.setHeader("User-Agent", "Mozilla/4.0 (compatible; MSIE 5.0; Windows NT; DigExt)");

//执行请求操作，并拿到结果（同步阻塞）
CloseableHttpResponse response = client.execute(httpPost);
//获取结果实体
HttpEntity entity = response.getEntity();
if (entity != null) {
//按指定编码转换结果实体为String类型
body = EntityUtils.toString(entity, encoding);
}
EntityUtils.consume(entity);
//释放链接
response.close();
return body;
}
}

 

       在main方法中测试一下：

public static void main(String[] args) throws ParseException, IOException {
        String url="http://php.weather.sina.com.cn/iframe/index/w_cl.php";
        Map<String, String> map = new HashMap<String, String>();
        map.put("code", "js");
        map.put("day", "0");
        map.put("city", "上海");
        map.put("dfc", "1");
        map.put("charset", "utf-8");
        String body = send(url, map,"utf-8");
        System.out.println("交易响应结果：");
        System.out.println(body);
 
        System.out.println("-----------------------------------");
 
        map.put("city", "北京");
        body = send(url, map, "utf-8");
        System.out.println("交易响应结果：");
        System.out.println(body);
    }

 

       结果如下：

请求地址：http://php.weather.sina.com.cn/iframe/index/w_cl.php
请求参数：[dfc=1, charset=utf-8, day=0, code=js, city=上海]
交易响应结果：
(function(){var w=[];w['上海']=[{s1:'小雨',s2:'小雨',f1:'xiaoyu',f2:'xiaoyu',t1:'21',t2:'16',p1:'≤3',p2:'≤3',d1:'南风',d2:'北风'}];var add={now:'2015-11-16 13:16:23',time:'1447650983',update:'北京时间11月16日08:10更新',error:'0',total:'1'};window.SWther={w:w,add:add};})();//0

-----------------------------------
请求地址：http://php.weather.sina.com.cn/iframe/index/w_cl.php
请求参数：[dfc=1, charset=utf-8, day=0, code=js, city=北京]
交易响应结果：
(function(){var w=[];w['北京']=[{s1:'多云',s2:'多云',f1:'duoyun',f2:'duoyun',t1:'9',t2:'1',p1:'≤3',p2:'≤3',d1:'无持续风向',d2:'无持续风向'}];var add={now:'2015-11-16 13:18:35',time:'1447651115',update:'北京时间11月16日08:10更新',error:'0',total:'1'};window.SWther={w:w,add:add};})();//0

 

       现在我们测试一下https链接：https://www.qingyidai.com/investmanagement/invest.shtml

public static void main(String[] args) throws ParseException, IOException {
String url = "https://www.qingyidai.com/investmanagement/invest.shtml";
String body = send(url, null, "utf-8");
System.out.println("交易响应结果：");
System.out.println(body);
}

 

       结果发现，居然正常拿到结果了：

       原来如果网站的证书已经被ca机构认证通过了，那么用HttpClient来调用的话，会直接成功的。不用再单独配置htts链接了。不过如果是自签名的证书，还是需要配置https的，下篇就来配置一下吧，敬请期待。