Class HttpClientBuilder

java.lang.Object
com.sure.tool.http.HttpClientBuilder

public class HttpClientBuilder extends Object
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 Details

    • builder

      public static HttpClientBuilder builder()
      创建构建器。
      Returns:
      构建器
    • connectTimeout

      public HttpClientBuilder connectTimeout(Duration connectTimeout)
      连接超时。
      Parameters:
      connectTimeout - 超时
      Returns:
      本构建器
    • virtualThreads

      public HttpClientBuilder virtualThreads()
      使用虚拟线程 executor(JDK 21+,默认关闭;开启后每个请求独占虚拟线程,适合高并发 IO 场景)。
      Returns:
      本构建器
    • executor

      public HttpClientBuilder executor(ExecutorService executor)
      自定义 executor。
      Parameters:
      executor - 线程池
      Returns:
      本构建器
    • proxy

      public HttpClientBuilder proxy(String host, int port)
      HTTP 代理。
      Parameters:
      host - 代理主机
      port - 代理端口
      Returns:
      本构建器
    • proxy

      public HttpClientBuilder proxy(Proxy proxy)
      任意 HTTP 代理。
      Parameters:
      proxy - 代理
      Returns:
      本构建器
    • followRedirects

      public HttpClientBuilder followRedirects(boolean followRedirects)
      是否跟随重定向(默认 true)。
      Parameters:
      followRedirects - 是否跟随
      Returns:
      本构建器
    • version

      public HttpClientBuilder version(HttpClient.Version version)
      强制 HTTP/1.1(默认,兼容性好);传 HttpClient.Version.HTTP_2 启用 HTTP/2。
      Parameters:
      version - HTTP 版本
      Returns:
      本构建器
    • build

      public HttpClient build()
      构建 HttpClient(连接池/keep-alive 由 JDK 管理)。
      Returns:
      HttpClient