使用Hutool向第三方的接口发起请求

一般用在请求普通的页面情况下，返回的结果是JSON格式，但是如果出现了404、504错误，返回的是HTML格式报错（视情况而定）

示例代码（来源于Hutool的开发文档）：

Get请求：

// 最简单的HTTP请求，可以自动通过header等信息判断编码，不区分HTTP和HTTPS
String result1= HttpUtil.get("https://www.baidu.com");

// 当无法识别页面编码的时候，可以自定义请求页面的编码
String result2= HttpUtil.get("https://www.baidu.com", CharsetUtil.CHARSET_UTF_8);

//可以单独传入http参数，这样参数会自动做URL编码，拼接在URL中
HashMap paramMap = new HashMap<>();
paramMap.put("city", "北京");

String result3= HttpUtil.get("https://www.baidu.com", paramMap);

Post请求：

HashMap paramMap = new HashMap<>();
paramMap.put("city", "北京");

String result= HttpUtil.post("https://www.baidu.com", paramMap);

文件上传：

HashMap paramMap = new HashMap<>();
//文件上传只需将参数中的键指定（默认file），值设为文件对象即可，对于使用者来说，文件上传与普通表单提交并无区别
paramMap.put("file", FileUtil.file("D:\face.jpg"));

String result= HttpUtil.post("https://www.baidu.com", paramMap);

HttpResponse httpResponse = HttpRequest.post(url)
                .header(Header.USER_AGENT, "Hutool http")//头信息，多个头信息多次调用此方法即可
                .form(paramMap)//表单内容
                .timeout(20000)//超时，毫秒
                .execute();
int status = httpResponse.getStatus(); //获取响应码
String body = httpResponse.body(); //获取响应内容

在工作中向一个第三方的接口请求了一个JSON串，结果在传回的字符串转换成我需要的对象时，显示了如下的报错：

cn.hutool.core.convert.ConvertException: Can not Converter from [cn.hutool.json.JSONObject] to [com.xyc.entity.Student]
at cn.hutool.core.convert.ConverterRegistry.convert(ConverterRegistry.java:280)
at cn.hutool.core.convert.ConverterRegistry.convert(ConverterRegistry.java:295)
at cn.hutool.core.convert.Convert.convertWithCheck(Convert.java:745)

以下为实例代码：

	@Test
    void jsonToBeanTest(){
//        String str = "{"gender":"男","name":"李想","id":1}";
        String str = HttpUtil.get(url);
        Student student = JSONUtil.toBean(str, Student.class);
        System.out.println(student);
    }

经排查，原因是因为Student实体类没有get/set方法，补上Lombok的**@Data**注解。问题解决

遇到过一个接口，得到的JSON串类似这样：

{
“msg”: “操作完成”,
“code”: 200,
“data”: {
“result”: {
“root”: [{
“gender”: “男”,
“name”: “李想”,
“id”: 1
}, {
“gender”: “男”,
“name”: “张三”,
“id”: 2
}]
}
}
}

看到的第一眼就头大，还好工具可以很方便的获取节点和对象，实例代码如下：

	@Test
    void jsonToBeanToList(){
        String str = HttpUtil.get(url);
        ApiResult apiResult = JSONUtil.toBean(str, ApiResult.class);
        if (apiResult != null && apiResult.getCode()==200){
            Object resultStr = new JSONObject(apiResult.getData().toString()).get("result");
            // 结果: {"root":[{"gender":"男","name":"李想","id":1},{"gender":"男","name":"张三","id":2}]}
            JSONArray root = new JSONObject(resultStr.toString()).getJSONArray("root");
            List students = root.toList(Student.class);
        }
    }

1. 首先根据格式判断是统一响应对象，一般情况下需要判断响应码是否200来进行下一步操作，其中data是我们需要的数据部分。

   ApiResult apiResult = JSONUtil.toBean(str, ApiResult.class);

2. 再接着拿出第二层result，这里面还是一个对象，直接通过.get方法获取Object。

3. root这一层可以发现是一个数组，正好hutool提供了一个JSONArray对象，可以通过JSONArray的toList方法转换成我们需要的List集合。

4. 最终我们需要的对象就在这个List集合当中。