前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >用了几年的 Fastjson,我最终替换成了Jackson!

用了几年的 Fastjson,我最终替换成了Jackson!

作者头像
Java技术栈
发布2021-05-11 11:32:34
4.6K0
发布2021-05-11 11:32:34
举报
文章被收录于专栏:Java技术栈Java技术栈

作者:larva-zhh 来源:www.cnblogs.com/larva-zhh/p/11544317.html

为什么要替换fastjson

工程里大量使用了fastjson作为序列化和反序列化框架,甚至ORM在处理部分字段也依赖fastjson进行序列化和反序列化。那么作为大量使用的基础框架,为什么还要进行替换呢?

原因有以下几点:

  1. fastjson太过于侧重性能,对于部分高级特性支持不够,而且部分自定义特性完全偏离了json和js规范导致和其他框架不兼容;
  2. fastjson文档缺失较多,部分Feature甚至没有文档,而且代码缺少注释较为晦涩;
  3. fastjson的CVE bug监测较弱,很多CVE数据库网站上有关fastjson的CVE寥寥无几,例如近期的AutoType导致的高危漏洞,虽然和Jackson的PolymorphicDeserialization是同样的bug,但是CVE网站上几乎没有fastjson的bug报告。

框架选型

参考mvnrepository json libraries,根据流行度排序后前十名框架:

  • jackson2(com.fasterxml.jackson)
  • gson
  • org.json
  • jackson1(com.codehuas.jackson)
  • fastjson
  • cheshire
  • json-simple

jackson1是已经过时的框架,因此可以忽略,cheshire和json-simple排名尚且不如fastjson,也忽略,剩余jackson2、gson以及org.json,其中org.json的使用量(usage)远小于jackson2(方便起见,下文均以jackson均指代jackson2)和gson,因此org.json也可以排除了。

关于jackson和gson的比较文章有很多,stackoverflow上自行搜索,下面仅推荐几篇blog:

  • jackson vs gson
  • JSON in Java
  • the ultimate json library json-simple vs gson vs jackson vs json

在功能特性支持、稳定性、可扩展性、易用性以及社区活跃度上 jackson 和 gson 差不多,入门教程可以分别参考baeldung jackson系列 以及 baeldung gson系列。但是jackson有更多现成的类库兼容支持例如jackson-datatype-commons-lang3,以及更丰富的输出数据格式支持例如jackson-dataformat-yaml,而且spring框架默认使用jackson,因此最终我选择使用jackson。

PS: Jackson 2.10.0开始尝试基于新的API使用白名单机制来避免RCE漏洞,详见https://github.com/FasterXML/jackson-databind/issues/2195,效果尚待观察。

替换fastjson

fastjson常见的使用场景就是序列化和反序列化,偶尔会有JSONObjectJSONArray实例的相关操作。

以下步骤的源码分析基于以下版本:

  • fastjson v1.2.60
  • jackson-core v2.9.9
  • jackson-annotations v2.9.0
  • jackson-databind v2.9.9.3

Deserialization

fastjson将json字符串反序列化成Java Bean通常使用com.alibaba.fastjson.JSON的静态方法(JSONObjectJSONArray的静态方法也是来自于JSON),常用的有以下几个API:

代码语言:javascript
复制
public static JSONObject parseObject(String text);

public static JSONObject parseObject(String text, Feature... features);

public static <T> T parseObject(String text, Class<T> clazz);

public static <T> T parseObject(String text, Class<T> clazz, Feature... features);

public static <T> T parseObject(String text, TypeReference<T> type, Feature... features);

public static JSONArray parseArray(String text);

public static <T> List<T> parseArray(String text, Class<T> clazz);

从方法入参就能猜到,fastjson在执行反序列化时的Parse行为由com.alibaba.fastjson.parser.Feature指定。研究parseObject的源码后,发现底层最终都是使用的以下方法:

