Apache HttpClient Java：方法、示例、安装

什么是 Apache HttpClient 以及为什么需要它

Apache HttpClient 是一个强大且灵活的 Java 语言库，用于执行 HTTP 请求。它为开发者提供了对通过 HTTP 协议发送和接收数据过程的完全控制。与内置的 java.net.HttpURLConnection 类不同，Apache HttpClient 提供了更高级的 API，支持现代标准（HTTP/1.1、HTTP/2），方便处理 Cookie、认证、连接池和请求拦截器。

该库在以下场景中不可或缺：

与 REST API 交互 — 向 Web 服务发送 GET、POST、PUT、DELETE 请求。
网页解析 — 下载 HTML 内容以供后续分析。
Web 应用程序测试 — 模拟客户端请求。
微服务架构 — 服务之间的数据交换。
文件下载 — 下载二进制数据（图片、压缩包）。

安装 Apache HttpClient

Apache HttpClient 不能通过 pip 或 npm 安装，因为它是一个 Java 库。要使用它，需要使用 Maven 或 Gradle 依赖管理系统。以下是两种方式的说明。

通过 Maven 安装 (pom.xml)

将以下依赖添加到您的 pom.xml 文件中：

<dependency>    <groupId>org.apache.httpcomponents</groupId>    <artifactId>httpclient</artifactId>    <version>4.5.14</version></dependency>

<dependency>    <groupId>org.apache.httpcomponents</groupId>    <artifactId>httpmime</artifactId>    <version>4.5.14</version></dependency>

通过 Gradle 安装 (build.gradle)

在 dependencies 部分添加：

implementation 'org.apache.httpcomponents:httpclient:4.5.14'implementation 'org.apache.httpcomponents:httpmime:4.5.14'

对于 HTTP/2（5.x 版本），请使用：

implementation 'org.apache.httpcomponents.client5:httpclient5:5.3.1'

快速入门：第一个 HTTP 请求

创建一个简单的 Java 类并向公共 API 执行 GET 请求：

import org.apache.http.client.methods.CloseableHttpResponse;import org.apache.http.client.methods.HttpGet;import org.apache.http.impl.client.CloseableHttpClient;import org.apache.http.impl.client.HttpClients;import org.apache.http.util.EntityUtils;

public class QuickStart {    public static void main(String[] args) {        // 1. 创建 HTTP 客户端        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {                        // 2. 创建 GET 请求            HttpGet request = new HttpGet("https://jsonplaceholder.typicode.com/posts/1");                        // 3. 执行请求并获取响应            try (CloseableHttpResponse response = httpClient.execute(request)) {                                // 4. 提取响应体                String body = EntityUtils.toString(response.getEntity());                                // 5. 输出结果                System.out.println("Status code: " + response.getStatusLine().getStatusCode());                System.out.println("Response body: " + body);            }        } catch (Exception e) {            e.printStackTrace();        }    }}