@[TOC](深入解析 JSON.toJSONString() 的用法与实例)

博主 默语带您 Go to New World.
✍ 个人主页—— 默语 的博客👦🏻 优秀内容
《java 面试题大全》
《java 专栏》
《idea技术专区》
《spring boot 技术专区》
《MyBatis从入门到精通》
《23种设计模式》
《经典算法学习》
《spring 学习》
《MYSQL从入门到精通》数据库是开发者必会基础之一~
🍩惟余辈才疏学浅，临摹之作或有不妥之处，还请读者海涵指正。☕🍭
🪁 吾期望此文有资助于尔，即使粗浅难及深广，亦备添少许微薄之助。苟未尽善尽美，敬请批评指正，以资改进。！💻⌨

---

默语是谁？

大家好，我是 默语，别名默语博主，擅长的技术领域包括Java、运维和人工智能。我的技术背景扎实，涵盖了从后端开发到前端框架的各个方面，特别是在Java 性能优化、多线程编程、算法优化等领域有深厚造诣。

目前，我活跃在CSDN、掘金、阿里云和 51CTO等平台，全网拥有超过10万的粉丝，总阅读量超过1400 万。统一 IP 名称为 默语 或者 默语博主。我是 CSDN 博客专家、阿里云专家博主和掘金博客专家，曾获博客专家、优秀社区主理人等多项荣誉，并在 2023 年度博客之星评选中名列前 50。我还是 Java 高级工程师、自媒体博主，北京城市开发者社区的主理人，拥有丰富的项目开发经验和产品设计能力。希望通过我的分享，帮助大家更好地了解和使用各类技术产品，在不断的学习过程中，可以帮助到更多的人，结交更多的朋友.

---

我的博客内容涵盖广泛，主要分享技术教程、Bug解决方案、开发工具使用、前沿科技资讯、产品评测与使用体验。我特别关注云服务产品评测、AI 产品对比、开发板性能测试以及技术报告，同时也会提供产品优缺点分析、横向对比，并分享技术沙龙与行业大会的参会体验。我的目标是为读者提供有深度、有实用价值的技术洞察与分析。

---

深入解析 JSON.toJSONString() 的用法与实例

摘要

JSON.toJSONString() 是 fastjson 库中最常用的方法之一，用于将 Java 对象序列化为 JSON 字符串格式。这一功能在 Web 开发、数据存储与交互中尤为重要。本篇博客将以通俗易懂的方式，详细讲解 JSON.toJSONString() 的核心用法及注意事项，并通过多个实例帮助小白用户快速上手。

---

引言

什么是 JSON？

JSON（JavaScript Object Notation）是一种轻量级的数据交换格式，具有以下特点：

• 易于阅读和书写：格式简洁明了。
• 广泛兼容性：支持多种编程语言。
• 高效传输：数据体积小，适合网络通信。

在 Java 开发中，fastjson 是一款高性能的 JSON 解析库，JSON.toJSONString() 方法是其核心功能之一，主要用于将 Java 对象转化为 JSON 格式。

---

正文

一、JSON.toJSONString() 方法的定义与基本用法

方法定义

JSON.toJSONString(Object object) 是 fastjson 提供的静态方法，用于将任意 Java 对象序列化为 JSON 字符串。

public static String toJSONString(Object object);

参数说明

• object：需要序列化的 Java 对象，可以是基本类型、集合、POJO（Plain Old Java Object，普通 Java 对象）等。

返回值

返回对象的 JSON 字符串表示形式。

---

二、简单实例：将对象转化为 JSON 字符串

1. 序列化基本数据类型

import com.alibaba.fastjson.JSON;

public class Main {
    public static void main(String[] args) {
        int number = 42;
        String jsonString = JSON.toJSONString(number);

        System.out.println("JSON String: " + jsonString);
    }
}

输出：

JSON String: 42

2. 序列化 Java 对象

import com.alibaba.fastjson.JSON;

class Person {
    private String name;
    private int age;