代码语言:javascript
复制
public static <T> T parseObject(String input, Type clazz, ParserConfig config, ParseProcess processor, int featureValues, Feature... features) {
   if (input == null) {
       return null;
   }

   // featureValues作为基准解析特性开关值
   // 入参features和featureValues取并集得到最终的解析特性
   if (features != null) {
       for (Feature feature : features) {
           featureValues |= feature.mask;
       }
   }

   DefaultJSONParser parser = new DefaultJSONParser(input, config, featureValues);

   if (processor != null) {
       if (processor instanceof ExtraTypeProvider) {
           parser.getExtraTypeProviders().add((ExtraTypeProvider) processor);
       }

       if (processor instanceof ExtraProcessor) {
           parser.getExtraProcessors().add((ExtraProcessor) processor);
       }

       if (processor instanceof FieldTypeResolver) {
           parser.setFieldTypeResolver((FieldTypeResolver) processor);
       }
   }

   T value = (T) parser.parseObject(clazz, null);

   parser.handleResovleTask(value);

   parser.close();

   return (T) value;

}

通过IDE搜索usage后,发现当没有作为基准解析特性开关的featureValues入参时,都是使用的DEFAULT_PARSE_FEATURE作为基准解析特性开关,以下是JSON.DEFAULT_PARSE_FEATURE的实例化代码:

代码语言:javascript
复制
static {
        int features = 0;
        features |= Feature.AutoCloseSource.getMask();
        features |= Feature.InternFieldNames.getMask();
        features |= Feature.UseBigDecimal.getMask();
        features |= Feature.AllowUnQuotedFieldNames.getMask();
        features |= Feature.AllowSingleQuotes.getMask();
        features |= Feature.AllowArbitraryCommas.getMask();
        features |= Feature.SortFeidFastMatch.getMask();
        features |= Feature.IgnoreNotMatch.getMask();
        DEFAULT_PARSER_FEATURE = features;
}

fastjson还会从环境变量中读取配置来修改DEFAULT_PARSER_FEATURE(虽然很少会有人这么做),但最好还是通过实际运行一下程序来确认你的环境中的实际解析特性开关。

代码语言:javascript
复制
@Test
public void printFastJsonDefaultParserFeature() {
    for (Feature feature : Feature.values()) {
        if (Feature.isEnabled(JSON.DEFAULT_PARSER_FEATURE, feature)) {
            System.out.println(feature);
        }
    }
}

fastjson 和 jackson的反序列化特性对照表

fastjson特性说明

fastjson枚举

fastjson默认状态

jackson枚举

jackson默认状态

jackson特性说明

Parser close时自动关闭为创建Parser实例而创建的底层InputStream以及Reader等输入流

Feature.AutoCloseSource

开启

JsonParser.Feature.AUTO_CLOSE_SOURCE

开启

保持开启

允许json字符串中带注释

Feature.AllowComment

关闭

JsonParser.Feature.ALLOW_COMMENTS

关闭

根据系统的json数据情况开启

允许json字段名不被引号包括起来

Feature.AllowUnQuotedFieldNames

开启

JsonParser.Feature.ALLOW_UNQUOTED_FIELD_NAMES

关闭

根据系统的json数据情况开启

允许json字段名使用单引号包括起来

Feature.AllowSingleQuotes

开启

JsonParser.Feature.ALLOW_SINGLE_QUOTES

关闭

根据系统的json数据情况开启

将json字段名作为字面量缓存起来,即fieldName.intern()

Feature.InternFieldNames

开启

-

-

jackson默认使用InternCache缓存了PropertyName

识别ISO8601格式的日期字符串,例如:2018-05-31T19:13:42.000Z或2018-05-31T19:13:42.000+07:00

Feature.AllowISO8601DateFormat

关闭

-

-

jackson默认支持ISO8601格式日期字符串的解析,并且也可以通过ObjectMapper.setDateFormat指定解析格式

忽略json中包含的连续的多个逗号,非标准特性

Feature.AllowArbitraryCommas

关闭

-

-

jackson不支持该特性,且该特性是非标准特性,因此可以忽略

将json中的浮点数解析成BigDecimal对象,禁用后会解析成Double对象

Feature.UseBigDecimal

开启

DeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATS

关闭

建议开启

