fastjson:SerializerFeature属性使用

简介: fastjson:SerializerFeature属性使用


fastjson:SerializerFeature源码


//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by Fernflower decompiler)
//
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,
    DisableCheckSpecialChar,
    BeanToArray,
    WriteNonStringKeyAsString,
    NotWriteDefaultValue,
    BrowserSecure,
    IgnoreNonFieldGetter;
    private final int mask = 1 << this.ordinal();
    private SerializerFeature() {
    }
    public final int getMask() {
        return this.mask;
    }
    public static boolean isEnabled(int features, SerializerFeature feature) {
        return (features & feature.getMask()) != 0;
    }
    public static boolean isEnabled(int features, int fieaturesB, SerializerFeature feature) {
        int mask = feature.getMask();
        return (features & mask) != 0 || (fieaturesB & mask) != 0;
    }
    public static int config(int features, SerializerFeature feature, boolean state) {
        if(state) {
            features |= feature.getMask();
        } else {
            features &= ~feature.getMask();
        }
        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.getMask();
            }
            return value;
        }
    }
}


SerializerFeature属性解释


名称 含义 备注
QuoteFieldNames 输出key时是否使用双引号,默认为true  
UseSingleQuotes 使用单引号而不是双引号,默认为false  
WriteMapNullValue 是否输出值为null的字段,默认为false  
WriteEnumUsingToString

Enum输出name()或者original,默认为false

  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);

 
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

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

  1.  [  
  2.       {  
  3.         "$ref": "$.itemSkuList[0].itemSpecificationList[0]"  
  4.       },   
  5.       {  
  6.         "$ref": "$.itemSkuList[1].itemSpecificationList[0]"  
  7.       }  
  8.     ]  

 

循环引用

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

 

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

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

引用描述

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

 

 

不推荐
WriteSlashAsSpecial 对斜杠’/’进行转义 不推荐
BrowserCompatible 将中文都会序列化为\uXXXX格式,字节数会多一些,但是能兼容IE 6,默认为false 不推荐
WriteDateUseDateFormat 全局修改日期格式,默认为false。
JSON.DEFFAULT_DATE_FORMAT = “yyyy-MM-dd”;
JSON.toJSONString(obj, SerializerFeature.WriteDateUseDateFormat);
不推荐
DisableCheckSpecialChar 一个对象的字符串属性中如果有特殊字符如双引号,将会在转成json时带有反斜杠转移符。如果不需要转义,可以使用这个属性。默认为false 不推荐
NotWriteRootClassName 含义 不推荐
BeanToArray 将对象转为array输出 不推荐
WriteNonStringKeyAsString   不推荐
NotWriteDefaultValue   不推荐
BrowserSecure   不推荐
IgnoreNonFieldGetter   不推荐


JAVA使用


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

 


相关文章
|
10月前
|
存储 机器学习/深度学习 人工智能
​​解锁AI检索的7大Embedding技术:从稀疏到多向量,一文掌握!​
本文系统解析七种主流文本嵌入技术,包括 Sparse、Dense、Quantized、Binary、Matryoshka 和 Multi-Vector 方法,结合适用场景提供实用选型建议,助你高效构建文本检索系统。
1217 0
|
SQL 机器学习/深度学习 XML
mybatis-plus分页查询详解
mybatis-plus分页查询详解
11920 0
mybatis-plus分页查询详解
|
安全 定位技术 数据安全/隐私保护
GIS开发:国内互联网地图的坐标系
导航电子地图公开前需按《导航电子地图安全处理技术基本要求》进行空间位置技术处理,由官方指定机构统一实施。国内地图如高德、腾讯及谷歌中国采用GCJ02坐标系,百度则使用二次加密的BD09坐标系。这些坐标系基于WGS84(全球通用坐标系)进行了加密偏移以确保安全。设备获取的WGS84坐标需转换至相应坐标系以正确显示。开源工具如`coordtransform`可用于坐标转换,而天地图提供的在线切片未做偏移,可直接匹配WGS84坐标。
938 0
|
SpringCloudAlibaba Java Nacos
nacos源码分析-服务注册(客户端)
一直都想写SpringCloudAlibaba的源码分析,终于开始动手第一篇了,如果想要看懂Nacos源码至少要把《SpringBoot自动》配置看了,不然就是看天书。本篇文章呢带大家一起来看一下Nacos-Client 客户端服务注册这一部分的源码。
|
人工智能 分布式计算 Java
说说XXLJob分片任务实现原理?
说说XXLJob分片任务实现原理?
2791 0
说说XXLJob分片任务实现原理?
idea启动java服务报错OutOfMemoryError: GC overhead limit exceeded解决方法
idea启动java服务报错OutOfMemoryError: GC overhead limit exceeded解决方法
9634 3
|
Java
gradlew与jdk版本不匹配,可以通过配置指定jdk 版本
gradlew与jdk版本不匹配,可以通过配置指定jdk 版本
2822 0
|
JSON 前端开发 fastjson
fastjson全局序列化坑
fastjson全局序列化坑
367 0
|
缓存 算法 NoSQL
短信验证码登录接口,如何防止恶意攻击
该文讨论了移动应用中常见的手机短信验证码登录(短验登录)的安全设计。后端通常需要提供获取短信验证码和手机短验登录两个API。为了增强机短验登录API的安全性,提出了几种无需依赖Redis等存储介质的方案:1)使用数字签名确保请求合法性;2)基于时间戳的验证,允许在一定时间范围内有效;3)应用TOTP算法生成动态码进行验证;4)利用JWTToken进行身份验证并设置有效期。文章强调了创新思考在解决安全问题中的重要性,并鼓励读者分享更多方案。
1432 1