    // 构造器
    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    // Getters & Setters
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

public class Main {
    public static void main(String[] args) {
        Person person = new Person("默语", 28);
        String jsonString = JSON.toJSONString(person);

        System.out.println("JSON String: " + jsonString);
    }
}

输出：

JSON String: {"age":28,"name":"默语"}

---

三、常见用法详解

1. 序列化集合与数组

在实际开发中，常需要将集合（如 List、Map 等）或数组序列化为 JSON 字符串。

代码示例：

import com.alibaba.fastjson.JSON;
import java.util.*;

public class Main {
    public static void main(String[] args) {
        List<String> names = Arrays.asList("Alice", "Bob", "Charlie");
        String jsonString = JSON.toJSONString(names);

        System.out.println("JSON Array: " + jsonString);
    }
}

输出：

JSON Array: ["Alice","Bob","Charlie"]

---

2. 格式化输出

JSON.toJSONString() 提供格式化选项，使 JSON 输出更加美观易读。

代码示例：

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.serializer.SerializerFeature;

public class Main {
    public static void main(String[] args) {
        Person person = new Person("默语", 28);
        String formattedJson = JSON.toJSONString(person, SerializerFeature.PrettyFormat);

        System.out.println("Formatted JSON:");
        System.out.println(formattedJson);
    }
}

输出：

Formatted JSON:
{
    "age": 28,
    "name": "默语"
}

---

3. 自定义序列化行为

可以通过 SerializerFeature 控制序列化行为，例如：

• 忽略空值字段。
• 写入默认值。

代码示例：

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.serializer.SerializerFeature;

class Person {
    private String name;
    private int age;
    private String email;

    public Person(String name, int age, String email) {
        this.name = name;
        this.age = age;
        this.email = email;
    }
}

public class Main {
    public static void main(String[] args) {
        Person person = new Person("默语", 28, null);
        String jsonString = JSON.toJSONString(person, SerializerFeature.WriteMapNullValue);

        System.out.println("JSON with Null Fields: " + jsonString);
    }
}

输出：

JSON with Null Fields: {"age":28,"email":null,"name":"默语"}

---

4. 序列化复杂嵌套对象

JSON.toJSONString() 支持序列化嵌套的 Java 对象。

代码示例：

import com.alibaba.fastjson.JSON;

class Address {
    private String city;
    private String zipcode;

    public Address(String city, String zipcode) {
        this.city = city;
        this.zipcode = zipcode;
    }
}

class Employee {
    private String name;
    private Address address;

    public Employee(String name, Address address) {
        this.name = name;
        this.address = address;
    }
}

public class Main {
    public static void main(String[] args) {
        Address address = new Address("上海", "200000");
        Employee employee = new Employee("默语", address);

        String jsonString = JSON.toJSONString(employee);
        System.out.println("Nested JSON: " + jsonString);
    }
}

输出：

Nested JSON: {"address":{"city":"上海","zipcode":"200000"},"name":"默语"}

---

四、注意事项与常见错误

1. 循环引用问题

如果对象中存在循环引用，JSON.toJSONString() 会抛出异常。这种情况下，可以使用 SerializerFeature.DisableCircularReferenceDetect 解决。

2. 字段缺失问题

只有包含 getter 方法的字段才会被序列化。如果缺少 getter，对应字段将不会出现在 JSON 中。

---

五、JSON.toJSONString() 的常见场景

• 接口开发：将 Java 对象转化为 JSON 格式，供前端或其他系统调用。
• 日志记录：以 JSON 格式记录日志，方便分析和调试。
• 数据持久化：将对象序列化为 JSON 字符串并存储在文件或数据库中。

---

总结

通过本文，我们学习了 JSON.toJSONString() 的核心功能及其丰富的应用场景。从序列化基本类型到复杂嵌套对象，这一方法在 Java 开发中的作用无可替代。希望本文的讲解能帮助小白用户迅速掌握这项技能，为开发工作增色添彩！

如果你对 fastjson 或 JSON 数据格式还有疑问，欢迎添加我的微信 （微信号：Solitudemind），一起交流探讨吧！

---

参考资料

• Fastjson 官方文档
• JSON 数据格式规范
• Java JSON 处理库对比分析

---

🪁🍁 希望本文能够给您带来一定的帮助🌸文章粗浅，敬请批评指正！🍁🐥

如对本文内容有任何疑问、建议或意见，请联系作者，作者将尽力回复并改进📓；(联系微信:Solitudemind )

点击下方名片，加入IT技术核心学习团队。一起探索科技的未来，共同成长。