Java的HttpClient中使用POST請求傳遞參數(shù)兩種常見方式

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

Apache HttpClient為開發(fā)者提供了豐富的接口,用于管理HTTP連接并執(zhí)行請求,下面這篇文章主要介紹了Java的HttpClient中使用POST請求傳遞參數(shù)兩種常見方式,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下

方法 1：通過請求體傳遞參數(shù)（JSON 格式，推薦用于 RPC）

這是 RPC 中最常見的方式，參數(shù)以 JSON 格式放在請求體中發(fā)送。

示例代碼

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) {
        // 目標(biāo) RPC 服務(wù)的 URL
        String url = "http://example.com/api/rpc";

        // 定義要傳遞的參數(shù)（JSON 格式）
        String jsonParams = "{\"method\":\"sayHello\",\"params\":{\"name\":\"張三\",\"age\":25},\"id\":1}";

        try {
            // 創(chuàng)建 HttpClient 實例
            CloseableHttpClient httpClient = HttpClients.createDefault();

            // 創(chuàng)建 POST 請求
            HttpPost httpPost = new HttpPost(url);

            // 設(shè)置請求頭
            httpPost.setHeader("Content-Type", "application/json");
            httpPost.setHeader("Accept", "application/json");

            // 設(shè)置請求體（JSON 參數(shù)）
            StringEntity entity = new StringEntity(jsonParams, "UTF-8");
            httpPost.setEntity(entity);

            // 執(zhí)行請求并獲取響應(yīng)
            try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
                int statusCode = response.getStatusLine().getStatusCode();
                System.out.println("狀態(tài)碼: " + statusCode);

                String responseBody = EntityUtils.toString(response.getEntity(), "UTF-8");
                System.out.println("響應(yīng)內(nèi)容: " + responseBody);
            }

            // 關(guān)閉 HttpClient
            httpClient.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

說明

參數(shù)構(gòu)造：jsonParams 是 JSON 字符串，包含 RPC 的方法名（method）、參數(shù)（params）和 ID（id）。你可以根據(jù)需要調(diào)整 params 中的內(nèi)容，比如添加更多鍵值對。
請求體：使用 StringEntity 將 JSON 字符串設(shè)置為請求體。
適用場景：這種方式適合復(fù)雜的參數(shù)結(jié)構(gòu)，尤其是在 RPC 中需要傳遞嵌套對象時。

方法 2：通過表單參數(shù)傳遞（鍵值對形式）

如果你的 RPC 服務(wù)支持表單參數(shù)（類似于 application/x-www-form-urlencoded），可以用鍵值對的方式傳遞參數(shù)。

示例代碼

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) {
        // 目標(biāo) RPC 服務(wù)的 URL
        String url = "http://example.com/api/rpc";

        try {
            // 創(chuàng)建 HttpClient 實例
            CloseableHttpClient httpClient = HttpClients.createDefault();

            // 創(chuàng)建 POST 請求
            HttpPost httpPost = new HttpPost(url);

            // 定義表單參數(shù)
            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"));

            // 設(shè)置請求體（表單參數(shù)）
            UrlEncodedFormEntity entity = new UrlEncodedFormEntity(params, "UTF-8");
            httpPost.setEntity(entity);

            // 設(shè)置請求頭（可選）
            httpPost.setHeader("Content-Type", "application/x-www-form-urlencoded");

            // 執(zhí)行請求并獲取響應(yīng)
            try (CloseableHttpResponse response = httpClient.execute(httpPost)) {
                int statusCode = response.getStatusLine().getStatusCode();
                System.out.println("狀態(tài)碼: " + statusCode);

                String responseBody = EntityUtils.toString(response.getEntity(), "UTF-8");
                System.out.println("響應(yīng)內(nèi)容: " + responseBody);
            }

            // 關(guān)閉 HttpClient
            httpClient.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

說明

參數(shù)構(gòu)造：使用 List<NameValuePair> 定義鍵值對形式的參數(shù)。
請求體：通過 UrlEncodedFormEntity 將參數(shù)編碼為表單格式。
適用場景：適合簡單的鍵值對參數(shù)，不支持復(fù)雜的嵌套結(jié)構(gòu)。

兩種方法的對比

特性	JSON 請求體	表單參數(shù)
數(shù)據(jù)格式	JSON（如 `{"key":"value"}`）	鍵值對（如 `key=value`）
復(fù)雜性	支持嵌套對象、數(shù)組等	僅支持簡單鍵值對
Content-Type	`application/json`	`application/x-www-form-urlencoded`
RPC 適用性	更常用，靈活性高	較少用，適合簡單場景

注意事項

服務(wù)端要求：確認(rèn)你的 RPC 服務(wù)接受哪種參數(shù)格式（JSON 或表單），并相應(yīng)調(diào)整代碼。
參數(shù)動態(tài)化：在實際應(yīng)用中，參數(shù)可能是動態(tài)生成的，可以從方法參數(shù)或?qū)ο笾袠?gòu)建 JSON/表單數(shù)據(jù)。
- 例如，使用 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));
```
調(diào)試：可以用工具（如 Postman）先測試服務(wù)端接口，確保參數(shù)格式正確。

如果你有具體的參數(shù)結(jié)構(gòu)或服務(wù)端要求，可以告訴我，我?guī)湍氵M(jìn)一步優(yōu)化代碼！有什么問題嗎？

總結(jié)

到此這篇關(guān)于Java的HttpClient中使用POST請求傳遞參數(shù)兩種常見方式的文章就介紹到這了,更多相關(guān)Java HttpClient用POST請求傳遞參數(shù)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: