FastJson的SerializerFeature序列化特性说明

Java 专栏收录该内容
6 篇文章 0 订阅

FastJson 简单使用

我们在使用fastjson的时候,一般来讲,只需要使用最简单的API,例如

String text = JSONObject.toJSONString(obj); //序列化
VO vo = JSONObject.parseObject("{...}", VO.class); //反序列化

SerializerFeature

但是如果我们希望我们的JSON对象在序列化和反序列化有一些特殊的要求,例如使用单引号而不是双引号,我们可以通过配置来达到。

#{'a':'a','aa':'aa','ab':'ab','b':{'a':{"$ref":".."},'name':'B'},'name':'A'}
JSONObject.toJSONString(obj, SerializerFeature.UseSingleQuotes,  SerializerFeature.WriteMapNullValue,SerializerFeature.MapSortField);
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,
    WriteNonStringValueAsString,
    IgnoreErrorGetter,
    WriteBigDecimalAsPlain,
    MapSortField;
}

SerializerFeature 说明

名称含义备注
QuoteFieldNames输出key时是否使用双引号,默认为true
UseSingleQuotes使用单引号而不是双引号,默认为false
WriteMapNullValue是否输出值为null的字段,默认为false
WriteEnumUsingToStringEnum输出name()或者original,默认为false
WriteEnumUsingNameenum值序列化为其Name,默认为true
UseISO8601DateFormatDate使用ISO8601格式输出,默认为false
WriteNullListAsEmptyList字段如果为null,输出为[],而非null
WriteNullStringAsEmpty字符类型字段如果为null,输出为”“,而非null
WriteNullNumberAsZero数值字段如果为null,输出为0,而非null
WriteNullBooleanAsFalseBoolean字段如果为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将属性key写为String不推荐
NotWriteDefaultValue不设默认值不推荐
BrowserSecure不推荐
IgnoreNonFieldGetter忽略没有getter方法的属性不推荐
WriteNonStringValueAsString不是String的字段写为String
IgnoreErrorGetter忽略掉getter方法出错的属性
WriteBigDecimalAsPlain大数字写成文本
MapSortField字段按照TreeMap排序,默认false

WriteEnumUsingName || WriteEnumUsingToString

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

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

DisableCircularReferenceDetect

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

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

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

@Test
public void test(){
	A a = new A();
	B b = new B(a);
	a.setB(b);
	String text = JSONObject.toJSONString(a);
	System.out.println(text);//{"b":{"a":{"$ref":".."},"name":"B"},"name":"A"}
	A a1 = JSONObject.parseObject(text, A.class);
	System.out.println(a1 == a1.getB().getA());//true

	String text2 = JSONObject.toJSONString(a,SerializerFeature.DisableCircularReferenceDetect);//throw  java.lang.StackOverflowError
}

@Data
class A{
	String name ;

	B b;

	public A(){
		this.name = "A";
	}
}

@Data
class B{

	String name ;
	A a;

	public B(){
		this.name = "B";
	}

	public B(A a){
		this.name = "B";
		this.a = a;
	}
}

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

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

WriteDateUseDateFormat

JSONObject.DEFFAULT_DATE_FORMAT = “yyyy-MM-dd”;
JSONObject.toJSONString(obj, SerializerFeature.WriteDateUseDateFormat);	
  • 1
    点赞
  • 0
    评论
  • 10
    收藏
  • 一键三连
    一键三连
  • 扫一扫,分享海报

相关推荐
©️2020 CSDN 皮肤主题: Age of Ai 设计师:meimeiellie 返回首页
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、C币套餐、付费专栏及课程。

余额充值