Http客户端工具类-HttpUtil

概述

HttpUtil是应对简单场景下Http请求的工具类封装,此工具封装了HttpRequest对象常用操作,可以保证在一个方法之内完成Http请求。

此模块基于JDK的HttpUrlConnection封装完成,完整支持https、代理和文件上传。

使用

请求普通页面

针对最为常用的GET和POST请求,HttpUtil封装了两个方法,

  • HttpUtil.get
  • HttpUtil.post

这两个方法用于请求普通页面,然后返回页面内容的字符串,同时提供一些重载方法用于指定请求参数(指定参数支持File对象,可实现文件上传,当然仅仅针对POST请求)。

GET请求栗子:

  1. // 最简单的HTTP请求,可以自动通过header等信息判断编码,不区分HTTP和HTTPS
  2. String result1= HttpUtil.get("https://www.baidu.com");
  3. // 当无法识别页面编码的时候,可以自定义请求页面的编码
  4. String result2= HttpUtil.get("https://www.baidu.com", CharsetUtil.CHARSET_UTF_8);
  5. //可以单独传入http参数,这样参数会自动做URL编码,拼接在URL中
  6. HashMap<String, Object> paramMap = new HashMap<>();
  7. paramMap.put("city", "北京");
  8. String result3= HttpUtil.get("https://www.baidu.com", paramMap);

POST请求例子:

  1. HashMap<String, Object> paramMap = new HashMap<>();
  2. paramMap.put("city", "北京");
  3. String result= HttpUtil.post("https://www.baidu.com", paramMap);

文件上传

  1. HashMap<String, Object> paramMap = new HashMap<>();
  2. //文件上传只需将参数中的键指定(默认file),值设为文件对象即可,对于使用者来说,文件上传与普通表单提交并无区别
  3. paramMap.put("file", FileUtil.file("D:\\face.jpg"));
  4. String result= HttpUtil.post("https://www.baidu.com", paramMap);

下载文件

因为Hutool-http机制问题,请求页面返回结果是一次性解析为byte[]的,如果请求URL返回结果太大(比如文件下载),那内存会爆掉,因此针对文件下载HttpUtil单独做了封装。文件下载在面对大文件时采用流的方式读写,内存中只是保留一定量的缓存,然后分块写入硬盘,因此大文件情况下不会对内存有压力。

  1. String fileUrl = "http://mirrors.sohu.com/centos/7.3.1611/isos/x86_64/CentOS-7-x86_64-DVD-1611.iso";
  2. //将文件下载后保存在E盘,返回结果为下载文件大小
  3. long size = HttpUtil.downloadFile(fileUrl, FileUtil.file("e:/"));
  4. System.out.println("Download size: " + size);

当然,如果我们想感知下载进度,还可以使用另一个重载方法回调感知下载进度:

  1. //带进度显示的文件下载
  2. HttpUtil.downloadFile(fileUrl, FileUtil.file("e:/"), new StreamProgress(){
  3. @Override
  4. public void start() {
  5. Console.log("开始下载。。。。");
  6. }
  7. @Override
  8. public void progress(long progressSize) {
  9. Console.log("已下载:{}", FileUtil.readableFileSize(progressSize));
  10. }
  11. @Override
  12. public void finish() {
  13. Console.log("下载完成!");
  14. }
  15. });

StreamProgress接口实现后可以感知下载过程中的各个阶段。

当然,工具类提供了一个更加抽象的方法:HttpUtil.download,此方法会请求URL,将返回内容写入到指定的OutputStream中。使用这个方法,可以更加灵活的将HTTP内容转换写出,以适应更多场景。

更多有用的工具方法

  • HttpUtil.encodeParams 对URL参数做编码,只编码键和值,提供的值可以是url附带参数,但是不能只是url
  • HttpUtil.toParamsHttpUtil.decodeParams 两个方法是将Map参数转为URL参数字符串和将URL参数字符串转为Map对象
  • HttpUtil.urlWithForm是将URL字符串和Map参数拼接为GET请求所用的完整字符串使用
  • HttpUtil.getMimeType 根据文件扩展名快速获取其MimeType(参数也可以是完整文件路径)

更多请求参数

如果想设置头信息、超时、代理等信息,请见下一章节《Http客户端-HttpRequest》。