在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> 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> 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定制(反)序列化内容,请移步官网。

 

GitHub 加速计划 / fastj / fastjson
25.69 K
6.51 K
下载
FASTJSON 2.0.x has been released, faster and more secure, recommend you upgrade.
最近提交(Master分支:3 个月前 )
c942c834 - 1 年前
5bc4709b - 1 年前
Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