likes
comments
collection
share

同事问我怎么解决使用 fastjson 进行JSON序列时属性部分丢失问题,你能说不会嘛😐

作者站长头像
站长
· 阅读数 35

🏆本文收录于《Spring Boot从入门到精通》,专门攻坚指数提升。

本专栏致力打造最硬核 Spring Boot 从零基础到进阶系列学习内容,🚀均为全网独家首发,打造精品专栏,专栏持续更新中…欢迎大家订阅持续学习。

环境说明:Windows10 + Idea2021.3.2 + Jdk1.8 + SpringBoot 2.3.1.RELEASE

1. 前言🔥

        一提到FastJson,就没有不清楚它为何物的,毕竟FastJson出自一位阿里工程师所开源的一款JSON解析器和生成器(反序列化与序列化组件),几乎所有项目都有它的身影,起码我开发过的九点九成项目都有用到它...

        此刻,于是乎很多同学便开始脑补了,作者难道今天就只是为了介绍FastJson组件这种老掉牙的知识点?从而把我们给打发咯?这也太敷衍了吧。否也否也,同学们别心急,bug菌只是抛砖引玉,好戏在后头!其实细心的同学就能发现了, 正如标题所言,如何解决这种序列化时属性会部分丢失问题,今天我要讲的就是带着同学们认识这种问题并如何优雅解决这种bug,

比如如下截图所示:

同事问我怎么解决使用 fastjson 进行JSON序列时属性部分丢失问题,你能说不会嘛😐

        像这种带isXxx的属性丢失前缀“is”的bug,如果你们在日常开发过程中遇到,会如何快速并优雅解决呢?

        那么,具体如何实现呢?这将又会是干货满满的一期,全程无尿点不废话只抓重点教,具有非常好的学习效果,拿好小板凳准备就坐!希望学习的过程中大家认真听好好学,学习的途中有任何不清楚或疑问的地方皆可评论区留言或私信,bug菌将第一时间给予解惑,那么废话不多说,直接开整!Fighting!! 

同事问我怎么解决使用 fastjson 进行JSON序列时属性部分丢失问题,你能说不会嘛😐

2 . 环境说明🔥

本地的开发环境:

  • 开发工具:IDEA 2021.3
  • JDK版本: JDK 1.8
  • Spring Boot版本:2.3.1 RELEASE
  • Maven版本:3.8.2

3. 复现问题🔥 

        既然把问题给暴露出来了,那么我们肯定是希望能够把它解决了!这也是身为一名合格开发者的基本素养!那么来吧,就让暴风雨来的更猛烈些吧。

如下我定义一个PoJo类,然后把该类的get、set方法、有参无参构造给生成好。示例代码如下:

MessageVo.java

/**
 * 通知消息结构体
 */
public class MessageVo {

    private Integer id;
    private String name;
    private String content;
    private boolean isSolve;

    public Integer getId() {
        return id;
    }

