## 📋 目录

- 一、工具类功能
- 二、所需环境
- 三、方法与调用示例（按需调用）
- 四、工具类源码（可直接复制）

## 一、工具类功能

基于 JDK 内置 `HttpClient` 发 GET/POST 请求，拿回来的直接是业务对象：单个对象、`List`/`Map` 这类泛型结构，也可以就是响应原文，非 2xx 把状态码与完整错误体一并交回。

## 二、所需环境

JDK 17或以上 + Spring Boot 3.x或以上

```xml
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <scope>provided</scope>
</dependency>
```

## 三、方法与调用示例（按需调用）

🔢 **方法序号**：1

🎯 **方法用途**：
- 发一个 GET 请求，响应直接读成指定类型的对象
- 对接 REST 接口取单个实体时用，不用再手写 JSON 解析

🧩 **方法定义**：`public static <R> R get(String url, Class<R> responseType)`

🗣️ **入参解释**：`public static <R> R get(请求地址, 目标类型)`

📤 **返回值解释**：`R`，与目标类型同一个类型

💡 **边界口径**：
- 目标类型传 `String.class` 拿响应体原文，传 `Void.class` 表示不关心返回体
- 响应体在内存里读，上限 8 MiB（`MAX_RESPONSE_BYTES`），超限立即断开，不用于下载大文件
- 非 2xx 抛 `HttpStatusException`，带状态码、最终地址、响应头与完整错误体，可用 `bodyAs(Class)` 一步解成对象
- 只放行 `http`/`https` 且必须有主机名，其余协议抛 `IllegalArgumentException`
- 重定向按 `NORMAL` 跟随，自定义请求头会被带到跳转后的地址，跳转目标不可控时别在头里放凭据

🧪 **方法示例**：
- `get(textUrl, String.class)` 原生返回 拿到 `这段不是 JSON`
- `get(userUrl, User.class)` 返回对象 拿到 `User[name=张三, age=18]`

---

🔢 **方法序号**：2

🎯 **方法用途**：
- 发 GET 请求，把响应读成 `List`/`Map` 这类泛型结构
- 接口返回数组时直接拿到对象列表，不用先取字符串再自己解

🧩 **方法定义**：`public static <R> R get(String url, TypeReference<R> responseType)`

🗣️ **入参解释**：`public static <R> R get(请求地址, 泛型类型)`

📤 **返回值解释**：`R`，由泛型类型引用决定，如 `List<User>`

💡 **边界口径**：
- 泛型入参写 `new TypeReference<>() {}`，目标类型由接收变量推断
- 响应体在内存里读，上限 8 MiB（`MAX_RESPONSE_BYTES`），超限立即断开，不用于下载大文件
- 非 2xx 抛 `HttpStatusException`，带状态码、最终地址、响应头与完整错误体，可用 `bodyAs(Class)` 一步解成对象
- 只放行 `http`/`https` 且必须有主机名，其余协议抛 `IllegalArgumentException`
- 重定向按 `NORMAL` 跟随，自定义请求头会被带到跳转后的地址，跳转目标不可控时别在头里放凭据

🧪 **方法示例**：
- `get(usersUrl, new TypeReference<>() {})` 返回集合列表 拿到 `[User[name=张三, age=18], User[name=李四, age=20]]`

---

🔢 **方法序号**：3

🎯 **方法用途**：
- GET 的全参版，查询参数、自定义请求头、本次超时都能给
- 要带认证头或单独收紧超时的接口用它，不必为了这几个选项自己拼 URL

🧩 **方法定义**：`public static <R> R get(String url, Map<String, String> queryParams, Map<String, String> headers, Duration requestTimeout, Class<R> responseType)`

🗣️ **入参解释**：`public static <R> R get(请求地址, 查询参数, 请求头, 本次超时, 目标类型)`

📤 **返回值解释**：`R`，与目标类型同一个类型

💡 **边界口径**：
- 默认只带 `Accept: application/json`；同名头以传入的 `headers` 为准，覆盖它就是发表单请求的做法
- 请求超时按本次调用生效，默认 30 秒（`DEFAULT_REQUEST_TIMEOUT`），且约束延伸到响应体每一块，不只是响应头
- 连接超时固定 10 秒，全局共用一个 `HttpClient`（自带连接池），不要每次请求新建
- 响应体在内存里读，上限 8 MiB（`MAX_RESPONSE_BYTES`），超限立即断开，不用于下载大文件
- 非 2xx 抛 `HttpStatusException`，带状态码、最终地址、响应头与完整错误体，可用 `bodyAs(Class)` 一步解成对象
- 只放行 `http`/`https` 且必须有主机名，其余协议抛 `IllegalArgumentException`
- 重定向按 `NORMAL` 跟随，自定义请求头会被带到跳转后的地址，跳转目标不可控时别在头里放凭据

