1 源码:

  1. //
  2. // Source code recreated from a .class file by IntelliJ IDEA
  3. // (powered by Fernflower decompiler)
  4. //
  5. package com.alibaba.fastjson.serializer;
  6. public enum SerializerFeature {
  7. QuoteFieldNames,
  8. UseSingleQuotes,
  9. WriteMapNullValue,
  10. WriteEnumUsingToString,
  11. WriteEnumUsingName,
  12. UseISO8601DateFormat,
  13. WriteNullListAsEmpty,
  14. WriteNullStringAsEmpty,
  15. WriteNullNumberAsZero,
  16. WriteNullBooleanAsFalse,
  17. SkipTransientField,
  18. SortField,
  19. /** @deprecated */
  20. @Deprecated
  21. WriteTabAsSpecial,
  22. PrettyFormat,
  23. WriteClassName,
  24. DisableCircularReferenceDetect,
  25. WriteSlashAsSpecial,
  26. BrowserCompatible,
  27. WriteDateUseDateFormat,
  28. NotWriteRootClassName,
  29. DisableCheckSpecialChar,
  30. BeanToArray,
  31. WriteNonStringKeyAsString,
  32. NotWriteDefaultValue,
  33. BrowserSecure,
  34. IgnoreNonFieldGetter;
  35. private final int mask = 1 << this.ordinal();
  36. private SerializerFeature() {
  37. }
  38. public final int getMask() {
  39. return this.mask;
  40. }
  41. public static boolean isEnabled(int features, SerializerFeature feature) {
  42. return (features & feature.getMask()) != 0;
  43. }
  44. public static boolean isEnabled(int features, int fieaturesB, SerializerFeature feature) {
  45. int mask = feature.getMask();
  46. return (features & mask) != 0 || (fieaturesB & mask) != 0;
  47. }
  48. public static int config(int features, SerializerFeature feature, boolean state) {
  49. if(state) {
  50. features |= feature.getMask();
  51. } else {
  52. features &= ~feature.getMask();
  53. }
  54. return features;
  55. }
  56. public static int of(SerializerFeature[] features) {
  57. if(features == null) {
  58. return 0;
  59. } else {
  60. int value = 0;
  61. SerializerFeature[] var2 = features;
  62. int var3 = features.length;
  63. for( int var4 = 0; var4 < var3; ++var4) {
  64. SerializerFeature feature = var2[var4];
  65. value |= feature.getMask();
  66. }
  67. return value;
  68. }
  69. }
  70. }

2 SerializerFeature属性解释

名称 含义 备注
QuoteFieldNames 输出key时是否使用双引号,默认为true
UseSingleQuotes 使用单引号而不是双引号,默认为false
WriteMapNullValue 是否输出值为null的字段,默认为false
WriteEnumUsingToString Enum输出name()或者original,默认为false
  1. 目前版本的fastjon默认对enum对象使用WriteEnumUsingName属性,因此会将enum值序列化为其Name。
    1. 使用WriteEnumUsingToString方法可以序列化时将Enum转换为toString()的返回值;同时override toString函数能够将enum值输出需要的形式。但是这样做会带来一个问题,对应的反序列化使用的Enum的静态方法valueof可能无法识别自行生成的toString(),导致反序列化出错。
    1. 如果将节省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. [
1. {
1. “$ref”: “$.itemSkuList[0].itemSpecificationList[0]”
1. },
1. {
1. “$ref”: “$.itemSkuList[1].itemSpecificationList[0]”
1. }
1. ]

| 不推荐 | | 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 | | 不推荐 |


使用:

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

也就是说是否输出值为null的字段,默认是false

近期有用到这个点,得重点关注一下