FastJSON2 JSON 类中 toJSONString()、parseObject()、parseArray() 三个核心方法的详细使用形式说明与示例

原创 于 2025-11-07 01:03:30 发布 · 227 阅读 · 4 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#json #java #前端

好的，以下是对 FastJSON2 JSON 类中 toJSONString()、parseObject()、parseArray() 三个核心方法的详细使用形式说明与示例。

✅ FastJSON2 核心方法详解与实战示例

📌 一、toJSONString() 方法

作用：将 Java 对象序列化为 JSON 字符串。

✅ 1.1 基础形式：toJSONString(Object obj)

import com.alibaba.fastjson2.JSON;

public class ToJsonStringExample {
    public static void main(String[] args) {
        // 定义一个简单的 JavaBean
        class Person {
            private String name;
            private int age;
            private String city;

            public Person(String name, int age, String city) {
                this.name = name;
                this.age = age;
                this.city = city;
            }
            // getter/setter (此处省略，实际项目推荐用 Lombok)
            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 String getCity() { return city; }
            public void setCity(String city) { this.city = city; }
        }

        // 创建一个 Java 对象实例
        Person person = new Person("张三", 28, "北京");

        // 将 Java 对象转换为 JSON 字符串（最基础用法）
        String jsonStr = JSON.toJSONString(person);
        System.out.println("基础序列化结果: " + jsonStr);
        // 输出: {"age":28,"city":"北京","name":"张三"}
    }
}

✅ 1.2 进阶形式：toJSONString(Object obj, JSONWriter.Feature... features)

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.config.JSONWriter;

public class ToJsonStringWithFeatureExample {
    public static void main(String[] args) {
        class User {
            private String name;
            private Integer age; // 使用包装类型，以便为 null
            private String email; // 该字段为 null

            public User(String name, Integer age) {
                this.name = name;
                this.age = age;
                // this.email = null; // 默认就是 null
            }
            // getter/setter (省略)
            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 String getEmail() { return email; }
            public void setEmail(String email) { this.email = email; }
        }

        User user = new User("李四", 30); // email 为 null

        // --- 1.2.1 默认行为：不输出 null 字段 ---
        String defaultJson = JSON.toJSONString(user);
        System.out.println("默认（不输出 null）: " + defaultJson);
        // 输出: {"age":30,"name":"李四"}

        // --- 1.2.2 使用 Feature：输出 null 字段 ---
        String withNullJson = JSON.toJSONString(user, JSONWriter.Feature.WriteMapNullValue);
        System.out.println("输出 null 字段: " + withNullJson);
        // 输出: {"age":30,"email":null,"name":"李四"}

        // --- 1.2.3 使用 Feature：格式化输出（美化） ---
        String prettyJson = JSON.toJSONString(user, JSONWriter.Feature.PrettyFormat);
        System.out.println("格式化输出:\n" + prettyJson);
        /*
        输出:
        {
            "age": 30,
            "name": "李四"
        }
        */

        // --- 1.2.4 组合多个 Feature ---
        String combinedJson = JSON.toJSONString(user,
                JSONWriter.Feature.WriteMapNullValue, // 输出 null
                JSONWriter.Feature.PrettyFormat      // 格式化
        );
        System.out.println("组合 Feature 输出:\n" + combinedJson);
        /*
        输出:
        {
            "age": 30,
            "email": null,
            "name": "李四"
        }
        */
    }
}

📌 二、parseObject() 方法

作用：将 JSON 字符串反序列化为 Java 对象。

✅ 2.1 基础形式：parseObject(String text, Class<T> clazz)

import com.alibaba.fastjson2.JSON;

public class ParseObjectBasicExample {
    public static void main(String[] args) {
        // 定义目标 JavaBean
        class Person {
            private String name;
            private int age;
            private String city;

            public Person() {} // 必须有无参构造器

            // getter/setter (省略)
            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 String getCity() { return city; }
            public void setCity(String city) { this.city = city; }
            @Override public String toString() { return "Person{" + "name='" + name + "', age=" + age + ", city='" + city + "'}"; }
        }

        // JSON 字符串
        String jsonStr = "{\"name\":\"王五\",\"age\":35,\"city\":\"上海\"}";

        // 将 JSON 字符串解析为指定的 Java 对象
        Person person = JSON.parseObject(jsonStr, Person.class);
        System.out.println("反序列化结果: " + person);
        // 输出: 反序列化结果: Person{name='王五', age=35, city='上海'}
    }
}