    public void setId(Integer id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getContent() {
        return content;
    }

    public void setContent(String content) {
        this.content = content;
    }

    public boolean isSolve() {
        return isSolve;
    }

    public void setSolve(boolean isSolve) {
        this.isSolve = isSolve;
    }

    //有参构造
    public MessageVo(Integer id, String name, String content, boolean isSolve) {
        this.id = id;
        this.name = name;
        this.content = content;
        this.isSolve = isSolve;
    }

    //无参构造
    public MessageVo() {
    }

        接着我们直接定义个Test测试类,进行模拟一波,使用FastJson来对此类进行序列化操作,然后将其序列化后字符串进行控制台输出打印,看看会发生一件什么事。

示例代码如下:

    //根据指定name和age组合进行数据查询
    @Test
    public void fastjsonTest() {
        //实例MessageVo对象
        MessageVo messageVo = new MessageVo(1,"张三","缴费记录丢失",true);

        // 使用fastjson序列化对象
        String jsonStr = JSON.toJSONString(messageVo);

        // 输出JSON字符串
        System.out.println(jsonStr);
    }

        同学们可以预言一下,输出的字段名是否会存在问题?可以先用大脑思考一波,我一分钟给你们公布结果!

...

一分钟到了,大家请看,控制台打印内容如下: 

同事问我怎么解决使用 fastjson 进行JSON序列时属性部分丢失问题,你能说不会嘛😐

        大家是否会觉得很奇怪啊,怎么打印的json字符串,isSolve字段名会是"solve " 而不是" isSolve "??一脸蒙对吧,其实一开始同事问我我看完她的代码后也表示觉得很假很蒙,不着急,咱们坐下来认真分析一波。

4. 分析问题🔥

        经过一通debug调试,查阅FastJson源码确定问题出现在下面这个方法中:com.alibaba.fastjson.serializer.SerializeConfig 包路径下的createJavaBeanSerializer(Class<?> clazz)方法:如下是源码展示:

 public final ObjectSerializer createJavaBeanSerializer(Class<?> clazz) {

        String className = clazz.getName();
        long hashCode64 = TypeUtils.fnv1a_64(className);
	    if (Arrays.binarySearch(denyClasses, hashCode64) >= 0) {
	        throw new JSONException("not support class : " + className);
        }

        //关键在buildBeanInfo()身上
	    SerializeBeanInfo beanInfo = TypeUtils.buildBeanInfo(clazz, null, propertyNamingStrategy, fieldBased);
	    if (beanInfo.fields.length == 0 && Iterable.class.isAssignableFrom(clazz)) {
	        return MiscCodec.instance;
	    }

	    return createJavaBeanSerializer(beanInfo);
}

        而 buildBeanInfo() 下的关键是 com.alibaba.fastjson.util.TypeUtils 包中的computeGetters()方法,给大家看下源码,你们就会明白了:

    public static List<FieldInfo> computeGetters(Class<?> clazz, //
                                                 JSONType jsonType, //
                                                 Map<String, String> aliasMap, //
                                                 Map<String, Field> fieldCacheMap, //
                                                 boolean sorted, //
                                                 PropertyNamingStrategy propertyNamingStrategy ) {
        // 省略部分代码
        if (methodName.startsWith("is")) {
            if (methodName.length() < 3) {
                continue;
            }
            if (returnType != Boolean.TYPE
                    && returnType != Boolean.class) {
                continue;
            }
            char c2 = methodName.charAt(2);
            String propertyName;
            Field field = null;
            if (Character.isUpperCase(c2)) {
                if (compatibleWithJavaBean) {
                    propertyName = decapitalize(methodName.substring(2));
                } else {
                    propertyName = Character.toLowerCase(methodName.charAt(2)) + methodName.substring(3);
                }
                // 这里 isActive 的属性名被计算出 active
                propertyName = getPropertyNameByCompatibleFieldName(fieldCacheMap, methodName, propertyName, 2);
            }

            // 省略其他

            JSONField fieldAnnotation = null;
            if (field != null) {
                fieldAnnotation = TypeUtils.getAnnotation(field, JSONField.class);
                if (fieldAnnotation != null) {
                    if (!fieldAnnotation.serialize()) {
                        continue;
                    }
                    ordinal = fieldAnnotation.ordinal();
                    serialzeFeatures = SerializerFeature.of(fieldAnnotation.serialzeFeatures());
                    parserFeatures = Feature.of(fieldAnnotation.parseFeatures());
                    if (fieldAnnotation.name().length() != 0) {
                        //关键: 使用 JSONField 注解设置的 name 替代属性名
                        propertyName = fieldAnnotation.name();
                        if (aliasMap != null) {
                            propertyName = aliasMap.get(propertyName);
                            if (propertyName == null) {
                                continue;
                            }
                        }
                    }
                    if (fieldAnnotation.label().length() != 0) {
                        label = fieldAnnotation.label();
                    }
                }
            }


            // 省略部分代码

            FieldInfo fieldInfo = new FieldInfo(propertyName, method, field, clazz, null, ordinal, serialzeFeatures, parserFeatures,
                    annotation, fieldAnnotation, label);
            fieldInfoMap.put(propertyName, fieldInfo);
        }
    }

    Field[] fields = clazz.getFields();
    computeFields(clazz, aliasMap, propertyNamingStrategy, fieldInfoMap, fields);
        return
    getFieldInfos(clazz, sorted, fieldInfoMap);
}

        上段逻辑并不复杂,判断以 'is'开头时,会从'is'后截取作为PropertyName。虽然源码中没有注释解释为何要这么做,但作者理解为这与setter/getter构造原理相似,都是通过规范去反射实现功能。其实Spring框架中依赖注入也有类似的原理。

