首页 > 编程语言 > FastJson踩坑:@JsonField在反序列化时失效的解决
2021
09-09

FastJson踩坑:@JsonField在反序列化时失效的解决

问题描述

一个对象(某个字段为枚举类型,为了不采用默认的序列化过程,用@JSONField指定了序列化器和反序列器,过程见旧博文),将其放到JSONArray中再序列化JSONArray对象,用得到的JSON字符串再反序列化时,发现能够正常反序列化出JSONArray,而对JSONArray中的某个元素再反序列化成类对象时,出错。

示例

同样用旧博文的示例做个简单测试。

基本对象类Article。

public class Article {
    private String title;
    private String content;
    @JSONField(serializeUsing = AuditStatusCodec.class, deserializeUsing = AuditStatusCodec.class)
    private AuditStatus status;
    public Article(){
    }
    public Article(String title, String content, AuditStatus status){
        this.title = title;
        this.content = content;
        this.status = status;
    }
    public String getTitle() {
        return title;
    }
    public void setTitle(String title) {
        this.title = title;
    }
    public String getContent() {
        return content;
    }
    public void setContent(String content) {
        this.content = content;
    }
    public AuditStatus getStatus() {
        return status;
    }
    public void setStatus(AuditStatus status) {
        this.status = status;
    }
    @Override
    public String toString() {
        return "Article{" +
                "title='" + title + '\'' +
                ", content='" + content + '\'' +
                ", status=" + status +
                '}';
    }
    @Override
    public boolean equals(Object o) {
        if (this == o){
            return true;
        }
        if (o == null || getClass() != o.getClass()){
            return false;
        }
        Article article = (Article) o;
        return Objects.equals(title, article.title) &&
                Objects.equals(content, article.content) &&
                status == article.status;
    }
    @Override
    public int hashCode() {
        return Objects.hash(title, content, status);
    }
}

枚举类型AuditStatus。

public enum AuditStatus {
    /**
     * 审核中
     */
    AUDITING(1),
    /**
     * 通过
     */
    PASSED(2),
    /**
     * 失败
     */
    FAILED(3);
    private int code;
    AuditStatus(int code){
        this.code = code;
    }
    public int getCode() {
        return code;
    }
    public static AuditStatus convert(int code){
        AuditStatus[] enums = AuditStatus.values();
        for(AuditStatus e : enums){
            if(e.code == code){
                return e;
            }
        }
        return null;
    }
}

以及序列化/反序列化器AuditStatusCodec

public class AuditStatusCodec implements ObjectSerializer, ObjectDeserializer {
    @Override
    public <T> T deserialze(DefaultJSONParser parser, Type type, Object fieldName) {
        Object value = parser.parse();
        return value == null ? (T) value : (T) AuditStatus.convert(TypeUtils.castToInt(value));
    }
    @Override
    public int getFastMatchToken() {
        return 0;
    }
    @Override
    public void write(JSONSerializer serializer, Object object, Object fieldName, Type fieldType, int features) throws IOException {
        serializer.write(((AuditStatus)object).getCode());
    }
}

按照出问题的情况,写模拟用例:

public class FastJsonTest {
    @Test
    public void deserializeTest(){
        testJSONParse();
        testJSONArrayParse();
    }
    protected static void testJSONParse(){
        System.out.println("**************Start Test JSON Parse");
        Article originalArticle = new Article("Article 1", "This is content", AuditStatus.AUDITING);
        String jsonStr = JSON.toJSONString(originalArticle);
        System.out.println("Serialize to json string: " + jsonStr);
        Article deserializeArticle = JSON.parseObject(jsonStr, Article.class);
        System.out.println("Deserialize to Java Object: " + deserializeArticle + "; and the status is " + deserializeArticle.getStatus());
        //Equals
        Assert.assertTrue(deserializeArticle.getStatus().equals(AuditStatus.AUDITING));
        Assert.assertEquals(originalArticle, deserializeArticle);
    }
    protected static void testJSONArrayParse(){
        System.out.println("**************Start Test JSONArray Parse");
        JSONArray arr = new JSONArray();
        Article originArticle = new Article("Article 1", "This is content", AuditStatus.AUDITING);
        arr.add(originArticle);
        String jsonArrStr = JSON.toJSONString(arr);
        System.out.println("Serialize to json array string: " + jsonArrStr);
        arr = JSON.parseArray(jsonArrStr);
        Article deserializeArticle = arr.getObject(0, Article.class);
        System.out.println("Deserialize to json arr, then to java object: " + deserializeArticle + "; ant the status is " + deserializeArticle.getStatus());
        //Not Equals
        Assert.assertFalse(deserializeArticle.getStatus().equals(AuditStatus.AUDITING));
        Assert.assertNotEquals(originArticle, deserializeArticle);
    }
}

