Java原生HttpClient怎么使用

Java 11引入了新的HttpClient类，作为java.net.http包的一部分，提供了现代化的HTTP客户端功能。与传统的HttpURLConnection相比，HttpClient提供了更简洁、更灵活的API，支持HTTP/2和WebSocket，并且具有异步和同步两种请求方式。本文将介绍如何使用Java原生的HttpClient进行HTTP请求。

1. 创建HttpClient实例

首先，我们需要创建一个HttpClient实例。HttpClient是一个不可变对象，可以通过HttpClient.newBuilder()方法来创建并配置它。

import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;

public class HttpClientExample {
    public static void main(String[] args) {
        HttpClient client = HttpClient.newHttpClient();
    }
}

2. 创建HttpRequest

接下来，我们需要创建一个HttpRequest对象，用于描述要发送的HTTP请求。HttpRequest可以通过HttpRequest.newBuilder()方法来创建。

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://example.com"))
        .GET()  // 默认是GET请求
        .build();

在这个例子中，我们创建了一个GET请求，请求的URL是https://example.com。

3. 发送请求并获取响应

HttpClient支持同步和异步两种方式发送请求。

3.1 同步请求

使用send方法可以同步发送请求，并等待响应返回。

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println("Response status code: " + response.statusCode());
System.out.println("Response body: " + response.body());

在这个例子中，我们使用HttpResponse.BodyHandlers.ofString()来处理响应体，将其作为字符串返回。

3.2 异步请求

使用sendAsync方法可以异步发送请求，并返回一个CompletableFuture对象。

client.sendAsync(request, HttpResponse.BodyHandlers.ofString())
        .thenApply(HttpResponse::body)
        .thenAccept(System.out::println)
        .join();

在这个例子中，我们使用thenApply和thenAccept来处理异步响应的结果，并在控制台打印响应体。

4. 处理POST请求

除了GET请求，HttpClient也支持POST请求。我们可以通过HttpRequest.BodyPublishers来设置请求体。

String json = "{\"name\":\"John\", \"age\":30}";
HttpRequest postRequest = HttpRequest.newBuilder()
        .uri(URI.create("https://example.com/api"))
        .header("Content-Type", "application/json")
        .POST(HttpRequest.BodyPublishers.ofString(json))
        .build();

HttpResponse<String> postResponse = client.send(postRequest, HttpResponse.BodyHandlers.ofString());
System.out.println("POST Response status code: " + postResponse.statusCode());
System.out.println("POST Response body: " + postResponse.body());

在这个例子中，我们发送了一个POST请求，请求体是一个JSON字符串。

5. 处理响应头

我们可以通过HttpResponse对象的headers()方法来获取响应头。

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
HttpHeaders headers = response.headers();
headers.map().forEach((k, v) -> System.out.println(k + ": " + v));

6. 处理异常

在实际使用中，可能会遇到各种异常情况，例如网络连接问题、超时等。我们可以通过try-catch块来捕获并处理这些异常。

try {
    HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println("Response status code: " + response.statusCode());
    System.out.println("Response body: " + response.body());
} catch (IOException | InterruptedException e) {
    e.printStackTrace();
}

7. 配置HttpClient

HttpClient提供了丰富的配置选项，例如设置超时时间、代理、SSL上下文等。

HttpClient client = HttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(10))
        .followRedirects(HttpClient.Redirect.NORMAL)
        .version(HttpClient.Version.HTTP_2)
        .build();

在这个例子中，我们配置了连接超时时间为10秒，启用了自动重定向，并指定使用HTTP/2协议。

8. 总结

Java原生的HttpClient提供了强大且灵活的HTTP客户端功能，支持同步和异步请求，能够处理GET、POST等多种HTTP方法，并且可以轻松配置各种参数。通过本文的介绍，你应该能够掌握如何使用HttpClient进行HTTP请求，并在实际项目中应用它。

通过以上内容，你已经了解了如何使用Java原生的HttpClient进行HTTP请求。无论是简单的GET请求还是复杂的POST请求，HttpClient都能轻松应对。希望本文对你有所帮助！