java怎么发布json

Java中如何发布JSON数据：全面指南

在当今的Web开发中，JSON（JavaScript Object Notation）已成为数据交换的主流格式，因其轻量级、易读、易于解析的特点，被广泛应用于前后端数据交互、API调用等场景，Java作为企业级开发的核心语言，如何高效发布JSON数据是开发者的必备技能，本文将详细介绍Java中发布JSON数据的多种方式，从原生实现到主流框架集成，覆盖不同应用场景,帮助开发者选择最适合的方案。

Java发布JSON数据的核心步骤

无论采用何种方式，Java发布JSON数据的核心流程通常包括以下三个步骤：

1. 构建JSON数据：将Java对象（如POJO、Map、List等）转换为JSON格式的字符串。
2. 设置HTTP请求：通过HTTP客户端（如HttpURLConnection、OkHttp、RestTemplate等）构建请求，设置请求方法（POST/PUT等）、请求头（Content-Type为application/json）、请求体（JSON字符串）。
3. 发送请求并处理响应：将请求体发送到目标服务器，并接收、处理服务器返回的响应数据。

原生Java实现：HttpURLConnection + 手动JSON构建

在不依赖第三方库的情况下，可以使用Java原生的HttpURLConnection发送HTTP请求，并通过手动拼接JSON字符串或使用org.json库构建JSON数据，这种方式适用于轻量级场景,但代码相对繁琐。

手动构建JSON字符串

对于简单的JSON结构,可以直接通过字符串拼接构建JSON数据：

import java.io.OutputStream;
import java.net.HttpURLConnection;
import java.net.URL;
public class NativeJsonPublisher {
    public static void main(String[] args) throws Exception {
        // 1. 构建JSON字符串
        String jsonPayload = "{\"name\":\"张三\",\"age\":30,\"city\":\"北京\"}";
        // 2. 创建URL对象
        URL url = new URL("https://api.example.com/users");
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        // 3. 设置请求属性
        connection.setRequestMethod("POST");
        connection.setRequestProperty("Content-Type", "application/json");
        connection.setRequestProperty("Accept", "application/json");
        connection.setDoOutput(true); // 允许发送请求体
        // 4. 发送请求体
        try (OutputStream os = connection.getOutputStream()) {
            byte[] input = jsonPayload.getBytes("utf-8");
            os.write(input, 0, input.length);
        }
        // 5. 获取响应
        int responseCode = connection.getResponseCode();
        System.out.println("响应码: " + responseCode);
        if (responseCode == HttpURLConnection.HTTP_OK) {
            try (BufferedReader br = new BufferedReader(
                    new InputStreamReader(connection.getInputStream(), "utf-8"))) {
                StringBuilder response = new StringBuilder();
                String responseLine;
                while ((responseLine = br.readLine()) != null) {
                    response.append(responseLine.trim());
                }
                System.out.println("响应内容: " + response.toString());
            }
        } else {
            System.out.println("请求失败: " + connection.getResponseMessage());
        }
        connection.disconnect();
    }
}

缺点：手动拼接JSON容易出错，尤其是处理嵌套对象或数组时,代码可读性差。

使用org.json库构建JSON

为了简化JSON构建，可以引入org.json库（需添加依赖：org.json:json:20231013），通过JSONObject和JSONArray构建结构化JSON：

import org.json.JSONObject;
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.OutputStream;
public class OrgJsonPublisher {
    public static void main(String[] args) throws Exception {
        // 1. 使用JSONObject构建JSON数据
        JSONObject jsonPayload = new JSONObject();
        jsonPayload.put("name", "李四");
        jsonPayload.put("age", 25);
        jsonPayload.put("city", "上海");
        // 添加嵌套对象
        JSONObject contact = new JSONObject();
        contact.put("email", "lisi@example.com");
        contact.put("phone", "13800138000");
        jsonPayload.put("contact", contact);
        // 2. 发送HTTP请求（同上）
        URL url = new URL("https://api.example.com/users");
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setRequestMethod("POST");
        connection.setRequestProperty("Content-Type", "application/json");
        connection.setDoOutput(true);
        try (OutputStream os = connection.getOutputStream()) {
            os.write(jsonPayload.toString().getBytes("utf-8"));
        }
        // 3. 处理响应（同上）
        int responseCode = connection.getResponseCode();
        System.out.println("响应码: " + responseCode);
        connection.disconnect();
    }
}

