Class HttpClientBuilder
java.lang.Object
com.sure.tool.http.HttpClientBuilder
JDK
HttpClient 构建器:连接池(keep-alive 复用)、虚拟线程 executor、代理、超时与 TLS 版本。
构建出的 HttpClient 自带连接复用与并发限制,适合大批量请求场景;与 HttpRequest.client(HttpClient) 配合使用。
HttpClient client = HttpClientBuilder.builder()
.virtualThreads()
.connectTimeout(3, TimeUnit.SECONDS)
.proxy("127.0.0.1", 8080)
.build();
String body = HttpRequest.get("https://api.example.com").client(client).execute().body();
- Since:
- 1.1.0
- Author:
- suretool
-
Method Summary
Modifier and TypeMethodDescriptionbuild()构建 HttpClient(连接池/keep-alive 由 JDK 管理)。static HttpClientBuilderbuilder()创建构建器。connectTimeout(Duration connectTimeout) 连接超时。executor(ExecutorService executor) 自定义 executor。followRedirects(boolean followRedirects) 是否跟随重定向(默认 true)。HTTP 代理。任意 HTTP 代理。version(HttpClient.Version version) 强制 HTTP/1.1(默认,兼容性好);传HttpClient.Version.HTTP_2启用 HTTP/2。使用虚拟线程 executor(JDK 21+,默认关闭;开启后每个请求独占虚拟线程,适合高并发 IO 场景)。
-
Method Details
-
builder
-
connectTimeout
连接超时。- Parameters:
connectTimeout- 超时- Returns:
- 本构建器
-
virtualThreads
使用虚拟线程 executor(JDK 21+,默认关闭;开启后每个请求独占虚拟线程,适合高并发 IO 场景)。- Returns:
- 本构建器
-
executor
自定义 executor。- Parameters:
executor- 线程池- Returns:
- 本构建器
-
proxy
HTTP 代理。- Parameters:
host- 代理主机port- 代理端口- Returns:
- 本构建器
-
proxy
-
followRedirects
是否跟随重定向(默认 true)。- Parameters:
followRedirects- 是否跟随- Returns:
- 本构建器
-
version
强制 HTTP/1.1(默认,兼容性好);传HttpClient.Version.HTTP_2启用 HTTP/2。- Parameters:
version- HTTP 版本- Returns:
- 本构建器
-
build
-