jdk-httpClient-demo

JDK HTTP Client 使用教程

基于 JDK 自带模块 java.net.http（Java 11+，本仓库使用 Java 17）的实战示例项目， 围绕一个本地运行的 User Management API，演示 JDK HTTP Client 的核心用法。 每个知识点均包含：示例代码、JUnit 测试、文字说明。

项目结构

httpClient/
├── src/                        # JDK HTTP Client 示例与测试（根模块，Java 17）
│   ├── main/java/space/anyi/httpClient/
│   │   ├── model/              # UserRequest / UserVO / FileVO / Result<T> 模型
│   │   ├── QuickStart.java     # 快速入门：请求构造与响应处理
│   │   ├── GetExample.java     # GET 请求
│   │   ├── PostExample.java    # POST 请求（JSON）
│   │   ├── PutDeleteExample.java # PUT / DELETE 请求
│   │   ├── HeaderExample.java  # 请求头
│   │   ├── BodyExample.java    # 请求体 / multipart 文件上传
│   │   ├── FileDownloadExample.java # 文件下载
│   │   ├── SyncAsyncExample.java   # 同步与异步
│   │   ├── ResponseHandlerExample.java # 响应处理器
│   │   ├── ClientConfigExample.java  # HTTP Client 配置
│   │   ├── RequestConfigExample.java # HTTP Request 配置
│   │   └── CoreApiExample.java # 核心对象 API 一览
│   └── test/java/space/anyi/httpClient/  # 12 个测试类（JUnit 5）
├── API_server/                 # User Management API（Spring Boot 3.5，独立模块）
├── httpClient.md               # 主题大纲
├── doc.md                      # 详细使用文档
└── blog.md                     # 教程 blog（doc.md 的 blog 化渲染）

环境要求

• JDK 17+
• Maven 3.6+

快速开始

# 1. 启动 API 服务（独立 Spring Boot 应用，监听 8080 端口）
mvn -f API_server/pom.xml spring-boot:run

# 2. 运行全部测试（需先启动 API 服务）
mvn test

# 2'. 运行单个测试类
mvn -Dtest=GetExampleTest test

注意：测试会真实调用本地 API，必须先启动 API 服务，否则网络相关测试会失败。

API 端点

方法	路径	说明
GET	/api/users	查询用户列表
GET	/api/users/{id}	按 id 查询单个用户
POST	/api/users	创建用户（JSON）
PUT	/api/users/{id}	整体更新用户（JSON）
DELETE	/api/users/{id}	删除用户
POST	/api/files/upload	文件上传（multipart/form-data）
GET	/api/files/download/{storedFileName}	按存储文件名下载文件

用户字段（UserRequest）：name、account、sex 均必填，account 唯一， 重复创建返回 409。所有接口返回统一包装结构 {code, message, data}。 文件上传结果存于 uploads/ 目录（已 gitignore）。

启动后可通过 Swagger UI（springdoc）浏览接口文档： http://localhost:8080/swagger-ui.html

文档

文件	内容
httpClient.md	主题大纲（文档结构的事实来源）
doc.md	详细使用文档
blog.md	blog 版教程

涉及知识点

• GET / POST / PUT / DELETE 请求
• 请求头与请求体（JSON、输入流、multipart 文件上传）
• 文件上传与下载
• 同步 send() 与异步 sendAsync()、批量并发
• 内置与自定义响应处理器（BodyHandler / BodySubscriber）
• HTTP Client 与 HTTP Request 配置项
• 核心对象（HttpClient / HttpRequest / HttpResponse / HttpHeaders）API