Java HTTP Client API详解

Java的HTTP客户端API经历了多次演进，从早期的HttpURLConnection到第三方库如Apache HttpClient，再到Java 11引入的标准HttpClient。本文将全面解析Java中主要的HTTP客户端API，包括特性对比、使用方法和最佳实践。

一、Java HTTP客户端发展历程

传统HttpURLConnection：自JDK 1.1引入，API设计陈旧，仅支持HTTP/1.1，同步阻塞模型，使用复杂。
Apache HttpClient：功能丰富的第三方库，支持HTTP/1.1和HTTPS，提供连接池管理等高级特性。
Java 11 HttpClient：Java 9引入孵化模块，Java 11正式发布，支持HTTP/2和WebSocket，提供同步/异步双模型。

二、Java 11 HttpClient详解

核心类与特性

Java 11 HttpClient API包含三个核心类：

java.net.http.HttpClient：发送请求和处理响应的主类
java.net.http.HttpRequest：表示HTTP请求，配置URL、方法、头信息等
java.net.http.HttpResponse：表示服务器响应，包含状态码、头和响应体

主要特性：

支持HTTP/1.1和HTTP/2协议
同步阻塞和异步非阻塞双模型
内置WebSocket支持
链式API设计，代码简洁
自动处理Cookie和重定向

基本使用示例

同步GET请求

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder().uri(URI.create("https://api.example.com/data")).build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

异步GET请求

HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder().uri(URI.create("https://api.example.com/data")).build();
CompletableFuture<HttpResponse<String>> future = client.sendAsync(request, HttpResponse.BodyHandlers.ofString());
future.thenApply(HttpResponse::body).thenAccept(System.out::println).join();

POST请求提交表单数据

Map<Object, Object> formData = Map.of("username", "test", "password", "secret");
HttpRequest formRequest = HttpRequest.newBuilder().uri(URI.create("https://api.example.com/login")).header("Content-Type", "application/x-www-form-urlencoded").POST(HttpRequest.BodyPublishers.ofString(formData.entrySet().stream().map(e -> e.getKey() + "=" + URLEncoder.encode(e.getValue().toString(), StandardCharsets.UTF_8)).collect(Collectors.joining("&")))).build();

高级配置

HttpClient client = HttpClient.newBuilder().version(HttpClient.Version.HTTP_2) // 强制使用HTTP/2.connectTimeout(Duration.ofSeconds(10)).followRedirects(HttpClient.Redirect.NORMAL).executor(Executors.newVirtualThreadPerTaskExecutor()) // Java 21+虚拟线程.build();

配置选项包括：

HTTP版本选择(HTTP_1_1或HTTP_2)
连接超时设置
重定向策略(NEVER, ALWAYS, NORMAL)
自定义线程池
代理和认证设置

三、Apache HttpClient详解

虽然Java 11提供了标准HTTP客户端，但Apache HttpClient仍是广泛使用的第三方库，特别是在Java 11之前的项目中。

核心特性

支持HTTP/1.1和HTTPS
连接池管理和多线程支持
多种认证方案(Basic, Digest, NTLM等)
Cookie管理
可扩展的API设计

基本使用示例

GET请求

CloseableHttpClient httpClient = HttpClients.createDefault();
HttpGet httpGet = new HttpGet("http://example.com/api");
CloseableHttpResponse response = httpClient.execute(httpGet);
try {HttpEntity entity = response.getEntity();String result = EntityUtils.toString(entity);EntityUtils.consume(entity);
} finally {response.close();
}

POST请求

CloseableHttpClient httpClient = HttpClients.createDefault();
HttpPost httpPost = new HttpPost("http://example.com/api");
List<NameValuePair> params = new ArrayList<>();
params.add(new BasicNameValuePair("param1", "value1"));
params.add(new BasicNameValuePair("param2", "value2"));
httpPost.setEntity(new UrlEncodedFormEntity(params));
CloseableHttpResponse response = httpClient.execute(httpPost);
// 处理响应同上

连接池配置

PoolingHttpClientConnectionManager cm = new PoolingHttpClientConnectionManager();
cm.setMaxTotal(200); // 最大连接数
cm.setDefaultMaxPerRoute(20); // 每个路由最大连接数CloseableHttpClient httpClient = HttpClients.custom().setConnectionManager(cm).build();

四、HttpURLConnection简介

虽然已被取代，但在旧代码中仍可能遇到：

try {URL url = new URL("https://example.com");HttpURLConnection connection = (HttpURLConnection) url.openConnection();connection.setRequestMethod("GET");if (connection.getResponseCode() == 200) {BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));String inputLine;while ((inputLine = in.readLine()) != null) {System.out.println(inputLine);}}
} catch (IOException e) {e.printStackTrace();
}

缺点：

仅支持HTTP/1.1
同步阻塞模型
API设计陈旧，使用复杂
缺乏现代特性如连接池

五、各HTTP客户端对比

特性	Java 11 HttpClient	Apache HttpClient	HttpURLConnection
HTTP/2支持	是	否	否
WebSocket支持	是	否	否
同步/异步模型	双模型	同步	同步
连接池管理	内置	支持	不支持
认证方案	基本	丰富	有限
需要额外依赖	否	是	否
现代API设计	是	部分	否