【FastJSON】使用serializeUsing定制序列化、反序列化

在fastjson 1.2.16版本之后，JSONField支持新的定制化配置serializeUsing，可以单独对某个类的某个属性定制序列化、反序列化。

 

1.fastjson定制序列化、反序列化接口支持

1）序列化

package com.alibaba.fastjson.serializer;

public interface ObjectSerializer {
    void write(JSONSerializer var1, Object var2, Object var3, Type var4, int var5) throws IOException;
}

2）反序列化

package com.alibaba.fastjson.parser.deserializer;

public interface ObjectDeserializer {
    
     T deserialze(DefaultJSONParser var1, Type var2, Object var3);

    int getFastMatchToken();
}

 

2.定制序列化示例

1）实体

@Data
public static class Model {
    //金额
    @JSONField(serializeUsing = ModelValueSerializer.class)
    public int money;

    ……
}

2) 序列化实现

public static class ModelValueSerializer implements ObjectSerializer {
    @Override
    public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType,
                      int features) throws IOException {
        Integer value = (Integer) object;
        String text = value + "元";
        serializer.write(text);
    }
}

3）测试代码

Model model = new Model();
model.value = 100;
String json = JSON.toJSONString(model);
Assert.assertEquals("{\"value\":\"100元\"}", json);

 

3.定制反序列化示例

1）实体

@Data
public class Model {
    
    // 数据类型 （可能为8种常见基本类型，能为String字符编码,定制反序列化 解析）
    @JSONField(deserializeUsing = TypeSerializer.class)
    private DataType dataType; 

    ……
}

2）反序列化实现

public class TypeSerializer implements ObjectDeserializer {

    @Override
    public  T deserialze(DefaultJSONParser parser, Type type, Object fieldName) {
        String value = parser.parseObject(String.class);
        // DataType 数据类型 枚举
        if (DataType.class.isAssignableFrom((Class) type)) {
            return (T) DataType.from(value);
        } 
        // Charset 字符编码 枚举
        else if (Charset.class.isAssignableFrom((Class) type)) {
            return (T) Charset.from(value);
        }
        return null;
    }

    @Override
    public int getFastMatchToken() {
        return 0;
    }
}

3）演示类枚举

public enum DataType {
    Int,
    Long,
    Double,
    ……
}

public enum Charset {
    ascii(Charsets.US_ASCII),
    gbk(Charsets.US_ASCII),
    utf8(Charsets.US_ASCII),
    ……
}

此例通过定制反序列化，动态判断数据类型；此外，对表达式、数据长度、数据约束等，都可以通过@JSONField+serializeUsing定制反序列化。

 

4.小结

通过 “@JSONField注解 + serializeUsing” 定制化后，丰富了json的功能，但如KimmKing在 “JSON最佳实战” 所阐述：

对于新手来说，自定义序列化是一切罪恶的根源。

尽量不要使用自定义序列化，除非万不得已，优先考虑使用注解过滤，别名等方式，甚至是重新建一个VO类来组装实际需要的属性。使用自定义序列化时一切要小心，因为这样会导致两个问题：

• 改变了pojo <-> jsonstring 的自然对应关系，从而不利于阅读代码和排查问题，你改变的关系无法简单的从bean和json上看出来了；
• 反序列化可能出错，因为对应不上原来的属性了。

如果只是序列化发出去（响应）的是JSON数据、传过来（请求）的数据格式跟JSON无关或者是标准的，此时自定义序列化就无所谓了，反正是要接收方来处理。

 

此外，更多FastJSon定制(反)序列化内容，请移步官网。