解析时忽略未知的字段继续完成解析

Feature.IgnoreNotMatch

开启

DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES

开启

jackson默认开启遇到未知属性需要抛异常,因此如要和fastjson保持一致则需要关闭该特性

如果你用fastjson序列化的文本,输出的结果是按照fieldName排序输出的,parser时也能利用这个顺序进行优化读取。这种情况下,parser能够获得非常好的性能

Feature.SortFeidFastMatch

关闭

-

-

fastjson内部处理逻辑,jackson不支持该特性,不影响功能

禁用ASM

Feature.DisableASM

关闭

-

-

fastjson内部处理逻辑,jackson不支持该特性,不影响功能

禁用循环引用检测

Feature.DisableCircularReferenceDetect

关闭

-

-

fastjson内部处理逻辑,jackson不支持该特性,不影响功能

对于没有值的字符串属性设置为空串

Feature.InitStringFieldAsEmpty

关闭

-

-

jackson不支持该特性,但是可以通过@JsonSetter的nulls()和contentNulls()分别设置Bean以及Array/Collection的元素对null的处理方式。例如Nulls.AS_EMPTY就会将null设置为JsonDeserializer.getEmptyValue

非标准特性,允许将数组按照字段顺序解析成Java Bean,例如"[1001,\"xx\",33]"可以等价为"{\"id\": 10001, \"name\": \"xx\", \"age\": 33}"

Feature.SupportArrayToBean

关闭

-

-

非标准特性,且使用场景较少,jackson不支持该特性

解析后属性保持原来的顺序

Feature.OrderedField

关闭

-

-

-

禁用特殊字符检查

Feature.DisableSpecialKeyDetect

关闭

-

-

-

使用对象数组而不是集合

Feature.UseObjectArray

关闭

DeserializationFeature.USE_JAVA_ARRAY_FOR_JSON_ARRAY

关闭

保持关闭

支持解析没有setter方法的非public属性

Feature.SupportNonPublicField

关闭

-

-

jaskson可以通过ObjectMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY)来达到相同的目的

禁用fastjson的AUTOTYPE特性,即不按照json字符串中的@type自动选择反序列化类

Feature.IgnoreAutoType

关闭

-

-

jackson的PolymorphicDeserialization默认是支持Object.class、abstract classes、interfaces属性的AUTO Type,但是该特性容易导致安全漏洞,强烈建议使用ObjectMapper.disableDefaultTyping()设置为只允许@JsonTypeInfo生效

禁用属性智能匹配,例如下划线自动匹配驼峰等

Feature.DisableFieldSmartMatch

关闭

-

-

jackson可以通过ObjectMapper.setPropertyNamingStrategy()达到相同的目的,但这种是针对一个json串的统一策略,如果要在一个json串中使用不同的策略则可以使用@JsonProperty.value()指定字段名

启用fastjson的autotype功能,即根据json字符串中的@type自动选择反序列化的类

Feature.SupportAutoType

关闭

ObjectMapper.DefaultTyping.*

开启

jackson的PolymorphicDeserialization支持不同级别的AUTO TYPE,但是这个功能容易导致安全漏洞,强烈建议使用ObjectMapper.disableDefaultTyping()设置为只允许@JsonTypeInfo生效

解析时将未用引号包含的json字段名作为String类型存储,否则只能用原始类型获取key的值。例如String text="{123:\"abc\"}"在启用了NonStringKeyAsString后可以通过JSON.parseObject(text).getString("123")的方式获取到"abc",而在不启用NonStringKeyAsString时,JSON.parseObject(text).getString("123")只能得到null,必须通过JSON.parseObject(text).get(123)的方式才能获取到"abc"。

Feature.NonStringKeyAsString

关闭

-

-

非标准特性,jackson并不支持

自定义"{\"key\":value}"解析成Map实例,否则解析为JSONObject

Feature.CustomMapDeserializer

关闭

-

-

jackson没有相应的全局特性,但是可以通过TypeReference达到相同的效果

枚举未匹配到时抛出异常,否则解析为null