✅ 2.2 进阶形式：parseObject(String text, Class<T> clazz, JSONReader.Feature... features)

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.config.JSONReader;

public class ParseObjectWithFeatureExample {
    public static void main(String[] args) {
        class Person {
            private String name;
            private int age;
            // getter/setter (省略)
            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; }
            @Override public String toString() { return "Person{" + "name='" + name + "', age=" + age + '}'; }
        }

        // JSON 字符串，字段名与 JavaBean 不完全匹配（大小写不一致）
        String jsonWithWrongCase = "{\"Name\":\"赵六\",\"AGE\":29}";

        // --- 2.2.1 默认行为：严格匹配，可能失败或字段为 null ---
        Person personDefault = JSON.parseObject(jsonWithWrongCase, Person.class);
        System.out.println("默认解析结果: " + personDefault);
        // 输出: 默认解析结果: Person{name='null', age=0} (字段名不匹配导致映射失败)

        // --- 2.2.2 使用 Feature：忽略字段名大小写 ---
        Person personIgnoreCase = JSON.parseObject(jsonWithWrongCase, Person.class,
                JSONReader.Feature.IgnoreCase);
        System.out.println("忽略大小写解析结果: " + personIgnoreCase);
        // 输出: 忽略大小写解析结果: Person{name='赵六', age=29}
    }
}

✅ 2.3 泛型形式：parseObject(String text, TypeReference<T> type)

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.TypeReference;

import java.util.List;
import java.util.Map;

public class ParseObjectGenericExample {
    public static void main(String[] args) {
        class User {
            private String name;
            private int age;
            // getter/setter (省略)
            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; }
            @Override public String toString() { return "User{" + "name='" + name + "', age=" + age + '}'; }
        }

        // --- 2.3.1 解析泛型 List ---
        String listJson = "[{\"name\":\"用户A\",\"age\":25},{\"name\":\"用户B\",\"age\":30}]";
        // 使用 TypeReference 来捕获泛型信息，避免运行时类型擦除
        List<User> userList = JSON.parseObject(listJson, new TypeReference<List<User>>() {});
        System.out.println("解析 List<User> 结果: " + userList);
        // 输出: 解析 List<User> 结果: [User{name='用户A', age=25}, User{name='用户B', age=30}]

        // --- 2.3.2 解析泛型 Map ---
        String mapJson = "{\"user1\":{\"name\":\"管理员\",\"age\":35},\"user2\":{\"name\":\"访客\",\"age\":20}}";
        Map<String, User> userMap = JSON.parseObject(mapJson, new TypeReference<Map<String, User>>() {});
        System.out.println("解析 Map<String, User> 结果: " + userMap.get("user1"));
        // 输出: 解析 Map<String, User> 结果: User{name='管理员', age=35}
    }
}

📌 三、parseArray() 方法

作用：将 JSON 数组字符串反序列化为 JSONArray 对象或 List<T>。

✅ 3.1 基础形式：parseArray(String text)

import com.alibaba.fastjson2.JSONArray;
import com.alibaba.fastjson2.JSON;

public class ParseArrayBasicExample {
    public static void main(String[] args) {
        // JSON 数组字符串
        String jsonArrayStr = "[\"apple\", \"banana\", \"orange\"]";

        // 将 JSON 数组字符串解析为 JSONArray 对象（类似 List<Object>）
        JSONArray jsonArray = JSON.parseArray(jsonArrayStr);
        System.out.println("解析为 JSONArray: " + jsonArray);
        System.out.println("数组大小: " + jsonArray.size());
        System.out.println("第一个元素: " + jsonArray.getString(0)); // 自动转换为 String
        // 输出: 解析为 JSONArray: ["apple", "banana", "orange"]
        // 输出: 数组大小: 3
        // 输出: 第一个元素: apple
    }
}

✅ 3.2 泛型形式：parseArray(String text, Class<T> clazz)

import com.alibaba.fastjson2.JSON;

import java.util.List;