🧪 **方法示例**：
- `get(url, params, headers, timeout, String.class)` 原生返回 拿到 `{"name":"张三","age":18}`
- `get(url, params, headers, timeout, User.class)` 返回对象 拿到 `User[name=张三, age=18]`

---

🔢 **方法序号**：4

🎯 **方法用途**：
- GET 全参版的泛型结构入口，返回形态与方法2 一致
- 既要带参数与自定义请求头、又要读回 `List`/`Map` 时用这一版

🧩 **方法定义**：`public static <R> R get(String url, Map<String, String> queryParams, Map<String, String> headers, Duration requestTimeout, TypeReference<R> responseType)`

🗣️ **入参解释**：`public static <R> R get(请求地址, 查询参数, 请求头, 本次超时, 泛型类型)`

📤 **返回值解释**：`R`，由泛型类型引用决定

💡 **边界口径**：
- 参数、请求头与超时口径同方法3，返回形态与方法2 一致
- 响应体在内存里读，上限 8 MiB（`MAX_RESPONSE_BYTES`），超限立即断开，不用于下载大文件
- 非 2xx 抛 `HttpStatusException`，带状态码、最终地址、响应头与完整错误体，可用 `bodyAs(Class)` 一步解成对象
- 只放行 `http`/`https` 且必须有主机名，其余协议抛 `IllegalArgumentException`
- 重定向按 `NORMAL` 跟随，自定义请求头会被带到跳转后的地址，跳转目标不可控时别在头里放凭据

🧪 **方法示例**：
- `get(usersUrl, params, headers, timeout, new TypeReference<>() {})` 返回集合列表 拿到 `[User[name=张三, age=18], User[name=李四, age=20]]`

---

🔢 **方法序号**：5

🎯 **方法用途**：
- 发一个 JSON POST，请求体对象直接序列化发出去，响应读回指定类型的对象
- 创建、提交类接口一步完成，不用自己拼请求体字符串

🧩 **方法定义**：`public static <R> R post(String url, Object body, Class<R> responseType)`

🗣️ **入参解释**：`public static <R> R post(请求地址, 请求体, 目标类型)`

📤 **返回值解释**：`R`，与目标类型同一个类型

💡 **边界口径**：
- 请求体是 `String` 就原样发送，其余对象按 JSON 序列化，日期写成 ISO-8601；`byte[]` 会被 Jackson 写成 base64 字符串，本类不用于传原始二进制
- 默认带 `Content-Type: application/json; charset=UTF-8`，发表单要自己覆盖这个头
- 响应里多出来的字段不会让解析报错
- 响应体在内存里读，上限 8 MiB（`MAX_RESPONSE_BYTES`），超限立即断开，不用于下载大文件
- 非 2xx 抛 `HttpStatusException`，带状态码、最终地址、响应头与完整错误体，可用 `bodyAs(Class)` 一步解成对象
- 只放行 `http`/`https` 且必须有主机名，其余协议抛 `IllegalArgumentException`
- 重定向按 `NORMAL` 跟随，自定义请求头会被带到跳转后的地址，跳转目标不可控时别在头里放凭据

🧪 **方法示例**：
- `post(url, form, String.class)` 原生返回 拿到 `{"orderId":"SO20260930001","created":true}`
- `post(url, form, CreateResult.class)` 返回对象 拿到 `CreateResult[orderId=SO20260930001, created=true]`

---

🔢 **方法序号**：6

🎯 **方法用途**：
- POST 的泛型结构入口，响应读成 `List`/`Map` 这类结构
- 接口一次返回一批对象时直接拿到 `List<实体>`，不用循环单解

🧩 **方法定义**：`public static <R> R post(String url, Object body, TypeReference<R> responseType)`

🗣️ **入参解释**：`public static <R> R post(请求地址, 请求体, 泛型类型)`

📤 **返回值解释**：`R`，由泛型类型引用决定

💡 **边界口径**：
- 请求体与请求头口径同方法5
- 响应体在内存里读，上限 8 MiB（`MAX_RESPONSE_BYTES`），超限立即断开，不用于下载大文件
- 非 2xx 抛 `HttpStatusException`，带状态码、最终地址、响应头与完整错误体，可用 `bodyAs(Class)` 一步解成对象
- 只放行 `http`/`https` 且必须有主机名，其余协议抛 `IllegalArgumentException`
- 重定向按 `NORMAL` 跟随，自定义请求头会被带到跳转后的地址，跳转目标不可控时别在头里放凭据

🧪 **方法示例**：
- `post(listUrl, form, new TypeReference<>() {})` 返回集合列表 拿到 `[CreateResult[orderId=SO20260930002, created=true], CreateResult[orderId=SO20260930003, created=true]]`

---

🔢 **方法序号**：7

🎯 **方法用途**：
- POST 的全参版，查询参数、自定义请求头、本次超时都能给
- 把 `Content-Type` 覆盖成表单类型就能发 `application/x-www-form-urlencoded`

