前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >fastjson SerializerFeature 序列化策略

fastjson SerializerFeature 序列化策略

作者头像
用户7741497
发布2022-03-24 13:49:57
1.7K0
发布2022-03-24 13:49:57
举报
文章被收录于专栏:hml_知识记录

SerializerFeature 是啥?

代码语言:javascript
复制
JSONObject.toJSONString(实体对象, SerializerFeature.WriteMapNullValue))

SerializerFeature 源码

代码语言:javascript
复制
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序列化即可。

代码语言:javascript
复制
int features=SerializerFeature.config(JSON.DEFAULT_GENERATE_FEATURE, SerializerFeature.WriteEnumUsingName, false)
JSON.toJSONString(obj,features,SerializerFeature.EMPTY);

DisableCircularReferenceDetect

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

代码语言:javascript
复制
[
    {
        "$ref": "$.itemSkuList[0].itemSpecificationList[0]"
    },
    {
        "$ref": "$.itemSkuList[1].itemSpecificationList[0]"
    }
]
循环引用

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

代码语言:javascript
复制
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"来表示的

引用描述
代码语言:javascript
复制
"$ref":".."  上一级
"$ref":"@"   当前对象,也就是自引用
"$ref":"$"   根对象
"$ref":"$.children.0"   基于路径的引用,相当于 root.getChildren().get(0)

WriteDateUseDateFormat

代码语言:javascript
复制
JSON.DEFFAULT_DATE_FORMAT = “yyyy-MM-dd”;
JSON.toJSONString(obj, SerializerFeature.WriteDateUseDateFormat);

本文系转载,前往查看

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

本文系转载前往查看

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

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • SerializerFeature 是啥?
  • SerializerFeature 源码
  • SerializerFeature属性解释
  • 注意
    • WriteEnumUsingToString
      • DisableCircularReferenceDetect
        • 循环引用
        • 引用描述
      • WriteDateUseDateFormat
      相关产品与服务
      文件存储
      文件存储(Cloud File Storage,CFS)为您提供安全可靠、可扩展的共享文件存储服务。文件存储可与腾讯云服务器、容器服务、批量计算等服务搭配使用,为多个计算节点提供容量和性能可弹性扩展的高性能共享存储。腾讯云文件存储的管理界面简单、易使用,可实现对现有应用的无缝集成;按实际用量付费,为您节约成本,简化 IT 运维工作。
      领券
      问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档