Fastjson2 中空对象与空数组的序列化处理技巧

在实际开发中，我们经常会遇到 JSON 数据中某些字段在正常情况下返回数组，但在空值情况下返回空对象的情况。这种不一致的数据格式会给反序列化带来挑战。本文将深入探讨如何使用 Fastjson2 优雅地处理这种场景。

问题场景分析

假设我们有一个 Java 类：

class TestArray {
    private List<String> array;
}

在 JSON 数据中，我们可能遇到两种格式：

1. 正常情况：{"array":["1","2"]}
2. 空值情况：{"array":{}}

这种不一致性会导致 Fastjson2 在反序列化空对象为 List 时抛出异常。

解决方案

方案一：使用自定义反序列化器

我们可以通过实现 ObjectDeserializer 接口来创建自定义的反序列化逻辑：

public class ListOrEmptyObjectDeserializer implements ObjectDeserializer {
    @Override
    public <T> T deserialze(DefaultJSONParser parser, Type type, Object fieldName) {
        JSONLexer lexer = parser.lexer;
        if (lexer.token() == JSONToken.LBRACE) {
            lexer.nextToken(JSONToken.RBRACE);
            return (T) new ArrayList();
        }
        return parser.parseObject(type);
    }

    @Override
    public int getFastMatchToken() {
        return JSONToken.LBRACKET;
    }
}

然后通过注解应用到字段上：

class TestArray {
    @JSONField(deserializeUsing = ListOrEmptyObjectDeserializer.class)
    private List<String> array;
}

方案二：使用 TypeReference 处理

在反序列化时，我们可以使用 TypeReference 来指定更灵活的类型处理：

TypeReference<TestArray> typeRef = new TypeReference<TestArray>() {};
TestArray obj = JSON.parseObject(jsonString, typeRef);

方案三：全局配置自定义反序列化器

如果需要在整个项目中统一处理这种场景，可以配置全局的反序列化器：

ParserConfig.getGlobalInstance().putDeserializer(List.class, new ListOrEmptyObjectDeserializer());

最佳实践建议

1. 一致性优先：在设计 API 时，尽量保持数据结构的一致性，避免混合使用空对象和空数组。

2. 防御性编程：在客户端代码中，对可能为空的集合进行空检查，避免 NPE。

3. 文档说明：如果必须使用这种混合格式，应在 API 文档中明确说明，方便其他开发者理解。

4. 性能考虑：自定义反序列化器会增加一定的性能开销，在性能敏感的场景需要权衡。

总结

Fastjson2 提供了灵活的机制来处理 JSON 数据中的不一致格式。通过自定义反序列化器，我们可以优雅地解决空对象与空数组的兼容问题。在实际项目中，建议根据具体需求选择最适合的解决方案，同时注意保持代码的可维护性和性能平衡。

理解这些技术细节不仅能帮助我们解决眼前的问题，更能提升我们对 JSON 序列化/反序列化机制的深入理解，为处理更复杂的数据格式转换场景打下基础。