如何使用Apache HttpClient发送带有HTML表单数据的POST请求

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

它支持各种HTTP方法，并能处理不同类型的请求体，包括HTML表单数据。

本教程将演示如何使用Apache HttpClient发送带有HTML表单数据的POST请求。

Maven依赖

要使用Apache HttpClient，您需要在pom.xml文件中添加以下依赖项：

xml 复制代码

<!-- https://mvnrepository.com/artifact/org.apache.httpcomponents.client5/httpclient5 -->
<dependency>
    <groupId>org.apache.httpcomponents.client5</groupId>
    <artifactId>httpclient5</artifactId>
    <version>5.3</version>
</dependency>

示例场景

我们将创建一个简单的Java类，该类向指定URL发送包含HTML表单数据的POST请求，并打印响应。

JSONPlaceholder API

对于此示例，我们将使用JSONPlaceholder API。

尽管它主要用于JSON请求，但它也可以接受表单数据以进行测试。

POST端点的URL为：

复制代码

https://jsonplaceholder.typicode.com/posts

发送HTML表单POST请求的Java类

创建一个名为HttpClientFormPostExample的类，并使用以下代码：

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.io.entity.EntityUtils;
import org.apache.hc.core5.http.io.entity.StringEntity;
import org.apache.hc.core5.http.ContentType;

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

import org.apache.hc.core5.http.NameValuePair;
import org.apache.hc.core5.http.message.BasicNameValuePair;
import org.apache.hc.core5.net.URLEncodedUtils;

public class HttpClientFormPostExample {

    public static void main(String[] args) {
        String url = "https://jsonplaceholder.typicode.com/posts";

        // 创建HttpClient
        try (CloseableHttpClient httpClient = HttpClients.createDefault()) {
            
            // 创建HttpPost请求
            HttpPost request = new HttpPost(url);
            
            // 设置表单数据
            List<NameValuePair> params = new ArrayList<>();
            params.add(new BasicNameValuePair("title", "foo"));
            params.add(new BasicNameValuePair("body", "bar"));
            params.add(new BasicNameValuePair("userId", "1"));
            String form = URLEncodedUtils.format(params, "UTF-8");
            StringEntity entity = new StringEntity(form, ContentType.APPLICATION_FORM_URLENCODED);
            request.setEntity(entity);
            
            // 设置头部
            request.setHeader("Accept", "application/json");
            request.setHeader("Content-type", "application/x-www-form-urlencoded");
            
            // 执行请求
            try (CloseableHttpResponse response = httpClient.execute(request)) {
                
                // 获取HTTP响应状态
                System.out.println("Response Code: " + response.getCode());
                
                // 获取HTTP响应内容
                String content = EntityUtils.toString(response.getEntity());
                System.out.println("Response Content: \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请求。
设置表单数据 ：创建一个代表表单字段的NameValuePair对象列表，然后使用URLEncodedUtils.format对表单数据进行URL编码。接着创建一个StringEntity，并设置其内容类型为application/x-www-form-urlencoded。
设置头部 ：设置Accept头为application/json，以及Content-type头为application/x-www-form-urlencoded。
执行请求 ：通过httpClient.execute(request)执行POST请求，并获取响应。
获取HTTP响应状态：打印HTTP响应的状态码。
获取HTTP响应内容：将响应实体转换为字符串，并打印内容。

运行示例

要运行示例，只需执行HttpClientFormPostExample类。您应该会在控制台看到状态码和响应内容。

示例输出

复制代码

Response Code: 201
Response Content: 
{
  "title": "foo",
  "body": "bar",
  "userId": "1",
  "id": 101
}

额外配置

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

总结

使用Apache HttpClient发送HTML表单POST请求非常方便。

遵循本教程后，能够创建和执行带有表单数据的POST请求、处理响应，并定制HTTP请求和响应过程。

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

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