fastjson SerializerFeature 序列化策略

引用博文 : JSONObject 项目启动时初始化fastjson的Provider -> https://blog.csdn.net/zxl2016/article/details/80987414

SerializerFeature 是啥?

JSONObject.toJSONString(实体对象, SerializerFeature.WriteMapNullValue))

SerializerFeature 源码

package com.alibaba.fastjson.serializer;

public enum SerializerFeature {
   QuoteFieldNames,
   UseSingleQuotes,
   WriteMapNullValue,
   WriteEnumUsingToString,
   WriteEnumUsingName,
   UseISO8601DateFormat,
   WriteNullListAsEmpty,
   WriteNullStringAsEmpty,
   WriteNullNumberAsZero,
   WriteNullBooleanAsFalse,
   SkipTransientField,
   SortField,
   /** @deprecated */
   @Deprecated
   WriteTabAsSpecial,
   PrettyFormat,
   WriteClassName,
   DisableCircularReferenceDetect,
   WriteSlashAsSpecial,
   BrowserCompatible,
   WriteDateUseDateFormat,
   NotWriteRootClassName,
   /** @deprecated */
   DisableCheckSpecialChar,
   BeanToArray,
   WriteNonStringKeyAsString,
   NotWriteDefaultValue,
   BrowserSecure,
   IgnoreNonFieldGetter;

   public final int mask = 1 << this.ordinal();
   public static final SerializerFeature[] EMPTY = new SerializerFeature[0];
   public static final int WRITE_MAP_NULL_FEATURES = WriteMapNullValue.getMask() | WriteNullBooleanAsFalse.getMask() | WriteNullListAsEmpty.getMask() | WriteNullNumberAsZero.getMask() | WriteNullStringAsEmpty.getMask();

   private SerializerFeature() {
   }

   public final int getMask() {
       return this.mask;
   }

   public static boolean isEnabled(int features, SerializerFeature feature) {
       return (features & feature.mask) != 0;
   }

   public static boolean isEnabled(int features, int fieaturesB, SerializerFeature feature) {
       int mask = feature.mask;
       return (features & mask) != 0 || (fieaturesB & mask) != 0;
   }

   public static int config(int features, SerializerFeature feature, boolean state) {
       if (state) {
           features |= feature.mask;
       } else {
           features &= ~feature.mask;
       }

       return features;
   }

   public static int of(SerializerFeature[] features) {
       if (features == null) {
           return 0;
       } else {
           int value = 0;
           SerializerFeature[] var2 = features;
           int var3 = features.length;

           for(int var4 = 0; var4 < var3; ++var4) {
               SerializerFeature feature = var2[var4];
               value |= feature.mask;
           }

           return value;
       }
   }
}

SerializerFeature属性解释

名称 含义 备注
QuoteFieldNames 输出key时是否使用双引号,默认为true
UseSingleQuotes 使用单引号而不是双引号,默认为false
WriteMapNullValue 是否输出值为null的字段,默认为false
WriteEnumUsingToString Enum输出name()或者ordinal
WriteEnumUsingName
UseISO8601DateFormat Date使用ISO8601格式输出,默认为false
WriteNullListAsEmpty List字段如果为null,输出为[],而非null
WriteNullStringAsEmpty 字符类型字段如果为null,输出为”“,而非null
WriteNullNumberAsZero 数值字段如果为null,输出为0,而非null
WriteNullBooleanAsFalse Boolean字段如果为null,输出为false,而非null
SkipTransientField 如果是true,类中的Get方法对应的Field是transient,序列化时将会被忽略。
默认为true
SortField 按字段名称排序后输出。默认为false
WriteTabAsSpecial 把\t做转义输出,默认为false 不推荐
PrettyFormat 结果是否格式化,默认为false 不推荐
WriteClassName 序列化时写入类型信息,默认为false。反序列化是需用到 不推荐
DisableCircularReferenceDetect 消除对同一对象循环引用的问题,默认为false 不推荐
WriteSlashAsSpecial 对斜杠’/’进行转义 不推荐
BrowserCompatible 将中文都会序列化为\uXXXX格式,字节数会多一些,但是能兼容IE 6,默认为false 不推荐
WriteDateUseDateFormat 全局修改日期格式,默认为false。 不推荐
DisableCheckSpecialChar 一个对象的字符串属性中如果有特殊字符如双引号,将会在转成json时带有反斜杠转移符。如果不需要转义,可以使用这个属性。默认为false 不推荐
NotWriteRootClassName 不推荐
BeanToArray 将对象转为array输出 不推荐
WriteNonStringKeyAsString 不推荐
NotWriteDefaultValue 不推荐
BrowserSecure 不推荐
IgnoreNonFieldGetter 不推荐

注意

WriteEnumUsingToString

  1. 目前版本的fastjon默认对enum对象使用WriteEnumUsingName属性,因此会将enum值序列化为其Name。
  2. 使用WriteEnumUsingToString方法可以序列化时将Enum转换为toString()的返回值;同时override toString函数能够将enum值输出需要的形式。但是这样做会带来一个问题,对应的反序列化使用的Enum的静态方法valueof可能无法识别自行生成的toString(),导致反序列化出错。
  3. 如果将节省enum序列化后的大小,可以将enum序列化其ordinal值,保存为int类型。fastJson在反序列化时,如果值为int,则能够使用ordinal值匹配,找到合适的对象。

fastjson要将enum序列化为ordinal只需要禁止WriteEnumUsingName feature。
首先根据默认的features排除WriteEnumUsingName,然后使用新的features序列化即可。

int features=SerializerFeature.config(JSON.DEFAULT_GENERATE_FEATURE, SerializerFeature.WriteEnumUsingName, false)
JSON.toJSONString(obj,features,SerializerFeature.EMPTY);

DisableCircularReferenceDetect

当进行toJSONString的时候,默认如果重用对象的话,会使用引用的方式进行引用对象。

[
    {
        "$ref": "$.itemSkuList[0].itemSpecificationList[0]"
    },
    {
        "$ref": "$.itemSkuList[1].itemSpecificationList[0]"
    }
]

循环引用

很多场景中,我们需要序列化的对象中存在循环引用,在许多的json库中,这会导致stackoverflow。在功能强大的fastjson中,你不需要担心这个问题。例如:

A a = new A();  
B b = new B(a);  
a.setB(b);  
String text = JSON.toJSONString(a); //{"b":{"a":{"$ref":".."}}}  
A a1 = JSON.parseObject(text, A.class);  
Assert.assertTrue(a1 == a1.getB().getA()); 

引用是通过"$ref"来表示的

引用描述

"$ref":".."  上一级
"$ref":"@"   当前对象,也就是自引用
"$ref":"$"   根对象
"$ref":"$.children.0"   基于路径的引用,相当于 root.getChildren().get(0)

WriteDateUseDateFormat

JSON.DEFFAULT_DATE_FORMAT = “yyyy-MM-dd”;
JSON.toJSONString(obj, SerializerFeature.WriteDateUseDateFormat);
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,284评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,115评论 3 395
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,614评论 0 354
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,671评论 1 293
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,699评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,562评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,309评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,223评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,668评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,859评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,981评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,705评论 5 347
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,310评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,904评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,023评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,146评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,933评论 2 355

推荐阅读更多精彩内容