Java代码发送post请求实现方式

在Ja va开发中，调用外部接口是家常便饭。其中，发送JSON格式数据的POST请求尤为常见，比如与第三方服务进行数据同步或交互。今天，我们就来拆解一下这个过程的完整实现，从工具类准备到具体调用，一步步讲清楚。

1、首先引用工具类HttpClientUtil

工欲善其事，必先利其器。一个健壮且可复用的HTTP工具类是高效开发的基础。下面这个HttpClientUtil.doPost方法，封装了使用Apache HttpClient发送POST请求的核心逻辑，支持自定义请求头和JSON请求体，并处理了SSL连接等细节。

/*
 * 利用HttpClient进行post请求的工具类
 */
public class HttpClientUtil {
    public String doPost(String url, Map headerMap, String jsonText, String charset) {
        HttpClient httpClient = null;
        HttpPost httpPost = null;
        String result = null;
        InputStream in = null;
        try {
            httpClient = SSLClientFactory.createSSLClientDefault();
            httpPost = new HttpPost(url);
            // 设置参数
            Iterator> iterator = headerMap.entrySet().iterator();
            Entry elem = null;
            while (iterator.hasNext()) {
                elem = iterator.next();
                httpPost.addHeader(elem.getKey(), elem.getValue());
            }
            if (StringUtils.isNotBlank(jsonText)) {
                byte[] bytes = jsonText.getBytes(HTTP.UTF_8);
                ByteArrayEntity se = new ByteArrayEntity(bytes);
                httpPost.setEntity(se);
            }
            HttpResponse response = httpClient.execute(httpPost);
            if (response != null) {
                HttpEntity resEntity = response.getEntity();
                if (resEntity != null) {
                    in=resEntity.getContent();
                    result = EntityUtils.toString(resEntity, charset);
                }
            }
        } catch (Exception ex) {
        }
        finally
        {
            if (in != null){
                try
                {
                    in.close ();
                }
                catch (IOException e)
                {
                    e.printStackTrace ();
                }
            }
        }
        return result;
    }
}

2、获取 访问地址、请求头、json格式的请求体

有了工具，下一步就是准备“弹药”。一次标准的API调用，离不开三个核心要素：接口地址（URL）、请求头（Headers）和请求体（Body）。这里以一个用户信息变更接口为例，展示了如何构造这些参数。特别注意，请求头中常包含用于身份验证和防重放的签名（signature）、时间戳（timestamp）等字段。

        //获取接口地址
        String url="http://external.rmcp-zsh.bosafe.com/api/v1/ztexternal/user/change";
        //获取请求头
        Map headerMap = new HashMap();
        headerMap.put("appId", appId);
        headerMap.put("randomNumber",s);
        headerMap.put("timestamp", strTime);
        headerMap.put("signature", w );
        headerMap.put("Content-Type", "application/json");
        //获取请求体
        JSONObject obj = new JSONObject();
        obj.put("appId", appId);
        //将待同步对象集合转换为json数据
        JSONArray userList = JSONUtil.parseArray(split);
        //设置请求体参数
        obj.put("userList",userList);

3、利用工具类HttpClientUtil 访问 并返回结果

万事俱备，只欠东风。最后一步就是调用我们准备好的工具类，发起请求并处理返回结果。这个过程通常很简单，但关键在于对返回结果的解析和异常处理，确保业务的稳定性。

HttpClientUtil httpClientUtil = new HttpClientUtil();
//发送post请求
String results = httpClientUtil.doPost(url, headerMap, obj.toJSONString(), Constants.UTF8);
//返回结果
JSONObject resultJson = JSONObject.parseObject(results);
String status =resultJson.getString("status");

总结

总的来说，使用Ja va发送JSON格式的POST请求，核心思路就是“封装工具、构造参数、执行调用”。掌握这个模式，绝大多数HTTP接口调用场景都能从容应对。希望这套清晰的步骤和代码示例，能为你今后的开发工作提供一个可靠的参考。