优点：org.json提供了结构化的API，避免手动拼接的错误,适合中等复杂度的JSON构建。

使用Jackson库：高性能JSON处理

Jackson是Java生态中最流行的JSON处理库，提供高性能的JSON序列化（Java对象→JSON）和反序列化（JSON→Java对象）能力，结合HttpURLConnection或OkHttp,可以轻松实现JSON发布。

添加Jackson依赖

Maven依赖：

<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>

Gradle依赖：

implementation 'com.fasterxml.jackson.core:jackson-databind:2.15.2'

通过Jackson序列化Java对象为JSON

首先定义一个Java对象（POJO）：

public class User {
    private String name;
    private int age;
    private String city;
    // 无参构造器、getter/setter（省略）
    public User(String name, int age, String city) {
        this.name = name;
        this.age = age;
        this.city = city;
    }
    // 重写toString()（可选）
    @Override
    public String toString() {
        return "User{name='" + name + "', age=" + age + ", city='" + city + "'}";
    }
}

然后使用Jackson的ObjectMapper将POJO转换为JSON字符串，并通过HttpURLConnection发送：

import com.fasterxml.jackson.databind.ObjectMapper;
import java.net.HttpURLConnection;
import java.net.URL;
public class JacksonJsonPublisher {
    public static void main(String[] args) throws Exception {
        // 1. 创建Java对象
        User user = new User("王五", 28, "广州");
        // 2. 使用ObjectMapper转换为JSON字符串
        ObjectMapper objectMapper = new ObjectMapper();
        String jsonPayload = objectMapper.writeValueAsString(user);
        System.out.println("生成的JSON: " + jsonPayload);
        // 3. 发送HTTP请求
        URL url = new URL("https://api.example.com/users");
        HttpURLConnection connection = (HttpURLConnection) url.openConnection();
        connection.setRequestMethod("POST");
        connection.setRequestProperty("Content-Type", "application/json");
        connection.setDoOutput(true);
        try (OutputStream os = connection.getOutputStream()) {
            os.write(jsonPayload.getBytes("utf-8"));
        }
        // 4. 处理响应
        int responseCode = connection.getResponseCode();
        System.out.println("响应码: " + responseCode);
        connection.disconnect();
    }
}

优点：Jackson性能优异，支持复杂对象映射（如嵌套对象、泛型、日期格式化等），是Java JSON处理的首选库。

结合OkHttp发送JSON

OkHttp是当前最流行的HTTP客户端之一，支持同步/异步请求，简化了HTTP操作,首先添加OkHttp依赖：

Maven：

<dependency>
    <groupId>com.squareup.okhttp3</groupId>
    <artifactId>okhttp</artifactId>
    <version>4.12.0</version>
</dependency>

使用OkHttp + Jackson发布JSON：

import com.fasterxml.jackson.databind.ObjectMapper;
import okhttp3.*;
import java.io.IOException;
public class OkHttpJsonPublisher {
    private static final String API_URL = "https://api.example.com/users";
    private static final OkHttpClient client = new OkHttpClient();
    private static final ObjectMapper objectMapper = new ObjectMapper();
    public static void main(String[] args) throws Exception {
        // 1. 创建Java对象并转换为JSON
        User user = new User("赵六", 32, "深圳");
        String jsonPayload = objectMapper.writeValueAsString(user);
        // 2. 构建RequestBody
        MediaType JSON = MediaType.parse("application/json; charset=utf-8");
        RequestBody body = RequestBody.create(jsonPayload, JSON);
        // 3. 构建请求
        Request request = new Request.Builder()
                .url(API_URL)
                .post(body)
                .header("Accept", "application/json")
                .build();
        // 4. 发送请求并处理响应
        try (Response response = client.newCall(request).execute()) {
            if (response.isSuccessful()) {
                System.out.println("响应内容: " + response.body().string());
            } else {
                System.out.println("请求失败: " + response.code() + " - "