Java常用的JSON

皮卡龙2025-12-14 23:59

在 Java 中把对象转换为 JSON 对象（或 JSON 字符串），核心依赖 JSON 解析库，主流有 Jackson （Spring 内置）、FastJSON （阿里）、Gson（Google），以下是三种库的完整实现方案，包含核心 API、示例代码和避坑指南：

一、先明确："JSON 对象" 的两种形态

  1. JSON 字符串 ：最常用（如 {"name":"张三","age":20}），用于网络传输、存储；
  2. JSON 对象（树形结构） ：如 Jackson 的 JsonNode、FastJSON 的 JSONObject，用于动态操作 JSON 节点（如新增 / 删除字段）。

二、方案 1：Jackson（Spring Boot 内置，推荐）

Spring Boot 项目默认集成 Jackson，无需额外引入核心依赖（非 Spring 项目需手动引入）。

1. 依赖引入（非 Spring 项目）
复制代码 
<!-- Jackson 核心依赖 -->
<dependency>
    <groupId>com.fasterxml.jackson.core</groupId>
    <artifactId>jackson-databind</artifactId>
    <version>2.15.2</version>
</dependency>
<!-- 可选：支持 JDK8+ 时间类型（LocalDateTime） -->
<dependency>
    <groupId>com.fasterxml.jackson.datatype</groupId>
    <artifactId>jackson-datatype-jsr310</artifactId>
    <version>2.15.2</version>
</dependency>
2. 核心用法
（1）对象转 JSON 字符串
复制代码 
import com.fasterxml.jackson.databind.ObjectMapper;
import java.util.Date;

// 测试实体类
class User {
    private String name;
    private Integer age;
    private Date createTime; // 时间字段
    // 必须有无参构造器（Jackson 反射实例化需要）
    public User() {}
    // getter/setter 必须有（Jackson 通过 getter 读取字段）
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }
    public Integer getAge() { return age; }
    public void setAge(Integer age) { this.age = age; }
    public Date getCreateTime() { return createTime; }
    public void setCreateTime(Date createTime) { this.createTime = createTime; }
}

public class JacksonDemo {
    // 全局 ObjectMapper（线程安全，建议单例）
    private static final ObjectMapper objectMapper = new ObjectMapper();

    public static void main(String[] args) throws Exception {
        // 1. 构建对象
        User user = new User();
        user.setName("张三");
        user.setAge(20);
        user.setCreateTime(new Date());

        // 2. 对象转 JSON 字符串
        String jsonStr = objectMapper.writeValueAsString(user);
        System.out.println("JSON 字符串：" + jsonStr);
        // 输出示例：{"name":"张三","age":20,"createTime":1717238400000}
    }
}
（2）对象转 JSON 树形对象（JsonNode）

用于动态操作 JSON 节点（如修改字段、判断字段是否存在）：

复制代码 
public static void main(String[] args) throws Exception {
    User user = new User();
    user.setName("张三");
    user.setAge(20);

    // 1. 对象转 JsonNode（JSON 树形对象）
    com.fasterxml.jackson.databind.JsonNode jsonNode = objectMapper.valueToTree(user);

    // 2. 操作 JsonNode
    String name = jsonNode.get("name").asText(); // 获取字段值
    int age = jsonNode.get("age").asInt();       // 转换为int
    boolean hasCreateTime = jsonNode.has("createTime"); // 判断字段是否存在

    System.out.println("name：" + name + "，age：" + age + "，有createTime？" + hasCreateTime);
    // 输出：name：张三，age：20，有createTime？false
}
（3）自定义序列化规则（如日期格式）
复制代码 
// 配置 ObjectMapper 自定义规则
objectMapper.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss")); // 日期格式
objectMapper.configure(com.fasterxml.jackson.databind.SerializationFeature.FAIL_ON_EMPTY_BEANS, false); // 忽略空对象报错
objectMapper.setSerializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include.NON_NULL); // 忽略null字段

// 转换后 JSON 示例：{"name":"张三","age":20,"createTime":"2025-06-01 10:00:00"}

三、方案 2：FastJSON（阿里，轻量高效）

