Java泛型方法：使用Jackson反序列化任意对象列表

立即学习“Java免费学习笔记（深入）”；

private static  List readJsonAsList(String jsonFile) throws IOException {
    ObjectMapper objectMapper = new ObjectMapper();
    // 尝试使用 TypeReference>()
    List list = objectMapper.readValue(new File(jsonFile), new TypeReference>() {});
    return list;
}

然而，这段代码并不能如预期般工作。其根本原因在于Java的类型擦除（Type Erasure）机制。在编译时，泛型类型参数 T 会被擦除，导致 TypeReference> 在运行时无法获取到 T 的具体类型信息。Jackson的 TypeReference 依赖于在运行时通过匿名内部类获取泛型参数的具体类型，但对于 T 这样的泛型类型参数，其在运行时是不可见的，因此 TypeReference 无法正确解析 ArrayList 中的 T。

解决方案：利用Jackson的TypeFactory动态构建类型

要解决类型擦除带来的问题，我们需要在运行时明确地向Jackson提供泛型类型 T 的具体信息。Jackson库为此提供了 TypeFactory，它允许我们动态地构建 JavaType 对象，从而在运行时准确地描述所需的类型结构。

STORYD

帮你写出让领导满意的精美文稿

下载

TypeFactory 中的关键方法是 constructCollectionType(Class> collectionClass, Class> elementClass)。这个方法允许我们指定集合的类型（例如 List.class 或 ArrayList.class）以及集合中元素的类型（例如 A.class 或 B.class）。

通过将元素的 Class 对象作为参数传递给泛型方法，我们就可以在运行时利用 TypeFactory 构建出正确的 JavaType，进而指导Jackson进行正确的反序列化。

通用反序列化方法的实现

下面是实现一个通用泛型反序列化方法的具体步骤：

1. 接受元素类型参数： 泛型方法需要额外接受一个 Class 类型的参数，用于指定集合中元素的具体类型。
2. 使用 TypeFactory 构建 JavaType： 通过 TypeFactory.defaultInstance().constructCollectionType(List.class, elementType) 来创建表示 List 的 JavaType。
3. 使用 InputStream 作为输入： 为了提高方法的通用性，建议使用 InputStream 而不是直接的文件路径。这样，该方法不仅可以处理文件流，还可以处理来自网络、内存或其他源的输入流。

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.type.TypeFactory;

import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.util.List;

public class GenericJsonDeserializer {

    /**
     * 通用泛型方法，用于将JSON输入流反序列化为指定类型的对象列表。
     *
     * @param inputStream JSON数据的输入流
     * @param elementType 列表中元素的Class类型，例如 A.class, B.class
     * @param  列表元素的泛型类型
     * @return 反序列化后的对象列表
     * @throws IOException 如果JSON读取或解析过程中发生错误
     */
    private static  List readAsList(InputStream inputStream, Class elementType) throws IOException {
        ObjectMapper mapper = new ObjectMapper();
        // 获取TypeFactory实例
        TypeFactory factory = mapper.getTypeFactory();
        // 动态构建 List 的 JavaType
        // 第一个参数是集合的类型（如 List.class），第二个参数是集合元素的类型（如 A.class）
        return mapper.readValue(inputStream, factory.constructCollectionType(List.class, elementType));
    }

    // 示例模型类
    private static class A {
        public String name;
        public int value;

        // 需要无参构造函数和getter/setter供Jackson使用
        public A() {}
        public A(String name, int value) {
            this.name = name;
            this.value = value;
        }

        @Override
        public String toString() {
            return "A{name='" + name + "', value=" + value + "}";
        }
    }

    private static class B {
        public String id;
        public boolean status;

        // 需要无参构造函数和getter/setter供Jackson使用
        public B() {}
        public B(String id, boolean status) {
            this.id = id;
            this.status = status;
        }

        @Override
        public String toString() {
            return "B{id='" + id + "', status=" + status + "}";
        }
    }

    public static void main(String[] args) {
        // 创建示例JSON文件
        createDummyJsonFiles();

        // 使用通用方法反序列化 List
        try (InputStream streamA = new FileInputStream("a.json")) {
            List aList = readAsList(streamA, A.class);
            System.out.println("反序列化 List 结果: " + aList);
        } catch (IOException exc) {
            System.err.println("反序列化 List 失败: " + exc.getMessage());
            exc.printStackTrace();
        }

        System.out.println("--------------------");

        // 使用通用方法反序列化 List
        try (InputStream streamB = new FileInputStream("b.json")) {
            List bList = readAsList(streamB, B.class);
            System.out.println("反序列化 List 结果: " + bList);
        } catch (IOException exc) {
            System.err.println("反序列化 List 失败: " + exc.getMessage());
            exc.printStackTrace();
        }
    }

    // 辅助方法：创建用于测试的JSON文件
    private static void createDummyJsonFiles() {
        ObjectMapper mapper = new ObjectMapper();
        try {
            // 创建 a.json
            List dummyAList = List.of(new A("ItemA1", 10), new A("ItemA2", 20));
            mapper.writeValue(new File("a.json"), dummyAList);
            System.out.println("创建 a.json 成功。");

            // 创建 b.json
            List dummyBList = List.of(new B("B_ID_1", true), new B("B_ID_2", false));
            mapper.writeValue(new File("b.json"), dummyBList);
            System.out.println("创建 b.json 成功。");

        } catch (IOException e) {
            System.err.println("创建JSON文件失败: " + e.getMessage());
            e.printStackTrace();
        }
    }
}

运行上述代码前，请确保您的项目中已添加Jackson相关的依赖，例如Maven配置：

    com.fasterxml.jackson.core
    jackson-databind
    2.17.0 

注意事项与最佳实践