HttpClient 在 Java 项目中的使用详解

1. HttpClient 简介

HttpClient 是 Apache 组织提供的一个用于处理 HTTP 请求和响应的 Java 库，它可以模拟浏览器的行为，可以用于访问 Web 页面，执行 GET、POST、PUT、DELETE 等 HTTP 操作。HttpClient 具有以下特点：

• 支持 HTTP/1.1 和 HTTP/2
• 支持多种请求方法：GET、POST、PUT、DELETE 等
• 支持 SSL 和 TLS 安全协议
• 支持文件上传和下载
• 支持请求和响应的拦截器，便于在请求和响应之间添加通用逻辑
• 支持连接池和连接持久化，提高请求效率

2. HttpClient 的使用

2.1 创建 HttpClient

可以使用 HttpClientBuilder 类来创建一个 HttpClient，如下所示：

import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;

CloseableHttpClient httpClient = HttpClientBuilder.create().build();

2.2 执行 GET 请求

可以使用 HttpGet 类来执行 GET 请求，如下所示：

import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.utils.URIBuilder;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.util.EntityUtils;

import java.net.URI;

CloseableHttpClient httpClient = HttpClientBuilder.create().build();

try {
    URI uri = new URIBuilder()
            .setScheme("http")
            .setHost("example.com")
            .setPath("/api/users")
            .setParameter("page", "1")
            .setParameter("size", "20")
            .build();

    HttpGet httpGet = new HttpGet(uri);

    CloseableHttpResponse response = httpClient.execute(httpGet);

    try {
        String responseBody = EntityUtils.toString(response.getEntity());
        System.out.println(responseBody);
    } finally {
        response.close();
    }
} finally {
    httpClient.close();
}

2.3 执行 POST 请求

可以使用 HttpPost 类来执行 POST 请求，如下所示：

import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;

import java.util.ArrayList;
import java.util.List;

CloseableHttpClient httpClient = HttpClientBuilder.create().build();

try {
    HttpPost httpPost = new HttpPost("http://example.com/api/users");

    List<BasicNameValuePair> params = new ArrayList<>();
    params.add(new BasicNameValuePair("username", "johndoe"));
    params.add(new BasicNameValuePair("password", "password123"));
    httpPost.setEntity(new UrlEncodedFormEntity(params));

    CloseableHttpResponse response = httpClient.execute(httpPost);

    try {
        String responseBody = EntityUtils.toString(response.getEntity());
        System.out.println(responseBody);
    } finally {
        response.close();
    }
} finally {
    httpClient.close();
}

3. 总结

本文介绍了 HttpClient 的基本使用方法，包括创建 HttpClient、执行 GET 请求和 POST 请求。在实际开发中，可以根据具体需求使用 HttpClient 的其他功能，例如文件上传和下载、连接池和连接持久化等。