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。