public class ParseArrayGenericExample {
    public static void main(String[] args) {
        class Product {
            private String name;
            private double price;
            // getter/setter (省略)
            public String getName() { return name; }
            public void setName(String name) { this.name = name; }
            public double getPrice() { return price; }
            public void setPrice(double price) { this.price = price; }
            @Override public String toString() { return "Product{" + "name='" + name + "', price=" + price + '}'; }
        }

        // JSON 数组字符串，包含对象
        String jsonArrayStr = "[{\"name\":\"iPhone 15\",\"price\":5999.0},{\"name\":\"MacBook Air\",\"price\":8999.0}]";

        // 将 JSON 数组字符串解析为 List<Product>
        List<Product> productList = JSON.parseArray(jsonArrayStr, Product.class);
        System.out.println("解析为 List<Product> 结果: " + productList);
        // 输出: 解析为 List<Product> 结果: [Product{name='iPhone 15', price=5999.0}, Product{name='MacBook Air', price=8999.0}]
    }
}

✅ 3.3 泛型形式（与 parseObject 配合）：parseObject(text, new TypeReference<List<T>>() {})

注意：对于 List<T> 类型，parseArray 和 parseObject with TypeReference 是等效的，但 parseArray 更语义化。
对于 Set<T>、Map<K,V> 等其他集合类型，必须使用 parseObject with TypeReference。

import com.alibaba.fastjson2.JSON;
import com.alibaba.fastjson2.TypeReference;

import java.util.Set;

public class ParseArrayWithSetExample {
    public static void main(String[] args) {
        // JSON 数组字符串
        String jsonArrayStr = "[\"item1\", \"item2\", \"item1\"]"; // 包含重复项

        // 无法用 parseArray 直接解析为 Set，因为其返回值是 JSONArray 或 List
        // 必须使用 parseObject 配合 TypeReference
        Set<String> itemSet = JSON.parseObject(jsonArrayStr, new TypeReference<Set<String>>() {});
        System.out.println("解析为 Set<String> 结果: " + itemSet);
        // 输出: 解析为 Set<String> 结果: [item2, item1] (去重)
    }
}

✅ 总结与最佳实践

