在fastjson 1.2.16版本之后,JSONField支持新的定制化配置serializeUsing,可以单独对某个类的某个属性定制序列化、反序列化。
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();
}
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);
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定制反序列化。
通过 “@JSONField注解 + serializeUsing” 定制化后,丰富了json的功能,但如KimmKing在 “JSON最佳实战” 所阐述:
对于新手来说,自定义序列化是一切罪恶的根源。
尽量不要使用自定义序列化,除非万不得已,优先考虑使用注解过滤,别名等方式,甚至是重新建一个VO类来组装实际需要的属性。使用自定义序列化时一切要小心,因为这样会导致两个问题:
- 改变了pojo <-> jsonstring 的自然对应关系,从而不利于阅读代码和排查问题,你改变的关系无法简单的从bean和json上看出来了;
- 反序列化可能出错,因为对应不上原来的属性了。
如果只是序列化发出去(响应)的是JSON数据、传过来(请求)的数据格式跟JSON无关或者是标准的,此时自定义序列化就无所谓了,反正是要接收方来处理。
此外,更多FastJSon定制(反)序列化内容,请移步官网。