使用Apache HttpClient发起一个POST HTTP请求

Apache HttpClient 是一个强大的Java库，用于处理HTTP请求。

它支持多种HTTP方法，包括GET、POST、PUT、DELETE等。

本教程将重点介绍如何使用Apache HttpClient发送POST HTTP请求。

POST请求通常用于向服务器发送数据以创建或更新资源。

我们将演示如何发送带有JSON数据的POST请求，并处理响应。

Maven依赖

要使用Apache HttpClient，请在你的pom.xml文件中添加以下依赖：

xml 复制代码

<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
    <version>5.3</version>
</dependency>

示例场景

我们将创建一个简单的Java类，向指定URL发送带有JSON数据的POST请求，并打印响应。

JSONPlaceholder API

我们将使用JSONPlaceholder API作为示例。

该API提供了模拟在线RESTful端点，用于测试和原型设计。POST请求的URL为：
https://jsonplaceholder.typicode.com/posts

发送POST请求的Java类

创建名为HttpClientPostExample的类，并使用以下代码：

java 复制代码

import org.apache.hc.client5.http.classic.methods.HttpPost;
import org.apache.hc.client5.http.classic.methods.CloseableHttpResponse;
import org.apache.hc.client5.http.impl.classic.CloseableHttpClient;
import org.apache.hc.client5.http.impl.classic.HttpClients;
import org.apache.hc.core5.http.ContentType;
import org.apache.hc.core5.http.io.entity.EntityUtils;
import org.apache.hc.core5.http.io.entity.StringEntity;

public class HttpClientPostExample {

    public static void main(String[] args) {
        String url = "https://jsonplaceholder.typicode.com/posts";
        String json = "{\"title\":\"foo\",\"body\":\"bar\",\"userId\":1}";

        // 创建HttpClient实例
        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            // 创建HttpPost请求
            HttpPost request = new HttpPost(url);

            // 设置JSON负载
            StringEntity entity = new StringEntity(json, ContentType.APPLICATION_JSON);
            request.setEntity(entity);

            // 设置请求头
            request.setHeader("Accept", "application/json");
            request.setHeader("Content-type", "application/json");

            // 执行请求
            try (CloseableHttpResponse response = httpClient.execute(request)) {
                // 获取响应状态码
                System.out.println("响应码: " + response.getCode());

                // 获取响应内容
                String content = EntityUtils.toString(response.getEntity());
                System.out.println("响应内容: \n" + content);
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

说明

添加Maven依赖 ：org.apache.httpcomponents.client5:httpclient5 依赖提供了使用Apache HttpClient创建和执行HTTP请求所需的类。
创建HttpClient实例 ：CloseableHttpClient httpClient = HttpClients.createDefault(); 使用默认配置创建了一个CloseableHttpClient实例。
创建HttpPost请求 ：HttpPost request = new HttpPost(url); 为指定URL创建了一个HttpPost请求。
设置JSON负载 ：StringEntity entity = new StringEntity(json, ContentType.APPLICATION_JSON); 创建了一个包含JSON数据的StringEntity，并将内容类型设置为application/json；request.setEntity(entity); 将实体（负载）设置到POST请求中。
设置请求头 ：通过调用setHeader方法设置了Accept和Content-type头部信息。
执行请求 ：try (CloseableHttpResponse response = httpClient.execute(request)) { ... } 执行POST请求并获取响应。
获取响应状态码 ：System.out.println("响应码: " + response.getCode()); 打印HTTP响应的状态码。
获取响应内容 ：String content = EntityUtils.toString(response.getEntity()); 将响应实体转换为字符串并打印内容。

运行示例

只需运行HttpClientPostExample类，你就能在控制台看到响应状态码和响应内容。

示例输出

响应码: 201
响应内容: 
{
  "title": "foo",
  "body": "bar",
  "userId": 1,
  "id": 101
}

额外配置

设置自定义头部 ：可以通过HttpPost对象上的setHeader方法设置POST请求的自定义头部。
处理重定向 ：默认情况下，Apache HttpClient会自动处理重定向。你可以通过自定义HttpClientBuilder来调整这种行为。
设置超时 ：可以使用RequestConfig来设置连接和套接字超时。

结论

使用Apache HttpClient发送POST HTTP请求既简单又灵活。

按照本教程，你现在应该能够创建并执行POST请求、处理响应以及定制HTTP请求和响应过程中的各种方面了。

Apache HttpClient提供了一整套功能，使其成为处理Java应用程序中HTTP操作的优秀选择。

JSONPlaceholder API作为一个实用且方便的来源，可用于测试和原型化你的HTTP请求。