记一次 Json 对象转换为 Java 对象的问题

1、描述

最近在使用 Jackson 将 Json 串转换回 Java 对象的时候遇到了 ClassCastException 错误，特此记述。

2、问题复现

问题出现的节点在于属性节点的 JavaType 不明确，比如使用了泛型 和 Object，如下：

    @Getter
    @Setter
    @NoArgsConstructor
    @AllArgsConstructor
    private static class JsonResult<T> {
        private String message;
        private T result; // 问题出现在这里
    }

    @Builder
    @Getter
    @Setter
    @NoArgsConstructor
    @AllArgsConstructor
    private static class Container {
        private String key;
        private String value;
    }

使用如下的测试的用例

    @Test
    void testWrite() throws JsonProcessingException {
        final ObjectMapper mapper = new ObjectMapper();
        mapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);
        final JsonResult<Container> resultBefore = new JsonResult<>();
        resultBefore.setMessage("foo");
        final Container containerBefore = Container.builder().key("key").value("value").build();
        resultBefore.setResult(containerBefore);
        final String writtenString = mapper.writeValueAsString(resultBefore);
        //----------------read str as object
        final JsonResult parsedResult = mapper.readValue(writtenString, JsonResult.class);
        assert parsedResult != null; // 之后将在这里打断点

        final Container container = (Container) parsedResult.result;
        assertThat(container).as("not null").isNotNull().extracting(Container::getKey).as("key equal").isEqualTo(containerBefore.key);
        assertThat(container).extracting(Container::getValue).as("key equal").isEqualTo(containerBefore.value);
    }
}

将会得到错误： java.lang.ClassCastException: java.util.LinkedHashMap cannot be cast to Container

3、问题解析

让我们在测试中打上断点，看看经由 jackson 反序列化后的对象内容

　　可以看到这时候 Container 类的内容在这里变成了 hashMap，其实各种原因不难理解，在序列化跟反序列化中，我们给 Jackson 传递的 Class 是 JsonResult，回到相应类的定义，会发现我们使用的是泛型，Jackson 并不知道 rsult 中实际存放的类型，对 Object 也是如此（Object 是所有非原始类型的祖先）

　　在 ide 的提示里，我们也可以看到这时候 parsedResult 里边的 result 实际上是 Object 类型

4、思路与解决方式

4.1 思路

　　从上边的分析来，看解决的思路很简单，我们需要告诉 Jackson  result 中存放的数据类型。方法有二

4.2 解决方式

4.2.1 改变反序列化时传递的 Class 参数

4.2.1.1 泛型

　　当对象有泛型参数时候，我们只要构建一个新类型，让它继承原本的类并指定泛型参数即可。在原本的代码中，我们加入。 

private static class ContainerJsonRsult extends JsonResult<Container>{}

　　并且改变相应的反序列化语句即可。

final ContainerJsonRsult parsedResult = mapper.readValue(writtenString, ContainerJsonRsult.class);

4.2.1.2 Object

　　当对象的没有泛型签名时，我们需要构建一个新类型，让他继承原本的类，并让他拥有目标 Containner 类型的同名参数 result

    @Getter
    @Setter
    @NoArgsConstructor
    @AllArgsConstructor
    private static class ContainerJsonResult extends JsonResult {
        private Container result;
    }

　　然后修改对应的反序列语句：

final ContainerJsonResult parsedResult = mapper.readValue(writtenString, ContainerJsonResult.class);

2、在反序列化中手动传递 result 对应的 Calss 类型

对于存在泛型的类，推荐 4.2.1.1 的解决方式，当 rsult 中指向的是 Object 或者 T  类型时，都可以指定相应的 Class 类进行二次转换：

 Container container = mapper.convertValue(parsedResult.getResult(), Container.class);

　　或者

        JavaType type = mapper.getTypeFactory().constructType(Container.class);
        Container container = mapper.convertValue(parsedResult.result, type);