FastJSON 是阿里开源的高性能 JSON 库，适合追求解析速度的场景。

1. 依赖引入
复制代码 
<!-- FastJSON 2.x 版本（推荐，性能更优） -->
<dependency>
    <groupId>com.alibaba.fastjson2</groupId>
    <artifactId>fastjson2</artifactId>
    <version>2.0.32</version>
</dependency>
<!-- 兼容 1.x 版本（如需） -->
<!--
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>fastjson</artifactId>
    <version>1.2.83</version>
</dependency>
-->
2. 核心用法
（1）对象转 JSON 字符串
复制代码 
import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.JSONWriter;
import java.util.Date;

public class FastJsonDemo {
    public static void main(String[] args) {
        User user = new User();
        user.setName("李四");
        user.setAge(25);
        user.setCreateTime(new Date());

        // 1. 基础转换
        String jsonStr = JSON.toJSONString(user);
        System.out.println("基础JSON：" + jsonStr);

        // 2. 自定义规则（忽略null、格式化日期、美化输出）
        String jsonStrCustom = JSON.toJSONString(
            user,
            JSONWriter.Feature.WriteNulls, // 显示null字段（默认忽略）
            JSONWriter.Feature.PrettyFormat, // 美化输出（换行缩进）
            JSONWriter.Feature.WriteDateUseDateFormat // 日期格式化（默认yyyy-MM-dd HH:mm:ss）
        );
        System.out.println("自定义JSON：" + jsonStrCustom);
    }
}
（2）对象转 JSON 对象（JSONObject）
复制代码 
public static void main(String[] args) {
    User user = new User();
    user.setName("李四");
    user.setAge(25);

    // 1. 对象转 JSONObject（FastJSON 树形对象）
    com.alibaba.fastjson2.JSONObject jsonObject = (com.alibaba.fastjson2.JSONObject) JSON.toJSON(user);

    // 2. 操作 JSONObject
    String name = jsonObject.getString("name");
    int age = jsonObject.getIntValue("age");
    jsonObject.put("gender", "男"); // 新增字段

    System.out.println("JSON对象：" + jsonObject);
    // 输出：{"age":25,"gender":"男","name":"李四"}
}

四、方案 3：Gson（Google，简洁易用）

Gson 是 Google 开源的 JSON 库，API 设计简洁，适合跨平台场景。

1. 依赖引入
复制代码 
<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.10.1</version>
</dependency>
2. 核心用法
（1）对象转 JSON 字符串
复制代码 
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;
import java.util.Date;

public class GsonDemo {
    // 全局 Gson（线程安全）
    private static final Gson gson = new GsonBuilder()
            .setDateFormat("yyyy-MM-dd HH:mm:ss") // 日期格式
            .serializeNulls() // 显示null字段
            .setPrettyPrinting() // 美化输出
            .create();

    public static void main(String[] args) {
        User user = new User();
        user.setName("王五");
        user.setAge(30);
        user.setCreateTime(new Date());

        // 对象转 JSON 字符串
        String jsonStr = gson.toJson(user);
        System.out.println("Gson JSON：" + jsonStr);
    }
}
（2）对象转 JSON 树形对象（JsonObject）
复制代码 
public static void main(String[] args) {
    User user = new User();
    user.setName("王五");
    user.setAge(30);

    // 1. 对象转 JsonElement（父类），强转为 JsonObject
    com.google.gson.JsonObject jsonObject = gson.toJsonTree(user).getAsJsonObject();

    // 2. 操作 JsonObject
    String name = jsonObject.get("name").getAsString();
    int age = jsonObject.get("age").getAsInt();
    jsonObject.addProperty("gender", "女"); // 新增字段

    System.out.println("Gson JSON对象：" + jsonObject);
    // 输出：{"name":"王五","age":30,"gender":"女"}
}

五、核心注意事项（避坑指南）

