日常开发中，涉及到调用三方接口的时候，我们会使用工具来调用。常用的接口调用工具有下面的这些：

• OkHttp 学习成本较高
• Spring提供的 RestTemplate
• hutool工具包，使用说明地址

Hutool工具

基础使用

hutool的安装包请参考官方，此处不再赘述。

单元测试的参考代码如下：

package com.cghbh.test;
import cn.hutool.core.util.CharsetUtil;
import cn.hutool.http.HttpResponse;
import cn.hutool.http.HttpUtil;
import cn.hutool.json.JSONUtil;
import org.junit.jupiter.api.Test;
import java.util.HashMap;
import java.util.Map;

/**
 * Hutool-HttpUtil工具测试
 * @Author chengang
 * @Date 2026-11-07 19:49
 */
public class HttpUtilTest {


    /**
     * 测试GET请求
     */
    @Test
    public void testGet(){
        // 第一种GET请求方式 最简单的HTTP请求，可以自动通过header等信息判断编码，不区分HTTP和HTTPS
        String result1= HttpUtil.get("http://localhost:8080/captchaImage");
        System.out.println(result1);

        // 第二种GET请求方式
        HttpResponse response = HttpUtil.createGet("http://localhost:8080/captchaImage")
                .execute();
        if (response.isOk()) {
            String result2 = response.body();
            System.out.println(result2);
        }
    }


    /**
     * 测试GET请求
     */
    @Test
    public void testGetAdvanced(){
        HttpResponse response = HttpUtil.createGet("http://localhost:8080/nursing/project/list")
                .form(Map.of("pageNum",1, "pageSize",3))
                .header("authorization","Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImxvZ2luX3VzZXJfa2V5IjoiODgyM2JjNDItZDBmYi00ZGRhLWFmZjYtZDc0YTdlZjQ4Yjg0In0.f3LaRsjeMNlL8aH6EvsRk0Z_6HefQC32UD3brKKfL77mPwypqBbWoEA5t6xCIbGiY0bMdIELQ-4fjpuQZkc9pg")
                .execute();
        if (response.isOk()) {
            String result2 = response.body();
            System.out.println(result2);
        }
    }


    /**
     * 测试POST请求
     */
    @Test
    public void testPost(){
        HashMap<String, Object> paramMap = new HashMap<>();
        paramMap.put("name", "护理项目测试1111");
        paramMap.put("orderNo", 1);
        paramMap.put("unit", "次");
        paramMap.put("price", 10.00);
        paramMap.put("image", "https://yjy-slwl-oss.oss-cn-hangzhou.aliyuncs.com/ae7cf766-fb7b-49ff-a73c-c86c25f280e1.png");
        paramMap.put("nursingRequirement", "无特殊要求");
        paramMap.put("status", 1);
        HttpResponse response = HttpUtil.createPost("http://localhost:8080/nursing/project")
            	// 此处注意body里面的参数需要转换为json字符串
                .body(JSONUtil.toJsonStr(paramMap))
                .header("authorization","Bearer eyJhbGciOiJIUzUxMiJ9.eyJzdWIiOiJhZG1pbiIsImxvZ2luX3VzZXJfa2V5IjoiODgyM2JjNDItZDBmYi00ZGRhLWFmZjYtZDc0YTdlZjQ4Yjg0In0.f3LaRsjeMNlL8aH6EvsRk0Z_6HefQC32UD3brKKfL77mPwypqBbWoEA5t6xCIbGiY0bMdIELQ-4fjpuQZkc9pg")
                .execute();
        if (response.isOk()) {
            String result = response.body();
            System.out.println(result);
        }
    }
}

三方接口调用

三方接口的调用请严格参考接口方提供的说明文档来进行参数的传递。

/**
 * 测试调用第三方接口查询天气
 */
@Test
public void testQueryWeather(){
    String url = "https://ali-weather.showapi.com/hour24";

    HttpResponse response = HttpUtil.createGet(url)
            .header("Authorization", "APPCODE b18317c32c464a1bb64fb4c36e14f408")
            .form("area", "郑州")
            .execute();

    if(response.isOk()) {
        String result = response.body();

        System.out.println(result);
    }
}