FastJSON中空对象序列化为空数组的解决方案

在实际开发过程中，我们经常会遇到JSON数据中数组字段在为空时返回空对象而非空数组的情况。这种数据格式的不一致性会给Java对象反序列化带来困扰。本文将深入探讨如何通过FastJSON解决这一问题。

问题场景分析

假设我们有一个标准的JSON数据结构：

{
  "array": ["1", "2"]
}

但在某些情况下，当数组为空时，服务端可能返回：

{
  "array": {}
}

而我们的Java对象定义为：

class TestArray {
    private List<String> array;
}

这种情况下，直接使用FastJSON反序列化会抛出异常，因为JSON对象无法直接转换为List集合。

解决方案实现

FastJSON提供了@JSONField注解的deserializeUsing属性，允许我们自定义反序列化逻辑。我们可以通过实现ObjectReader接口来创建自定义的反序列化器。

自定义List反序列化器

public class MyListReader implements ObjectReader {
    @Override
    public Object createInstance(long features) {
        return new ArrayList<>();
    }

    @Override
    public Object readObject(JSONReader jsonReader, Type fieldType, Object fieldName, long features) {
        if (jsonReader.readIfNull()) {
            return null;
        }

        char ch = jsonReader.current();
        if (ch == '[') {
            // 处理标准数组格式
            jsonReader.next();
            List<String> list = new ArrayList<>();
            while (!jsonReader.nextIfArrayEnd()) {
                list.add(jsonReader.readString());
            }
            return list;
        } else if (ch == '{') {
            // 处理空对象情况
            jsonReader.next();
            if (jsonReader.nextIfObjectEnd()) {
                return new ArrayList<>(); // 返回空列表
            }
            throw new JSONException("Unexpected non-empty object");
        }
        throw new JSONException("Unexpected token");
    }

    // 其他必要方法实现...
}

在Java类中使用自定义反序列化器

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

实现原理剖析

1. JSONField注解：通过deserializeUsing属性指定自定义的反序列化器类
2. ObjectReader接口：提供了完整的反序列化控制能力
   • createInstance：创建目标集合实例
   • readObject：实现核心的反序列化逻辑
3. JSONReader：FastJSON提供的底层读取工具，可以精确控制JSON解析过程

高级应用场景

这种自定义反序列化方案不仅适用于空对象转空数组的场景，还可以扩展应用于：

1. 不同数据格式的兼容处理
2. 特殊数据结构的转换
3. 旧系统接口的兼容适配
4. 第三方API的异常数据处理

最佳实践建议

1. 在自定义反序列化器中做好异常处理
2. 考虑性能因素，避免复杂的处理逻辑
3. 对于通用场景，可以考虑将自定义反序列化器封装为公共组件
4. 编写单元测试验证各种边界情况

通过这种自定义反序列化方案，我们可以优雅地解决JSON数据结构不一致带来的问题，提高系统的健壮性和兼容性。这种方案不仅适用于FastJSON，类似的思路也可以应用于其他JSON处理框架。