Feature.ErrorOnEnumNotMatch

关闭

DeserializationFeature.READ_UNKNOWN_ENUM_VALUES_AS_NULL

关闭

fastjson默认解析为null,jackson则相反,默认会抛异常,建议采用jackson默认行为

反序列化fastjson和jackson的特性TestCase见DeserializationUseJacksonReplaceFastJsonTest.java

Serialization

fastjson将Java Bean序列化成json字符串通常也是使用com.alibaba.fastjson.JSON的静态方法(JSONObjectJSONArray的静态方法也是来自于JSON),常用的有以下几个API:

代码语言:javascript
复制
public static String toJSONString(Object object);

public static String toJSONString(Object object, SerializerFeature... features);

public static String toJSONStringWithDateFormat(Object object, String dateFormat, SerializerFeature... features);

public static String toJSONString(Object object, boolean prettyFormat);

public static void writeJSONString(Writer writer, Object object, SerializerFeature... features);

从方法入参也能看出,在序列化时,fastjson的特性由SerializerFeature控制,研究toJSONString的源码后,发现最终都会调用以下方法:

代码语言:javascript
复制
 public static String toJSONString(Object object, SerializeConfig config, SerializeFilter[] filters, String dateFormat, int defaultFeatures, SerializerFeature... features) {
   SerializeWriter out = new SerializeWriter(null, defaultFeatures, features);

   try {
       JSONSerializer serializer = new JSONSerializer(out, config);

       if (dateFormat != null && dateFormat.length() != 0) {
           serializer.setDateFormat(dateFormat);
           serializer.config(SerializerFeature.WriteDateUseDateFormat, true);
       }

       if (filters != null) {
           for (SerializeFilter filter : filters) {
               serializer.addFilter(filter);
           }
       }

       serializer.write(object);

       return out.toString();
   } finally {
       out.close();
   }
}

通过IDE搜索usage后,发现当没有作为基准解析特性开关的defaultFeatures入参时,都是使用的DEFAULT_GENERATE_FEATURE作为基准解析特性开关,以下是JSON.DEFAULT_GENERATE_FEATURE的实例化代码:

代码语言:javascript
复制
static {
    int features = 0;
    features |= SerializerFeature.QuoteFieldNames.getMask();
    features |= SerializerFeature.SkipTransientField.getMask();
    features |= SerializerFeature.WriteEnumUsingName.getMask();
    features |= SerializerFeature.SortField.getMask();

    DEFAULT_GENERATE_FEATURE = features;

    config(IOUtils.DEFAULT_PROPERTIES);
}

fastjson还会从环境变量中读取配置来修改DEFAULT_GENERATE_FEATURE(虽然很少会有人这么做),但最好还是通过实际运行一下程序来确认你的环境中的实际解析特性开关。

代码语言:javascript
复制
@Test
public void printFastJsonDefaultGenerateFeature() {
    for (SerializerFeature feature : SerializerFeature.values()) {
        if (SerializerFeature.isEnabled(JSON.DEFAULT_GENERATE_FEATURE, feature)) {
            System.out.println(feature);
        }
    }
}

fastjson 和 jackson的序列化特性对照表

fastjson特性说明

fastjson枚举

fastjson默认状态

jackson枚举

jackson默认状态

jackson特性说明

输出的json字段名被引号包含

SerializerFeature.QuoteFieldNames

开启

JsonGenerator.Feature.QUOTE_FIELD_NAMES

开启

保持开启

序列化时使用单引号,而不是使用双引号

SerializerFeature.UseSingleQuotes

关闭

-

-

jackson不支持该特性

序列化时,value为null的key或field也输出

SerializerFeature.WriteMapNullValue

关闭

JsonInclude.Include.ALWAYS

开启

建议按需选择。注意SerializationFeature.WRITE_NULL_MAP_VALUES从2.9已废弃,且会被JsonInclude.Include给覆盖

序列化枚举时使用枚举类型的toString()方法,和SerializerFeature.WriteEnumUsingName互斥

SerializerFeature.WriteEnumUsingToString

关闭