        这下分析出了问题源头出自其就是JSON序列化时虽然能通过反射反推字段名,但序列化时中源码逻辑的确是由于规范问题,从而造成转为 JSON 字符串时和实际属性名有所偏差。

5. 解决问题🔥

        既然知道问题源头在何方了,那接下展示吧!如何解决它,要求又快又优雅。 

5.1 解决方案1

        既然由于使用FastJSON序列化所导致的部分字段丢失,那么它就考虑了该种情况如何兼容,@JSONField注解 就是一个不错的解决方案。

我们只需要在【isSolve】字段上加上该注解,并指定 key名为【isSolve】即可,代码演示如下:

    @JSONField( name="isSolve") //指定json串中key的名称
    private boolean isSolve;

再次启动测试类。

同事问我怎么解决使用 fastjson 进行JSON序列时属性部分丢失问题,你能说不会嘛😐

        查验监控台,我们可以看到,序列化后的json字段与序列化前的字段名一致了,这也是靠@JSONField注解进行别名化的作用。至于@JSONField注解的使用与教程,我会放到文末给大家简单介绍下。

5.2 解决方案2

       由于set get方法是idea自动生成,它会自动将is过滤掉,所以这里我们需要手动定义下带isXss的字段get set方法。如下是isSolve字段手写的get set方法:

    public boolean getIsSolve() {
        return isSolve;
    }

    public void setIsSolve(boolean isSolve) {
        this.isSolve = isSolve;
    }

再次启动test测试类,我们拭目以待。

同事问我怎么解决使用 fastjson 进行JSON序列时属性部分丢失问题,你能说不会嘛😐

         看测试类的输出内容,很明显,字段名输出也跟原字段名一致。

5.3 拓展:@JSONField注解

5.3.1 定义

        通过阅读@JSONField注解源码,@Target中的值为 {ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER},说明它可以作用于字段和方法上。

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.FIELD, ElementType.PARAMETER})
public @interface JSONField {

   //...
}

5.3.2 作用

        使用 @JSONField 注解可以有作用呢?这里我来给大家简单总结下:

  • 指定field 所对应的key名:例如:@JSONField(name = "user_id")
  • 对于时间字段,可指定其格式:例如: @JSONField(format = "yyyy-MM-dd HH:mm:ss")
  • 不序列化某些字段:@JSONField(serialize = false)
  • 指定顺序:@JSONField(ordinal = 1)
  • 当然,以上注解中的属性,可以同时使用:@JSONField(name = "name", format = "yyyy-MM-dd HH:mm ")

        至于具体的实例演示,这里我后期单独抽一期进行内容的讲解吧,这里就暂不详细解读了。

5.4 小结

        针对使用@JSONField注解可以解决对象isXxx字段丢失问题,但是侵入性太强了,如果有其他人也用到这个类,且用的其他JSON序列化工具不同,就很有可能造成兼容问题了。所以对于这种常见低级问题,在《阿里巴巴 Java 开发手册》中就有明确提到在POJO 类中布尔类型的变量,都不要加 'is',否则部分框架解析会引起序列化错误,如果你有认真阅读过,日常开发中这些常见性问题就能避免了,提高自己的开发效率,这才是王道。

... ...

    ok,以上就是我这期的全部内容啦,如果还想学习更多,你可以看看如下的往期热文推荐哦,每天积累一个奇淫小知识,日积月累下去,你一定能成为令人敬仰的大佬。

「赠人玫瑰,手留余香」,咱们下期拜拜~~

6. 热文推荐💭

在入门及进阶之途,我必助你一臂之力,系统性学习,从入门到精通,带你不走弯路,直奔终点;投资自己,永远性价比最高,都这么说了,你还不赶紧来学??

本文涉及所有源代码,均已上传至github开源,供同学们一对一参考 GitHub传送门

同时,原创开源不易,欢迎给个star🌟,想体验下被🌟的感jio,非常感谢❗

7. 文末💭

同事问我怎么解决使用 fastjson 进行JSON序列时属性部分丢失问题,你能说不会嘛😐

转载自:https://juejin.cn/post/7268539701941567523
评论
请登录