看控制台输出的情况:

**************Start Test JSON Parse
Serialize to json string: {"content":"This is content","status":1,"title":"Article 1"}
Deserialize to Java Object: Article{title='Article 1', content='This is content', status=AUDITING}; and the status is AUDITING
**************Start Test JSONArray Parse
Serialize to json array string: [{"content":"This is content","status":1,"title":"Article 1"}]
Deserialize to json arr, then to java object: Article{title='Article 1', content='This is content', status=PASSED}; and the status is PASSED

上述代码中testJsonParse没有把类对象放到JSONArray中,可以从结果中看出序列化和反序列化过程均正常。

而testJSONArrayParse先把类对象放到JSONArray中,在从JSONArray中取出对象反序列化,反序列化的结果就不正常了。

疑问

为什么JSONObject和JSONArray的反序列化过程得到的结果不一致?两者的反序列过程差异在哪?

DEBUG

遇事不决,开始DEBUG。

JSON.parseObject的流程

首先,JSON是一个门面类,提供出一些静态的方法供外部使用。比如说parseObject()方法。其内部会创建解析器DefaultJSONParser,并将解析委托给解析器执行。

DefualtJSONParser在创建时接受输入,全局配置及特性,相当于获取到了本次解析所有的数据。同时DefualtJSONParser的内部创建了一些用于解析的组件,例如JSONLexer(用于字符串解析)。解析过程在parseObject中执行,parseObject会通过ParseConfig(保存解析配置的一个全局对象)获取到解析器ObjectDeserializer,并由解析器处理真正的解析过程。

在通过Class获取ObjectDeserializer时,首先会确定ParserConfig中是否缓存了对应的反序列化器,如果不存在,则会新建一个JavaBeanDeserializer(对于一般Java对象而言)。在新建过程中,会解析Class的属性,并保存在JavaBeanInfo中。 解析器的解析过程就是对比JSON字符串中的KEY和JavaBeanInfo的过程,把对应的值反序列化出来(判断是否有JSONField注解,并根据注解的属性处理也在这一步),最终还原对象。

以流程图表示上述过程:

JSONArray.getObject()

JSONArray.getObject()会先从JSONArray中获取出Object,然后调用TypeUtils对Object通过TypeUtils.castToJavaBean()转型。

TypeUtils通过根据需要转型的类型从ParserConfig中获取ObjectDeserializer反序列化器,对于普通 Java Bean 而言,是JavaBeanDeserializer。

由于JSONArray中取出的Object实际上是JSONObject对象,因此会由JavaBeanDeserializer反序列化器的createInstance()方法执行反序列化,得到对象。

以流程图表示上述过程:

deserialize 和 createInstance 的不同

deserialize在反序列化时,会从class上获取更多的属性,其中就包括JSONField注解上的信息,而createInstance获取的信息较少,因此忽略JSONField所带的信息,导致自定义的反序列化器在反序列化时失效。

疑惑

为什么都是反序列化过程,二者在行为和表现上会有所不同?官方是如何定义deserialize和createInstance的?

上述这些问题还需要查询更多资料来明确。也希望了解缘由的读者进行告知。

问题的解决方式

解决的办法不先转换成JSONArray,然后再反序列化对象。而是通过JSON.parseArray直接转成对象的List。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持自学编程网。

编程技巧