SerializationFeature.WRITE_ENUMS_USING_TO_STRING

关闭

建议关闭,或者和反序列化的DeserializationFeature.READ_ENUMS_USING_TO_STRING保持一致

序列化枚举时使用枚举类型的name()方法,和SerializerFeature.WriteEnumUsingToString互斥

SerializerFeature.WriteEnumUsingName

开启

-

-

jackson的默认行为,无需配置

序列化时对Date、Calendar等类型使用ISO8601格式进行格式化,否则以timestamp形式输出Long数字

SerializerFeature.UseISO8601DateFormat

关闭

SerializationFeature.WRITE_DATES_AS_TIMESTAMPS

开启

jackson和fastjson的默认行为都是将Date数据输出为Long,建议根据不同的场景选择是否需要格式化日期

序列化List类型数据时将null输出为"[]"

SerializerFeature.WriteNullListAsEmpty

关闭

-

-

可以通过PropertyFilter/SerializerFactory.withSerializerModifier(BeanSerializerModifier)任一一种方式达到相同效果,推荐使用PropertyFilter

序列化String类型的field时将null输出为""

SerializerFeature.WriteNullStringAsEmpty

关闭

-

-

可以通过PropertyFilter/SerializerFactory.withSerializerModifier(BeanSerializerModifier)任一一种方式达到相同效果,推荐使用PropertyFilter

序列化Number类型的field时将null输出为0

SerializerFeature.WriteNullNumberAsZero

关闭

-

-

可以通过PropertyFilter/SerializerFactory.withSerializerModifier(BeanSerializerModifier)任一一种方式达到相同效果,推荐使用PropertyFilter

序列化Boolean类型的field时将null输出为false

SerializerFeature.WriteNullBooleanAsFalse

关闭

-

-

可以通过PropertyFilter/SerializerFactory.withSerializerModifier(BeanSerializerModifier)任一一种方式达到相同效果,推荐使用PropertyFilter

序列化时忽略transient修饰的field

SerializerFeature.SkipTransientField

开启

MapperFeature.PROPAGATE_TRANSIENT_MARKER

关闭

建议保持关闭,通过@JsonIgnore或者FilterProvider来指定忽略的属性

序列化时,如果未指定order,则将field按照getter方法的字典顺序排序

SerializerFeature.SortField

开启

MapperFeature.SORT_PROPERTIES_ALPHABETICALLY

关闭

建议关闭,排序会影响序列化性能(fastjson在反序列化时支持按照field顺序读取解析,因此排序后的json串有利于提高fastjson的解析性能,但jackson并没有该特性)

把\t做转义输出,已废弃,即使开启也无效

SerializerFeature.WriteTabAsSpecial

关闭

-

-

-

格式化json输出

SerializerFeature.PrettyFormat

关闭

SerializationFeature.INDENT_OUTPUT

关闭

建议保持关闭,格式化可以交给前端完成

序列化时把类型名称写入json

SerializerFeature.WriteClassName

关闭

-

-

jackson可以通过@JsonTypeInfo达到类似的效果,参见Jackson Annotation Examples

序列化时消除对同一对象循环引用的问题

SerializerFeature.DisableCircularReferenceDetect

关闭

SerializationFeature.FAIL_ON_SELF_REFERENCES

开启

保持开启,避免循环引用

对斜杠'/'进行转义

SerializerFeature.WriteSlashAsSpecial

关闭

-

-

jackson可以通过自定义Serializer实现相同效果,按需设置

将中文都会序列化为\uXXXX格式,字节数会多一些,但是能兼容IE 6

SerializerFeature.BrowserCompatible

关闭

-

-

jackson可以通过自定义Serializer实现相同效果,按需设置

全局修改日期格式,默认使用JSON.DEFFAULT_DATE_FORMAT

SerializerFeature.WriteDateUseDateFormat

关闭

-

-

jackson可以通过@JsonFormat.pattern()、ObjectMapper.setDateFormat()等方式实现相同效果

序列化时不把最外层的类型名称写入json

SerializerFeature.NotWriteRootClassName

关闭