方法最佳实践说明
toJSONString(obj)用于基础序列化默认不输出 null 字段，性能好
toJSONString(obj, features...)用于控制输出格式如需输出 null、格式化输出等
parseObject(text, Class)用于简单对象反序列化最安全，避免反序列化漏洞
parseObject(text, TypeReference)用于泛型集合反序列化如 List<T>, Map<K,V>
parseObject(text, Class, features...)用于控制解析行为如忽略大小写
parseArray(text)用于解析简单数组返回 JSONArray 对象
parseArray(text, Class)用于解析对象数组返回 List<T>
JSON.toJSONString()方法在Java中的使用
小李同学的博客
03-14 1万+
深入理解并使用JSON.toJSONString()方法实现Java对象序列化
JSON.toJSONString什么作用
思索的涟漪，突破自我
12-20 3060
这对于将 Java 对象表示的数据转换为可在网络传输或存储中传递的格式是非常有用的。反之，JSON.parseObject 可以将这样的 JSON 字符串还原成相应的 Java 对象。JSON.toJSONString 是 fastjson 库提供的方法之一，用于将 Java 对象转换成对应的 JSON 格式的字符串。这种序列化的过程是 JSON 数据在 Java 对象之间转换的关键步骤，而 JSON.toJSONString 是其中一个常用的工具方法。
JSON使用
weixin_50769390的博客
11-06 7416
Json简介及使用
FastJson2 完整使用指导文档（Java 后端企业级实战版）
最新发布
python15397的博客
10-15 1422
FastJson2是阿里巴巴开源的高性能JSON库，作为FastJson 1.x的重构版本，在性能、安全性和功能上全面升级。它提供了高效的JSON序列化/反序列化能力，支持复杂数据结构处理，并修复了1.x版本的安全漏洞。相比Jackson和GSON，FastJson2在性能上具有明显优势（序列化速度快2倍以上），同时完全兼容Java 8+新特性。文档包含详细的代码示例，展示基础用法如对象序列化、JSON字符串解析等，适合Java后端开发者用于企业级应用开发，特别是在高并发场景下可显著降低系统负载。
fastjson2使用
小何的博客
05-12 4942
fastjson2使用
toString和toJSONString的区别
热门推荐
sinat_36454672的博客
05-07 1万+
Map<String, Integer> map = new HashMap<>(); map.put( "staff9", 1 ); map.put( "staff1", 3 ); System.out.println(map.toString()); System.out.println(JSONObject.toJSONString(map)); ...
java使用FastJson解析Json数据
10-20
使用FastJson解析这类结构时，可以使用`JSON.parseObject`来解析整个JSON字符串成为`JSONObject`对象，进而获取到"selList"对应的`JSONArray`。然后，进一步将`JSONArray`中的每一个元素转换为JavaBean对象，并从中...
fastjson 使用方法详细介绍
10-19
Fastjson的使用主要集中在com.alibaba.fastjson.JSON类中，该类提供了多个静态方法用于解析JSON文本与Java对象之间的转换： 1. parse方法：将JSON文本转换为JSONObject或JSONArray对象。 2. parseObject方法：将JSON...
Java使用Fastjson解析JSON字符串示例
在此类中，会调用 HttpHelper 发起网络请求，接收到 JSON 字符串后，使用 FastJSON 提供的 `JSON.parseObject()` 或 `JSON.parseArray()` 方法将其解析为 ResponseInfo 或 List<Product> 对象，进而更新 ListView、...
fastjson解析json.rar
07-26
这个压缩包“fastjson解析json.rar”显然包含了使用Fastjson进行JSON解析的相关资源，包括fastjson的库文件、示例代码以及可能的数据模型类。下面将详细介绍Fastjson的使用方法以及压缩包中的关键文件。 首先，`...
JSON基础：fastjson使用说明
知行合一 止于至善
06-12 889
Fastjson虽然最近频爆问题，但是作为Json使用较为广泛的库，与Gson、Jackson一起仍然是众多开发者的重要选择，即使出于安全的角度考虑，从了解fastjson的使用方式以便替换的角度，也需要了解一下fastjson的使用方式，这篇文章进行简单的总结和整理。
Fastjson2基础使用以及底层序列化/反序列化实现探究
氷泠
02-19 7810
Fastjson2相关探究
谁才是真正的协议之王？fastjson2 vs fury
流子的专栏
08-10 2491
前阵子，我们写过一篇关于fury和protostuff的性能对比的文章：《性能飙升20倍!!! 超高性能协议框架fury完爆protostuff》,那么，fury 是否能真的坐稳协议框架的头把交椅呢？正逢fastjson2推出了新2.0.37版本，据说也很早就支持了二进制格式字节JSONB序列化和反序列化，正好打算一较高下！
fastjson使用toJSONString序列化过滤属性字段详解
guorenhao的博客
05-20 1万+
方法一、fastjson的注解：fastjson中有个注解@JSONField(serialize = false)可以在使用fastjson进行序列化时来过滤属性字段。方法二、Java关键字：Java自带的有一个属性关键字transient是忽略序列化的。方法三、fastjson的属性名过滤器
Json和JsonString之间互转总结
https://github.com/Mac-Zhu
02-24 2360
Json和JsonString之间互转总结
JSON.toJSONString
weixin_43167662的博客
12-15 2402
json
springboot 处理返回结果中字段为空或为null，不展示字段的问题（字段展示不全）
weixin_43969830的博客
11-22 6500
package com.aiqin.mgs.market.api.config; import com.alibaba.fastjson.serializer.SerializerFeature; import com.alibaba.fastjson.support.config.FastJsonConfig; import com.alibaba.fastjson.support.spri...
【免费下载】 Fastjson2与Spring框架深度集成指南
gitblog_00804的博客
06-10 533
Fastjson2作为阿里巴巴开源的高性能JSON处理库，在Spring生态中提供了全面的支持方案。本文将详细介绍如何在Spring项目中集成Fastjson2，涵盖Web MVC、WebSocket、Data Redis和Messaging等核心模块。 ## 一、环境准备 ### 1.1 依赖配置 Fastjson2采用模块化设计，针对不同Spring版本提供了专门的扩展包： **Spr...
fastjson2常用方法
q2422442709的博客
04-26 1万+
FASTJSON2.0是FASTJSON项目的重要升级，目标是为下一个十年提供一个高性能的JSON库，同一套API支持JSON/JSONB两种协议，JSONPath是一等公民，支持全量解析和部分解析，支持Java服务端、客户端Android、大数据场景。 FASJTONS2代码 https://github.com/alibaba/fastjson2/releases/tag/2.0.1 JSONB格式文档 https://github.com/alibaba/fastjson2/wiki.
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

龙茶清欢

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值