🧩 **方法定义**：`public static <R> R post(String url, Object body, Map<String, String> queryParams, Map<String, String> headers, Duration requestTimeout, Class<R> responseType)`

🗣️ **入参解释**：`public static <R> R post(请求地址, 请求体, 查询参数, 请求头, 本次超时, 目标类型)`

📤 **返回值解释**：`R`，与目标类型同一个类型

💡 **边界口径**：
- 同名头以传入的 `headers` 为准，把 `Content-Type` 换成 `application/x-www-form-urlencoded` 即发表单
- 超时与连接复用口径同方法3
- 响应体在内存里读，上限 8 MiB（`MAX_RESPONSE_BYTES`），超限立即断开，不用于下载大文件
- 非 2xx 抛 `HttpStatusException`，带状态码、最终地址、响应头与完整错误体，可用 `bodyAs(Class)` 一步解成对象
- 只放行 `http`/`https` 且必须有主机名，其余协议抛 `IllegalArgumentException`
- 重定向按 `NORMAL` 跟随，自定义请求头会被带到跳转后的地址，跳转目标不可控时别在头里放凭据

🧪 **方法示例**：
- `post(url, form, params, headers, timeout, String.class)` 原生返回 拿到 `{"name":"张三"}`
- `post(url, form, params, headers, timeout, FormEcho.class)` 返回对象 拿到 `FormEcho[name=张三]`

---

🔢 **方法序号**：8

🎯 **方法用途**：
- POST 全参版的泛型结构入口，返回形态与方法6 一致
- 带参数与自定义请求头的同时把响应读成 `List`/`Map`

🧩 **方法定义**：`public static <R> R post(String url, Object body, Map<String, String> queryParams, Map<String, String> headers, Duration requestTimeout, TypeReference<R> responseType)`

🗣️ **入参解释**：`public static <R> R post(请求地址, 请求体, 查询参数, 请求头, 本次超时, 泛型类型)`

📤 **返回值解释**：`R`，由泛型类型引用决定

💡 **边界口径**：
- 参数、请求头与超时口径同方法7，返回形态与方法6 一致
- 响应体在内存里读，上限 8 MiB（`MAX_RESPONSE_BYTES`），超限立即断开，不用于下载大文件
- 非 2xx 抛 `HttpStatusException`，带状态码、最终地址、响应头与完整错误体，可用 `bodyAs(Class)` 一步解成对象
- 只放行 `http`/`https` 且必须有主机名，其余协议抛 `IllegalArgumentException`
- 重定向按 `NORMAL` 跟随，自定义请求头会被带到跳转后的地址，跳转目标不可控时别在头里放凭据

🧪 **方法示例**：
- `post(listUrl, form, params, headers, timeout, new TypeReference<>() {})` 返回集合列表 拿到 `[CreateResult[orderId=SO20260930002, created=true], CreateResult[orderId=SO20260930003, created=true]]`

---

🔢 **方法序号**：9

🎯 **方法用途**：
- 把键值对拼成已按 UTF-8 编码的 URL 查询串
- 自己管请求或用别的客户端时，复用这一套编码口径保证拼串结果一致

🧩 **方法定义**：`public static String toQueryString(Map<String, String> params)`

🗣️ **入参解释**：`public static String toQueryString(键值对)`

📤 **返回值解释**：`String`，已按 UTF-8 百分号编码的查询串，不带前导 `?`

💡 **边界口径**：
- 键与值都按 UTF-8 百分号编码，中文与保留字符不会拼坏
- 参数不合法（如 `params` 为 `null`）抛 `IllegalArgumentException`
- 它只是编码工具，不参与任何请求发送

🧪 **方法示例**：
- `toQueryString(Map.of("name", "zhangsan", "addr", "xx街道"))` 返回编码串 拿到 `name=zhangsan&addr=xx%E8%A1%97%E9%81%93`

## 四、工具类源码（可直接复制）

📦 见评论区



基于 JDK 内置 HttpClient 发 GET/POST 请求，拿回来的直接是业务对象：单个对象、List/Map 这类泛型结构，也可以就是响应原文，非 2xx 把状态码与完整错误体一并交回。

基于JDK HttpClient的Java工具类，GET、POST请求可直接返回业务对象

编程语言

后端

开发工具

基于JDK17与SpringBoot3的HTTP客户端工具类，封装GET/POST请求，直接返回业务对象、List/Map泛型或响应原文。支持自定义请求头、超时与查询参数，非2xx抛出含状态码及错误体的异常，响应体上限8MiB，含URL编码工具，适合REST接口快速对接。

代码解释

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

基于JDK HttpClient的Java工具类，GET、POST请求可直接返回业务对象-腾讯云开发者社区-腾讯云

基于JDK HttpClient的Java工具类，GET、POST请求可直接返回业务对象

基于JDK HttpClient的Java工具类，GET、POST请求可直接返回业务对象

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