-

-

jackson可以通过@JsonRootName达到类似的效果,参见Jackson Annotation Examples

不转义特殊字符,已废弃,即使开启也无效

SerializerFeature.DisableCheckSpecialChar

关闭

-

-

-

将Bean序列化时将field值按顺序当成json数组输出,而不是json object,同时不会输出fieldName,例如:{"id":123,"name":"xxx"}会输出成[123,"xxx"]

SerializerFeature.BeanToArray

关闭

-

-

非标准特性,jackson并不支持

序列化Map时将非String类型的key作为String类型输出,例如:{123:231}会输出成{"123":231}

SerializerFeature.WriteNonStringKeyAsString

关闭

-

-

非标准特性,jackson并不支持

序列化Byte、Short、Integer、Long、Float、Double、Boolean及其对应原始类型field时,如果属性值为各自类型的默认值(如0、0F、0L),则不会输出该属性

SerializerFeature.NotWriteDefaultValue

关闭

-

-

非标准特性,jackson并不支持

序列化时将(、)、>、<以unicode编码输出

SerializerFeature.BrowserSecure

关闭

-

-

jackson可以通过自定义Serializer实现相同效果,按需设置,通常可以交给前端处理

序列化时忽略没有实际属性对应的getter方法

SerializerFeature.IgnoreNonFieldGetter

关闭

-

-

-

序列化时把非String类型数据当作String类型输出

SerializerFeature.WriteNonStringValueAsString

关闭

-

-

jackson有一个类似的特性JsonGenerator.Feature.WRITE_NUMBERS_AS_STRINGS可以将数字作为字符串输出,但没有覆盖所有非String类型

序列化时忽略会抛异常的getter方法

SerializerFeature.IgnoreErrorGetter

关闭

-

-

-

序列化时将BigDecimal使用toPlainString()输出

SerializerFeature.WriteBigDecimalAsPlain

关闭

JsonGenerator.Feature.WRITE_BIGDECIMAL_AS_PLAIN

关闭

按需开启

序列化时对Map按照Key进行排序

SerializerFeature.MapSortField

关闭

SerializationFeature.ORDER_MAP_ENTRIES_BY_KEYS

关闭

建议关闭,开启会影响性能

序列化fastjson和jackson的特性TestCase见SerializationUseJacksonReplaceFastJsonTest.java。

更多最新 Java 技术教程可以看这个:

https://github.com/javastacks/javastack

Annotation

fastjsonzhu相对于jackson来说注解的功能划分的并没有那么细,因此fastjson的一个注解可能等价于jackson多个注解的组合。

@JSONPOJOBuilder

指定反序列化时创建java对象使用的build方法,对应jackson的@JsonPOJOBuilder最新 Java 核心技术教程,都在这了

@JSONCreator

指定反序列化时创建java对象使用的构造方法,对应jackson的@JsonCreator

@JSONField

指定序列化和反序列化field时的行为。反序列化时,等价于@JsonProperty + @JsonDeserialize + @JsonUnwrapped + @JsonFormat+ @JsonAlias;序列化时,等价于@JsonProperty + @JsonSerialize + @JsonUnwrapped + @JsonFormat + @JsonRawValue + @JsonView

代码语言:javascript
复制
@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER })
public @interface JSONField {
    // 序列化和反序列化时的字段顺序,等价于jackson的@JsonProperty.index()
    int ordinal() default 0;

    // 序列化和反序列化时的字段名称映射,等价于jackson的@JsonProperty.value()
    String name() default "";

    // 序列化和反序列化时的数据格式(日期格式、16进制等等),等价于jackson的@JsonFormat.shape() + @JsonFormat.pattern()
    String format() default "";

    // 字段是否序列化,等价于jackson的@JsonProperty.access()
    boolean serialize() default true;

    // 字段是否反序列化,等价于jackson的@JsonProperty.access()
    boolean deserialize() default true;

    // 序列化特性,等价于jackson的@JsonProperty.with()
    SerializerFeature[] serialzeFeatures() default {};

