JavaHttpClient发送请求教程详解

有志者，事竟成！如果你在学习文章，那么本文《Java使用HttpClient发送请求入门指南》，就很适合你！文章讲解的知识点主要包括，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

答案是使用java.net.http.HttpClient发送网络请求。它通过链式调用构建请求，支持同步异步操作，内置超时、HTTP/2和连接池管理，相比老旧的HttpURLConnection更简洁高效，推荐用于现代Java项目中的HTTP通信。

Java中发送网络请求，现代且推荐的方式是使用内置的java.net.http.HttpClient。它提供了一套简洁、强大的API来处理HTTP通信，无论是简单的GET请求，还是复杂的POST带JSON数据，都能轻松应对。这不仅是网络编程的入门，更是日常开发中与各种API交互的必备技能。

要用Java的HttpClient发送网络请求，核心流程其实很直观。你首先得有个HttpClient实例，它就像你手里的那部手机，准备拨号。接着，你要构造一个HttpRequest，这相当于你决定要给谁打电话（URI），用什么方式打（GET还是POST），以及要说什么（请求体和头部）。最后，就是执行这个请求，然后等待对方的回复（HttpResponse）。

一个最简单的GET请求大概是这样：

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

public class SimpleGetRequest {

    public static void main(String[] args) {
        HttpClient client = HttpClient.newBuilder()
                .version(HttpClient.Version.HTTP_2) // 推荐使用HTTP/2
                .connectTimeout(Duration.ofSeconds(10)) // 设置连接超时
                .build();

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://jsonplaceholder.typicode.com/posts/1")) // 目标URI
                .GET() // GET请求
                .header("Accept", "application/json") // 设置请求头
                .build();

        try {
            HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); // 同步发送请求，并处理响应体为字符串

            System.out.println("Status Code: " + response.statusCode());
            System.out.println("Response Body: " + response.body());

        } catch (Exception e) {
            System.err.println("请求失败了，真是出乎意料啊: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

如果你需要发送POST请求，比如带上JSON数据，那也只是在构建HttpRequest时稍作调整：

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

public class SimplePostRequest {

    public static void main(String[] args) {
        HttpClient client = HttpClient.newBuilder()
                .version(HttpClient.Version.HTTP_2)
                .connectTimeout(Duration.ofSeconds(10))
                .build();

        String jsonBody = "{\"title\": \"foo\", \"body\": \"bar\", \"userId\": 1}"; // 要发送的JSON数据

        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://jsonplaceholder.typicode.com/posts"))
                .header("Content-Type", "application/json") // 告诉服务器我发的是JSON
                .POST(HttpRequest.BodyPublishers.ofString(jsonBody)) // POST请求，带上JSON体
                .build();

        try {
            HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());

            System.out.println("Status Code: " + response.statusCode());
            System.out.println("Response Body: " + response.body());

        } catch (Exception e) {
            System.err.println("POST请求也失败了，看看是哪儿出了问题: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

记住，HttpClient的设计理念就是链式调用和构建器模式，用起来会觉得特别流畅。

HttpClient 和 HttpURLConnection 有什么区别？为什么选择 HttpClient？

说实话，刚接触Java网络编程的时候，HttpURLConnection是绕不开的一个老朋友。它自Java 1.1就存在了，确实能完成基本的HTTP请求。但它的API用起来真的有点“原始”，或者说，不那么优雅。比如，设置请求方法、添加请求头、处理输入输出流，都需要手动一步步来，代码写出来往往比较冗长，可读性也不太好。而且，它默认是同步的，如果你想做异步操作，就得自己套线程池，这无疑增加了复杂性。

相比之下，HttpClient（尤其是Java 11引入的这个标准API）简直是现代网络编程的福音。我个人是更倾向于HttpClient的，它的API设计用起来舒服太多了，那种链式调用，让人感觉写代码都更流畅了。它内置了对HTTP/2和WebSocket的支持，性能表现也更出色。最关键的是，它原生支持异步请求，你可以用CompletableFuture来处理响应，这在需要并发处理大量网络请求的场景下，简直是如虎添翼。资源管理方面，HttpClient也做得更好，比如连接池的自动管理，这些都省去了我们很多操心的地方。所以，如果你正在开始新的项目，或者打算重构老代码的网络层，HttpClient绝对是首选。它不仅让代码更简洁，也让程序更健壮。

在实际项目中，如何优雅地处理 HttpClient 的异常和超时问题？

在实际开发中，网络请求失败几乎是家常便饭。超时、网络中断、服务器无响应，这些都是我们必须面对的挑战。我刚开始写网络请求的时候，最头疼的就是异常处理。超时啊，连接断了啊，这些都是家常便饭。所以，一套好的异常处理机制，真的能让你少掉很多头发。

HttpClient在发送请求时，可能会抛出几种常见的异常：

• IOException: 这通常是网络层面出了问题，比如连接中断、DNS解析失败等。
• InterruptedException: 如果你在一个等待网络响应的线程上调用了Thread.interrupt()，就可能遇到这个。
• HttpTimeoutException: 当请求的连接或响应时间超过你设定的阈值时，就会抛出这个。

处理这些异常，最基本的就是使用try-catch块。但仅仅捕获异常还不够，你得知道怎么配置超时，以及在异常发生时如何优雅地处理。

配置超时是预防长时间阻塞的关键。HttpClient.Builder提供了connectTimeout()和requestTimeout()方法：

• connectTimeout()：设置建立连接的超时时间。如果在这个时间内无法建立连接，就会抛出HttpTimeoutException。
• requestTimeout()：设置从发送请求到接收完整响应的超时时间。这包括了连接、发送请求体、等待响应头和响应体的时间。

示例代码中已经包含了connectTimeout的设置。如果需要设置整个请求的超时，可以在HttpRequest层面来做：

import java.time.Duration;
// ... 其他导入

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://some-slow-api

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。