FastJSON序列化报 `“$ref“

当使用FastJSON进行序列化时,如果数据中存在相同内容的对象,FastJSON会默认将其转换为引用形式,导致$ref出现在返回结果中。这在前端查询模板时可能会引起问题。解决方法包括全局或局部关闭自动使用引用。关闭引用可以防止相同对象被重复序列化,避免$ref的出现。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

FastJSON序列化报 "$ref": "$.templateItemDtos[0].tags[0]"

参考地址:https://www.cnblogs.com/haha12/p/12201634.html

在前端查询模板的时候,返回的数据出现 $ref

问题原因, FastJSON在序列化的时候,如果出现同样的内容序列化,会将其他的部分以引用的方式序列化

问题现场

"templateItemDtos": [
        {
            "createTime": 1639392182000,
            "evaluateTemplateId": 211,
            "id": 288,
            "isDelete": false,
            "itemLevel": 1,
            "itemName": "不满意",
            "level": 3,
            "remark": 1,
            "remarkGuide": "",
            "tagIds": "[123,122,121]",
            "tagRequired": true,
            "tags": [
                {
                    "canUpdate": false,
                    "checked": false,
                    "createTime": 1639367913000,
                    "createTimeStr": "2021-12-13 11:58:33",
                    "id": 123,
                    "isDelete": false,
                    "labelName": "满意度评价标签3",
                    "status": true,
                    "updateTime": 1639367913000,
                    "updateTimeStr": "2021-12-13 11:58:33"
                },
                {
                    "canUpdate": false,
                    "checked": false,
                    "createTime": 1638341059000,
                    "createTimeStr": "2021-12-01 14:44:19",
                    "id": 122,
                    "isDelete": false,
                    "labelName": "满意度评价标签2",
                    "status": true,
                    "updateTime": 1638341059000,
                    "updateTimeStr": "2021-12-01 14:44:19"
                },
                {
                    "canUpdate": false,
                    "checked": false,
                    "createTime": 1636361015000,
                    "createTimeStr": "2021-11-08 16:43:35",
                    "id": 121,
                    "isDelete": false,
                    "labelName": "满意度评价标签1",
                    "status": true,
                    "updateTime": 1636361015000,
                    "updateTimeStr": "2021-11-08 16:43:35"
                }
            ],
            "updateTime": 1639392182000
        },
        {
            "createTime": 1639392182000,
            "evaluateTemplateId": 211,
            "id": 289,
            "isDelete": false,
            "itemLevel": 2,
            "itemName": "一般1",
            "level": 2,
            "remark": 2,
            "remarkGuide": "",
            "tagIds": "[123,122,121]",
            "tagRequired": false,
            "tags": [
                {
                    "$ref": "$.templateItemDtos[0].tags[0]"
                },
                {
                    "$ref": "$.templateItemDtos[0].tags[1]"
                },
                {
                    "$ref": "$.templateItemDtos[0].tags[2]"
                }
            ],
            "updateTime": 1639392182000
        },
        {
            "createTime": 1639392182000,
            "evaluateTemplateId": 211,
            "id": 290,
            "isDelete": false,
            "itemLevel": 3,
            "itemName": "一般2",
            "level": 2,
            "remark": 2,
            "remarkGuide": "",
            "tagIds": "[123,122,121]",
            "tagRequired": false,
            "tags": [
                {
                    "$ref": "$.templateItemDtos[0].tags[0]"
                },
                {
                    "$ref": "$.templateItemDtos[0].tags[1]"
                },
                {
                    "$ref": "$.templateItemDtos[0].tags[2]"
                }
            ],
            "updateTime": 1639392182000
        }

其中tagId都一样, 所以下面两项如果序列化和第一项的一样的,fastJSON默认会将这的转为引用形式

问题复现

@org.junit.Test
public void testFastJson() {
	Map<String, Object> dataMap = new HashMap<>();
	List<User> userList1 = new ArrayList<>();
	List<User> userList2 = new ArrayList<>();

	for (int i = 0; i < 2; i++) {
		User user = new User();
		user.setId(i);
		userList1.add(user);
		userList2.add(user);
	}
	dataMap.put("userList1", userList1);
	dataMap.put("userList2", userList2);

	System.out.println(JSON.toJSONString(dataMap));
}

上面代码运行结果如下

{
    "userList1": [
        {
            "id": 0
        },
        {
            "id": 1
        }
    ],
    "userList2": [
        {
            "$ref": "$.userList1[0]"
        },
        {
            "$ref": "$.userList1[1]"
        }
    ]
}

从打印结果可以看到,里面含有了$ref等字符,为什么为这样呢,这就是引用,在传输的数据中出现相同的对象时,fastjson默认开启引用检测将相同的对象写成引用的形式。

解决办法

2.1 关闭自动使用引用

  • 全局关闭:

     JSON.DEFAULT_GENERATE_FEATURE |= SerializerFeature.DisableCircularReferenceDetect.getMask();
    
  • 局部关闭(使用的时候特定处理)

     JSON.toJSONString(obj, SerializerFeature.DisableCircularReferenceDetect);
    

原理

引用分类

引用分为两类,重复引用和循环引用

  1. 重复引用:指一个对象重复出现多次
  2. 循环引用

指你心里有我,我心里有你(互相引用),这个问题比较严重,如果处理不好就会出现StackOverflowError异常

### FastJSON 序列化概述 FastJSON 是阿里巴巴开源的一个高性能 JSON 序列化和反序列化工具包。其设计目标是提供简单易用且性能卓越的功能,适用于多种应用场景。 #### 使用方法 要使用 FastJSON 进行对象的序列化与反序列化,首先需要引入相应的 Maven 或 Gradle 依赖项: 对于 Maven 用户来说,在 `pom.xml` 文件中添加如下配置: ```xml <dependency> <groupId>com.alibaba</groupId> <artifactId>fastjson</artifactId> <version>最新版本号</version> </dependency> ``` 而对于 Gradle 用户,则可以在 build.gradle 中加入这行代码: ```groovy implementation 'com.alibaba:fastjson:最新版本号' ``` 完成依赖导入之后就可以开始编写具体的业务逻辑了。下面给出几个简单的例子展示如何利用 FastJSON 实现基本功能[^1]。 #### 基本示例 ##### 将 Java 对象转换为 JSON 字符串 (序列化) 假设有一个名为 Person 的实体类,可以通过以下方式将其实例转化为 JSON 格式的字符串表示形式: ```java import com.alibaba.fastjson.JSON; public class Main { public static void main(String[] args) { Person person = new Person(); person.setName("张三"); person.setAge(20); String jsonString = JSON.toJSONString(person); // 转换为 json string System.out.println(jsonString); } } ``` ##### 把 JSON 字符串解析回 Java 对象 (反序列化) 如果已经有了一个描述某个对象状态的 JSON 字符串,那么可以很容易地通过 FastJSON 解析得到对应的 Java Bean 实例: ```java import com.alibaba.fastjson.JSON; import com.alibaba.fastjson.TypeReference; // ... TypeReference<Person> typeRef = new TypeReference<Person>() {}; Person parsedObject = JSON.parseObject("{\"name\":\"李四\",\"age\":25}", typeRef); System.out.println(parsedObject.getName() + ", " + parsedObject.getAge()); ``` #### 常见问题及其解决方案 - **日期格式处理不当** 当涉及到 Date 类型字段时,默认情况下可能会遇到时间戳不一致等问题。为了确保正确性和一致性,建议设置全局属性或针对特定场景指定日期模式: ```java // 设置默认日期格式 DateFormatUtils.setDefaultFormat("yyyy-MM-dd HH:mm:ss"); // 或者在每次调用前临时设定 JSON.defaultTimeZone(TimeZone.getTimeZone("GMT+8")); JSON.defaultDateFormat("yyyy-MM-dd HH:mm:ss"); ``` - **循环引用引发异常** 某些复杂的数据结构可能存在父子关系或其他类型的环形链表情况,这时如果不做特殊处理就会抛出 StackOverflowError 错误。为此,FastJSON 提供了一个非常有用的特性——自动检测并忽略这些危险连接: ```java // 启用安全模式防止无限递归 SerializeConfig config = SerializeConfig.globalInstance; config.put(Person.class, new SimplePropertyPreFilter()); // 或者直接传入参数控制行为 JSON.toJSONString(object, SerializerFeature.WriteMapNullValue, SerializerFeature.DisableCircularReferenceDetect); ``` - **敏感信息泄露风险** 考虑到安全性因素,在实际开发过程中应当注意保护用户的隐私资料免受不必要的暴露。一种做法是在导出之前先过滤掉那些不应该公开显示的内容;另一种则是采用加密算法对重要部分进行编码后再传输给客户端。 ```java // 定义白名单只保留必要的键值对 Set<String> includes = Sets.newHashSet("id", "username"); SimplePropertyPreFilter filter = new SimplePropertyPreFilter(includes.toArray(new String[includes.size()])); // 执行序列化操作的同时应用上述规则 String safeJsonStr = JSON.toJSONString(userProfile, filter); ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值