在fastjson库中,为了提供灵活的序列化和反序列化机制,设计了一系列的扩展点。
1. 扩展点的用途
fastjson提供的这些扩展点使得我们可以根据实际需求定制序列化和反序列化的行为。如,可通过SerializeFilter
和ParserProcess
定制复杂的序列化和反序列化逻辑,通过SerializerFeature
和ParserFeature
控制序列化和反序列化的输出格式和特性,以及p通过SerializeConfig
和ParserConfig
进行全局配置。
2. 序列化扩展点
2.1. SerializeFilter
用途:用于在序列化过程中定制输出,如过滤某些字段、修改字段值等。 使用方法: 实现 SerializeFilter
接口或其子接口(如SimplePropertyPreFilter
、PropertyFilter
等)。在序列化时,通过 JSON.toJSONString
等方法的重载版本传入自定义的SerializeFilter
实例。
SerializeFilter filter = new SimplePropertyPreFilter() {
@Override
public boolean accept(int index, JavaBeanSerializer beanSer, Object object, Object fieldName, Object fieldVal) {
// 定制序列化逻辑
return true; // 返回true表示保留该字段,false表示过滤
}
};
String jsonStr = JSON.toJSONString(obj, filter);
2.2. SerializerFeature
用途:控制序列化的输出格式和特性。 使用方法: 在序列化时,通过 JSON.toJSONString
等方法的重载版本传入SerializerFeature
枚举值来控制序列化特性。
String jsonStr = JSON.toJSONString(obj, SerializerFeature.PrettyFormat); // 格式化输出
2.3. SerializeConfig
用途:全局配置序列化行为,如自定义序列化器、日期格式等。 使用方法: 创建 SerializeConfig
实例并配置相关选项。在序列化时,通过 JSON.toJSONString
等方法的重载版本传入SerializeConfig
实例。
SerializeConfig config = new SerializeConfig();
// 配置...
String jsonStr = JSON.toJSONString(obj, config);
2.4. 自定义序列化器(Serializer)
fastjson自定义序列化器,用于控制特定类型的序列化过程。用户需实现SerializerFeature
接口,并重写write
方法。
public class CustomSerializer implements SerializerFeature {
@Override
public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType, int features) throws IOException {
// 自定义序列化逻辑
}
}
在序列化过程中,可通过SerializerFeature
枚举值来指定使用自定义序列化器。
String jsonStr = JSON.toJSONString(obj, SerializerFeature.CustomSerializer, new CustomSerializer());
2.5. 序列化过滤器(SerializeFilter)
序列化过滤器用于在序列化过程中修改序列化结果。需实现SerializeFilter
接口,并重写process
方法。
public class CustomSerializeFilter implements SerializeFilter {
@Override
public boolean process(Object source, String name, Object value, SerializeFilter.Context context) {
// 自定义序列化过滤逻辑
}
}
在序列化过程中,可通过JSON.toJSONString
方法的重载版本传入自定义序列化过滤器。
String jsonStr = JSON.toJSONString(obj, new CustomSerializeFilter());
2.6. 自定义日期格式化
fastjson自定义日期格式。可通过SerializerFeature
枚举值DisableCircularReferenceDetect
和WriteMapNullValue
来指定日期格式。
String jsonStr = JSON.toJSONString(obj, SerializerFeature.DisableCircularReferenceDetect, SerializerFeature.WriteMapNullValue);
还可通过DateFormat
属性来指定全局的日期格式。
JSON.setDateFormat(new StdDateFormat());
2. 反序列化扩展点
2.1. ParseProcess
用途:在反序列化过程中执行额外逻辑,如修改反序列化结果。
使用方法:
实现 ParseProcess
接口并重写其中的方法。在反序列化时,通过 JSON.parseObject
等方法的重载版本传入ParseProcess
实例。
ParserFeature
用途:控制反序列化的行为和特性。 使用方法: 在反序列化时,通过 JSON.parseObject
等方法的重载版本传入ParserFeature
枚举值来控制反序列化特性。
Object obj = JSON.parseObject(jsonStr, Object.class, Feature.AllowSingleQuotes); // 允许使用单引号
2.2. ParserConfig
用途:全局配置反序列化行为,如自定义反序列化器、自动类型转换等。 使用方法: 创建 ParserConfig
实例并配置相关选项。在反序列化时,通过 JSON.parseObject
等方法的重载版本传入ParserConfig
实例。
ParserConfig config = new ParserConfig();
// 配置...
Object obj = JSON.parseObject(jsonStr, Object.class, config);
代码
SerializeFilter
用于过滤某些字段:
SerializeFilter filter = new SimplePropertyPreFilter() {
@Override
public boolean accept(int index, JavaBeanSerializer beanSer, Object object, Object fieldName, Object fieldVal) {
if ("password".equals(fieldName)) {
return false; // 过滤password字段
}
return true;
}
};
String jsonStr = JSON.toJSONString(user, filter);
2.3. 自定义反序列化器(Deserializer)
类似地,fastjson也支持自定义反序列化器。需要实现ObjectDeserializer
接口,并重写deserialze
方法。
public class CustomDeserializer implements ObjectDeserializer {
@Override
public Object deserialize(DefaultJSONParser parser, Type type, Object fieldName) {
// 自定义反序列化逻辑
}
}
在反序列化过程中,可通过ParserConfig
类的putDeserializer
方法来注册自定义反序列化器。
ParserConfig.getGlobalInstance().putDeserializer(SomeType.class, new CustomDeserializer());
2.4. 解析过程(ParseProcess)
解析过程在反序列化过程中使用,可实现ParseProcess
接口并重写process
方法来自定义解析逻辑。
public class CustomParseProcess implements ParseProcess {
@Override
public Object process(ParseContext ctx) {
// 自定义解析逻辑
}
}
在反序列化过程中,可以通过JSON.parseObject
方法的重载版本传入自定义解析过程。
Object obj = JSON.parseObject(jsonStr, SomeType.class, new CustomParseProcess());
太强 ! SpringBoot中出入参增强的5种方法 : 加解密、脱敏、格式转换、时间时区处理
太强 ! SpringBoot中优化if-else语句的七种绝佳方法实战
SpringBoot中大量数据导出方案:使用EasyExcel并行导出多个excel文件并压缩zip后下载
SpringBoot中基于XXL-JOB实现大量数据灵活控制的分片处理方案