    // 反序列化特性,等价于jackson的@JsonFormat.with()
    Feature[] parseFeatures() default {};

    // 对属性进行打标,便于在序列化时进行exclude或include,等价于jackson的@JsonView
    String label() default "";

    // 序列化时将字段内容直接输出,不经过转义,等价于jackson的@JsonRawValue
    boolean jsonDirect() default false;

    // 指定序列化时使用的Serializer Class,等价于jackson的@JsonSerialize
    Class<?> serializeUsing() default Void.class;

    // 指定反序列化时使用的Deserializer Class,等价于jackson的@JsonDeserialize
    Class<?> deserializeUsing() default Void.class;

    // 指定反序列化时使用的字段别名,等价于jackson的@JsonAlias
    String[] alternateNames() default {};

    // 将字段的子属性映射到父节点上,等价于jackson的@JsonUnwrapped
    boolean unwrapped() default false;

    // 指定序列化时字段为null时使用的默认值,等价于jackson的@JsonProperty.defaultValue()
    String defaultValue() default "";
}

unwrapped的用法可以参考AnnotationUseJacksonReplaceFastJsonTest.java中的testJSONFieldUnwrapped

@JSONType

指定序列化和反序列化一个Java Bean时的行为。

代码语言:javascript
复制
@Retention(RetentionPolicy.RUNTIME)
@Target({ ElementType.TYPE })
public @interface JSONType {

    // 是否使用asm优化,jackson无对应特性
    boolean asm() default true;

    // 序列化和反序列化时的field排序,等价于jackson的@JsonPropertyOrder.value()
    String[] orders() default {};

    // 序列化和反序列化时包含的field,等价于jackson的
    String[] includes() default {};

    // 序列化和反序列化时忽略的field,等价于jackson的@JsonIgnoreProperties
    String[] ignores() default {};

    // 序列化特性,等价于jackson的@JsonProperty.with()
    SerializerFeature[] serialzeFeatures() default {};

    // 反序列化特性,等价于jackson的@JsonFormat.with()
    Feature[] parseFeatures() default {};

    // 序列化时是否依据field字母顺序排序,等价于jackson的@JsonPropertyOrder.alphabetic()
    boolean alphabetic() default true;

    // 反序列化多态类型时,如果根据其他typeName等方式无法找到正确的子类时,默认使用的子类,等价于jackson的@JsonTypeInfo.defaultImpl()
    Class<?> mappingTo() default Void.class;

    // 反序列化时指定java bean builder类(必须是@JSONPOJOBuilder注解的类),等价于jackson的@JsonDeserialize.builder()
    Class<?> builder() default Void.class;

    // 声明这个类型的别名,反序列化多态类型时使用,等价于jackson的@JsonTypeName
    String typeName() default "";

    // 反序列化某个接口或抽象类或父类的子类时指定根据哪个字段的值和子类的typeName相等来决定具体实现类,等价于jackson的@JsonTypeInfo.use() = Id.CUSTOM + @JsonTypeInfo.property()
    String typeKey() default "";

    // 反序列化某个接口或抽象类或父类的子类时指定可以反序列化的子类类型,等价于jackson的@JsonSubTypes
    Class<?>[] seeAlso() default{};

    // 指定序列化时使用的Serializer Class,等价于jackson的@JsonSerialize
    Class<?> serializer() default Void.class;

    // 指定反序列化时使用的Deserializer Class,等价于jackson的@JsonDeserialize
    Class<?> deserializer() default Void.class;

    // 序列化时,如果filed是枚举类型,则和普通的java bean一样输出枚举的filed,而不是通常使用的Enum.name()值,jackson没有对应特性
    boolean serializeEnumAsJavaBean() default false;

    // 指定json和Java bean之间的字段名称映射策略,等价于jackson的@JsonNaming
    PropertyNamingStrategy naming() default PropertyNamingStrategy.CamelCase;

    // 指定序列化时使用的Serialize filter,等价于jackson的@JsonFilter
    Class<? extends SerializeFilter>[] serialzeFilters() default {};
}

JSONObject & JSONArray

