Java的HttpClient中使用POST请求传递参数两种常见方式

更新时间：2025年06月10日 09:11:59 作者：＋720

Apache HttpClient为开发者提供了丰富的接口,用于管理HTTP连接并执行请求,下面这篇文章主要介绍了Java的HttpClient中使用POST请求传递参数两种常见方式,文中通过代码介绍的非常详细,需要的朋友可以参考下

方法 1：通过请求体传递参数（JSON 格式，推荐用于 RPC）

这是 RPC 中最常见的方式，参数以 JSON 格式放在请求体中发送。

示例代码

import org.apache.http.client.methods.CloseableHttpResponse;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.entity.StringEntity;
import org.apache.http.impl.client.CloseableHttpClient;
import org.apache.http.impl.client.HttpClients;
import org.apache.http.util.EntityUtils;

import java.io.IOException;

public class RpcPostWithJsonParams {
    public static void main(String[] args) {
        // 目标 RPC 服务的 URL
        String url = "http://example.com/api/rpc";

        // 定义要传递的参数（JSON 格式）
        String jsonParams = "{\"method\":\"sayHello\",\"params\":{\"name\":\"张三\",\"age\":25},\"id\":1}";

        try {
            // 创建 HttpClient 实例
            CloseableHttpClient httpClient = HttpClients.createDefault();

            // 创建 POST 请求
            HttpPost httpPost = new HttpPost(url);

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

            // 设置请求体（JSON 参数）
            StringEntity entity = new StringEntity(jsonParams, "UTF-8");
            httpPost.setEntity(entity);

            // 执行请求并获取响应
            try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
                int statusCode = response.getStatusLine().getStatusCode();
                System.out.println("状态码: " + statusCode);

                String responseBody = EntityUtils.toString(response.getEntity(), "UTF-8");
                System.out.println("响应内容: " + responseBody);
            }

            // 关闭 HttpClient
            httpClient.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

说明

参数构造：jsonParams 是 JSON 字符串，包含 RPC 的方法名（method）、参数（params）和 ID（id）。你可以根据需要调整 params 中的内容，比如添加更多键值对。
请求体：使用 StringEntity 将 JSON 字符串设置为请求体。
适用场景：这种方式适合复杂的参数结构，尤其是在 RPC 中需要传递嵌套对象时。

方法 2：通过表单参数传递（键值对形式）

如果你的 RPC 服务支持表单参数（类似于 application/x-www-form-urlencoded），可以用键值对的方式传递参数。

示例代码

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

import java.io.IOException;
import java.util.ArrayList;
import java.util.List;

public class RpcPostWithFormParams {
    public static void main(String[] args) {
        // 目标 RPC 服务的 URL
        String url = "http://example.com/api/rpc";

        try {
            // 创建 HttpClient 实例
            CloseableHttpClient httpClient = HttpClients.createDefault();

            // 创建 POST 请求
            HttpPost httpPost = new HttpPost(url);

            // 定义表单参数
            List<NameValuePair> params = new ArrayList<>();
            params.add(new BasicNameValuePair("method", "sayHello"));
            params.add(new BasicNameValuePair("name", "张三"));
            params.add(new BasicNameValuePair("age", "25"));
            params.add(new BasicNameValuePair("id", "1"));

            // 设置请求体（表单参数）
            UrlEncodedFormEntity entity = new UrlEncodedFormEntity(params, "UTF-8");
            httpPost.setEntity(entity);

            // 设置请求头（可选）
            httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded");

            // 执行请求并获取响应
            try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
                int statusCode = response.getStatusLine().getStatusCode();
                System.out.println("状态码: " + statusCode);

                String responseBody = EntityUtils.toString(response.getEntity(), "UTF-8");
                System.out.println("响应内容: " + responseBody);
            }

            // 关闭 HttpClient
            httpClient.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

说明

参数构造：使用 List<NameValuePair> 定义键值对形式的参数。
请求体：通过 UrlEncodedFormEntity 将参数编码为表单格式。
适用场景：适合简单的键值对参数，不支持复杂的嵌套结构。

两种方法的对比

特性	JSON 请求体	表单参数
数据格式	JSON（如 `{"key":"value"}`）	键值对（如 `key=value`）
复杂性	支持嵌套对象、数组等	仅支持简单键值对
Content-Type	`application/json`	`application/x-www-form-urlencoded`
RPC 适用性	更常用，灵活性高	较少用，适合简单场景

注意事项

服务端要求：确认你的 RPC 服务接受哪种参数格式（JSON 或表单），并相应调整代码。

参数动态化：在实际应用中，参数可能是动态生成的，可以从方法参数或对象中构建 JSON/表单数据。

例如，使用 JSONObject（如 Jackson 或 Gson）生成 JSON：

import com.fasterxml.jackson.databind.ObjectMapper;
ObjectMapper mapper = new ObjectMapper();
String jsonParams = mapper.writeValueAsString(new MyRpcRequest("sayHello", Map.of("name", "张三"), 1));

调试：可以用工具（如 Postman）先测试服务端接口，确保参数格式正确。

如果你有具体的参数结构或服务端要求，可以告诉我，我帮你进一步优化代码！有什么问题吗？

总结

到此这篇关于Java的HttpClient中使用POST请求传递参数两种常见方式的文章就介绍到这了,更多相关Java HttpClient用POST请求传递参数内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

详解Java读取本地文件并显示在JSP文件中
这篇文章主要介绍了详解Java读取本地文件并显示在JSP文件中的相关资料,这里提供实例帮助大家实现这样的功能，希望能帮助到大家，需要的朋友可以参考下
2017-08-08
Java代码注释规范详解
代码附有注释对程序开发者来说非常重要，随着技术的发展，在项目开发过程中，必须要求程序员写好代码注释，这样有利于代码后续的编写和使用。下面给大家分享java代码注释的规范，需要的朋友参考下
2016-02-02
Java 从网上下载文件的几种方式实例代码详解
本文通过实例代码给大家介绍了java从网上下载文件的几种方式，非常不错，具有参考借鉴价值，需要的的朋友参考下吧
2017-08-08
java web图片上传和文件上传实例
本篇文章主要介绍了java web图片上传和文件上传实例，具有一定的参考价值，有需要的可以了解一下。
2016-11-11
SpringBoot如何优雅地使用Swagger2
这篇文章主要介绍了SpringBoot如何优雅地使用Swagger2,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
2020-07-07
java-springboot3.2+多数据源+hikari连接池的配置使用
本文给大家介绍java-springboot3.2+多数据源+hikari连接池的配置使用,本文结合实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧
2025-11-11
SpringBoot没有主清单属性的解决方法
在本篇文章里小编给大家整理的是关于解决SpringBoot没有主清单属性知识点，需要的朋友们学习下。
2019-11-11
Java调用Creo 2.0读取/修改模型参数的实战指南
本文详细讲解了使用Java调用Creo2.0实现.prt模型参数读取与修改的方法,强调方向大于努力,不可完全依赖AI；提供实测可用代码、操作步骤及避坑要点；涵盖环境配置、关键注意事项、执行步骤与常见问题排查等内容,适合Creel.0二次开发新手参考,需要的朋友可以参考下
2026-05-05
springboot集成rabbitMQ之对象传输的方法
这篇文章主要介绍了springboot集成rabbitMQ之对象传输的方法，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-12-12
java实现输出字符串中第一个出现不重复的字符详解
这篇文章主要介绍了java实现输出字符串中第一个出现不重复的字符详解的相关资料,需要的朋友可以参考下
2017-04-04