使用HttpClient模拟POST请求

article/2025/10/2 10:27:31

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)：

[java]  view plain  copy
/**  
 * 简单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方法中测试一下：

[java]  view plain  copy
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);  
}  

结果如下：

[html]  view plain  copy
请求地址：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

[java]  view plain  copy
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);  
}  