1. 基础要求（所有库通用）
  • 实体类必须有 无参构造器（Jackson/Gson 反射实例化需要，FastJSON 可兼容，但建议统一）；
  • 字段必须有 getter 方法（序列化时读取字段值，FastJSON 可直接读字段，但 getter 更规范）；
  • 避免循环引用（如 A 包含 B，B 包含 A），否则会报栈溢出错误：
    • Jackson：objectMapper.configure(SerializationFeature.FAIL_ON_CIRCULAR_REFERENCES, false)；
    • FastJSON：JSON.toJSONString(user, SerializerFeature.DisableCircularReferenceDetect)；
    • Gson：默认忽略循环引用（无需额外配置）。
2. 日期类型处理
  • 直接转换会得到时间戳（如 1717238400000），需手动配置日期格式（如 yyyy-MM-dd HH:mm:ss）；
  • JDK8+ 时间类型（LocalDateTime/LocalDate）：Jackson 需引入 jackson-datatype-jsr310，FastJSON/Gson 天然支持。
3. null 字段处理
  • Jackson：objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL)；
  • FastJSON：默认忽略 null，需 JSONWriter.Feature.WriteNulls 显示；
  • Gson：默认忽略 null，需 GsonBuilder.serializeNulls() 显示。

六、库的选型建议

库 优点 缺点 适用场景
Jackson Spring 内置、稳定、功能全面 性能略低于 FastJSON Spring 项目、企业级开发
FastJSON 性能最高、轻量、API 简洁 早期版本有安全漏洞（需用 2.x） 高性能场景、阿里生态项目
Gson Google 维护、跨平台、易上手 性能一般 跨平台项目、小型应用

七、总结

  1. 快速转换为 JSON 字符串 ：
    • Jackson：new ObjectMapper().writeValueAsString(obj)；
    • FastJSON：JSON.toJSONString(obj)；
    • Gson：new Gson().toJson(obj)。
  2. 转换为 JSON 树形对象 （动态操作）：
    • Jackson：objectMapper.valueToTree(obj)（JsonNode）；
    • FastJSON：(JSONObject) JSON.toJSON(obj)；
    • Gson：gson.toJsonTree(obj).getAsJsonObject()。
  3. 核心原则：Spring 项目优先用 Jackson（无需额外依赖），追求性能用 FastJSON 2.x，简单场景用 Gson。
相关推荐
云烟成雨TD10 小时前
Micrometer 系列【42】链路追踪：Span 体系 | 核心 API
java·链路追踪·micrometer
Gorway10 小时前
理解 Spring 依赖注入：从构造器注入到集合与条件 Bean
java·后端
LiLiYuan.10 小时前
【字符串常量池】
java·开发语言·面试
Sylvia33.10 小时前
从轮询到推送：足球数据API架构演进与火星数据技术拆解
java·服务器·网络·python·websocket·架构
瑞码空间10 小时前
Python爬虫进阶实战笔记
开发语言·python·计算机·python爬虫
cfm_291411 小时前
高并发系统缓存全解
java·缓存
16月6日-晴11 小时前
Java面向对象进阶—static
java·开发语言
爱跳舞的烤冷面11 小时前
自学嵌入式第16天(数据结构篇--链表进阶操作)
开发语言
持敬chijing11 小时前
PHP开发-环境搭建-安装phpstudy-vscode工具
开发语言·vscode·php
xiaohaiAIgeo11 小时前
【2026年】ASHRAE 110与EN 14175通风柜测试标准对比：进口与国产品牌性能差距
java·前端·数据库·科普知识
热门推荐
01GitHub 镜像站点02VSCode+CodeX扩展，无法启动03国内可直接用、免费额度/永久免费的大模型API清单（含 SiliconFlow、火山、阿里、智谱、百度、Kimi、DeepSeek、DMXAPI 等）042026 国产 AI 大模型横评：DeepSeek、通义千问、Kimi、文心一言、星火、豆包谁更能打？05微信历史版本含下载地址（ Windows PC | 安卓 | MAC ）及设置微信不更新06AI 编程 IDE 全景解析 2026：Agent 全面接管开发链路07历年考研数学一、数学二、数学三真题试卷及答案PDF08Agnes AI 免费 API 接入指南：文本、生图、生视频，一套接口全免费09如何新建文件夹？ 电脑新建文件夹的4种方法102026年7月AI圈大地震：GPT-5.6被政府限制、Claude入驻Slack、Anthropic自研芯片