标题：Java实现带JSON体的POST请求方法详解
关键词：Java POST请求, JSON数据, HttpURLConnection, 网络编程, API调用
描述：本文详细介绍如何在Java中构建并发送带有JSON请求体的POST方法，涵盖HttpURLConnection的使用、JSON处理及异常处理机制，帮助开发者高效完成API交互。

正文：

在实际开发中，我们经常需要通过Java程序与外部API进行数据交互，其中POST请求配合JSON格式的请求体是最常见的场景之一。与简单的GET请求不同，带Body的POST请求需要构建数据体、设置请求头并处理连接细节。下面将通过完整示例展示如何用Java原生方式实现这一功能。

首先需要明确核心实现思路：通过HttpURLConnection建立连接，设置请求方法为POST，添加Content-Type头声明JSON格式，最后将JSON字符串写入输出流。值得注意的是，要正确处理中文编码和连接资源释放。

以下是基础实现代码示例：

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public class JsonPostRequest {
    public static String sendPost(String url, String jsonBody) throws Exception {
        // 创建连接对象
        HttpURLConnection connection = (HttpURLConnection) new URL(url).openConnection();
        
        // 设置请求属性
        connection.setRequestMethod("POST");
        connection.setRequestProperty("Content-Type", "application/json; charset=UTF-8");
        connection.setRequestProperty("Accept", "application/json");
        connection.setDoOutput(true);
        connection.setDoInput(true);

        // 写入请求体
        try (OutputStream os = connection.getOutputStream()) {
            byte[] input = jsonBody.getBytes(StandardCharsets.UTF_8);
            os.write(input, 0, input.length);
        }

        // 读取响应
        StringBuilder response = new StringBuilder();
        try (BufferedReader br = new BufferedReader(
            new InputStreamReader(connection.getInputStream(), StandardCharsets.UTF_8))) {
            String responseLine;
            while ((responseLine = br.readLine()) != null) {
                response.append(responseLine.trim());
            }
        }
        
        // 断开连接
        connection.disconnect();
        return response.toString();
    }

    public static void main(String[] args) {
        String apiUrl = "https://api.example.com/endpoint";
        String jsonData = "{\"title\":\"测试标题\",\"content\":\"这是一段示例内容\"}";
        
        try {
            String result = sendPost(apiUrl, jsonData);
            System.out.println("服务器响应: " + result);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

这个示例中，我们首先创建HttpURLConnection对象并配置基础参数。setDoOutput(true)允许向连接写入数据，setRequestProperty设置请求头告知服务器传输的是JSON格式数据。关键点在于通过输出流将JSON字节数据写入连接，随后通过输入流读取服务器返回的响应内容。

对于更复杂的应用场景，建议考虑以下优化措施：首先添加连接超时设置防止网络阻塞，使用connection.setConnectTimeout(5000)和setReadTimeout(5000)可分别设置连接和读取超时时间。其次需要完善异常处理机制，特别是对于HTTP错误状态码的处理，可以通过connection.getResponseCode()获取状态码，非200状态时需要读取错误流：

if (connection.getResponseCode() != 200) {
    BufferedReader errorReader = new BufferedReader(
        new InputStreamReader(connection.getErrorStream(), StandardCharsets.UTF_8));
    String errorLine;
    while ((errorLine = errorReader.readLine()) != null) {
        System.err.println(errorLine);
    }
}

此外，对于大型项目建议使用更高级的客户端库如OkHttp或Apache HttpClient，这些库提供连接池管理、自动重试等企业级功能。但理解原生实现方式有助于掌握底层原理，在处理某些受限环境时尤其有用。

值得注意的是JSON数据的构建方式，示例中直接使用字符串拼接，实际项目推荐使用Jackson或Gson等库构建JSON对象，这样既能避免语法错误，也能正确处理特殊字符转义。例如使用Jackson库：

ObjectMapper mapper = new ObjectMapper();
ObjectNode jsonNode = mapper.createObjectNode();
jsonNode.put("title", "测试标题");
jsonNode.put("content", "这是一段示例内容");
String jsonData = mapper.writeValueAsString(jsonNode);

最后需要强调连接资源管理的重要性，示例中使用try-with-resources语法确保流正确关闭，这是避免资源泄漏的关键。在实际生产环境中还应加入重试机制和日志记录，以便跟踪请求状态和诊断问题。

掌握Java发送POST请求与JSON数据交互的技术，能够为微服务调用、第三方API集成等场景提供基础支持，是现代Java开发者必备的技能之一。通过合理优化和错误处理，可以构建出稳定可靠的数据传输通道。