首先来看看fastjon中JSONObjectJSONArray的源码:

代码语言:javascript
复制
public class JSONObject extends JSON implements Map<String, Object>, Cloneable, Serializable, InvocationHandler {

    private final Map<String, Object> map;
    ...
}
public class JSONArray extends JSON implements List<Object>, Cloneable, RandomAccess, Serializable {

    private static final long  serialVersionUID = 1L;
    private final List<Object> list;
    protected transient Object relatedArray;
    protected transient Type   componentType;
    ...
}

从源码就可以发现,JSONObject实际是一个Map<String, Object>,而JSONArray实际是一个List<JSONObject>。因此可以将JSONObject类型改为Map<String, Object>,而JSONArray类型改为List<Object>。但是这种方式就会导致上层API出现大量修改,因为缺少了JSONObjectJSONArray提供的多种便利的类型转换方法。如果想要暂时保留JSONObjectJSONArray,此时可以采取一种取巧的方法。

暂时保留JSONObject & JSONArray的过渡方法

jackson官方提供了对org.json库的数据类型支持jackson-datatype-json-org,因此可以将com.alibaba.fastjson.JSONObject替换为org.json.JSONObjectcom.alibaba.fastjson.JSONArray替换为org.json.JSONArray,这两个类库的对象API大致相同,当然一些细小的改动还是避免不了的。如果想完全不改上层代码,那也可以参考jackson-datatype-json-org和jackson-datatype-json-lib自己实现jackson对fastjson的数据类型的binder。

larva-zhang/jackson-datatype-fastjson欢迎大家使用或提issues。

JSONPath

使用json-path/JsonPath就能轻松替换fastjson的JSONPath,而且功能比fastjson更强大。只需参考JsonProvider SPI使用JacksonJsonProvider替代json-path/JsonPath默认的JsonSmartJsonProvider即可。

自定义扩展

自定义Deserializer

fastjson中实现自定义Deserializer的方法通常是实现ObjectDeserializer接口的deserialze方法

代码语言:javascript
复制
<T> T deserialze(DefaultJSONParser parser, Type type, Object fieldName);

在jackson中实现自定义Serializer的方法则通常是继承StdDeserializer抽象类,重写deserialize方法

代码语言:javascript
复制
public abstract T deserialize(JsonParser p, DeserializationContext ctxt) throws IOException, JsonProcessingException;
自定义Serializer

fastjson中实现自定义Serializer的方法通常是实现ObjectSerializer接口的write方法

代码语言:javascript
复制
void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType, int features) throws IOException;

在jackson中实现自定义Serializer的方法则通常是继承StdSerializer抽象类,重写serialize方法

代码语言:javascript
复制
public abstract void serialize(T value, JsonGenerator gen, SerializerProvider serializers) throws IOException;
自定义Serialize Filter

fastjson中提供了6种SerializeFilter,详见fastjson/wiki/SerializeFilter。而在jackson中则是建议继承SimpleBeanPropertyFilter

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2021-05-04,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 Java技术栈 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 为什么要替换fastjson
  • 框架选型
  • 替换fastjson
  • Deserialization
  • fastjson 和 jackson的反序列化特性对照表
  • Serialization
  • fastjson 和 jackson的序列化特性对照表
  • Annotation
    • @JSONPOJOBuilder
      • @JSONCreator
        • @JSONField
          • 自定义Deserializer
          • 自定义Serializer
          • 自定义Serialize Filter
      • @JSONType
      • JSONObject & JSONArray
      • 暂时保留JSONObject & JSONArray的过渡方法
      • JSONPath
      • 自定义扩展
      相关产品与服务
      文件存储
      文件存储(Cloud File Storage,CFS)为您提供安全可靠、可扩展的共享文件存储服务。文件存储可与腾讯云服务器、容器服务、批量计算等服务搭配使用,为多个计算节点提供容量和性能可弹性扩展的高性能共享存储。腾讯云文件存储的管理界面简单、易使用,可实现对现有应用的无缝集成;按实际用量付费,为您节约成本,简化 IT 运维工作。
      领券
      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档