Java中如何将未知类或列表作为参数实现Jackson通用反序列化方法

解决方案 #

你遇到的问题核心是Java泛型的类型擦除机制：直接在方法内部声明泛型<T>后构造new TypeReference<List<T>>()时，运行期T会被擦除为Object，Jackson无法获取到实际的元素类型。我们可以通过以下两种通用实现方案解决：

方案1：调用方传入元素Class，工具类自动构造集合类型 #

这种方案调用更简便，专门适配列表解析场景，调用时只需传入列表元素的Class对象即可：

工具类代码

import com.fasterxml.jackson.core.JsonProcessingException;
import com.fasterxml.jackson.databind.DeserializationFeature;
import com.fasterxml.jackson.databind.ObjectMapper;
import java.text.SimpleDateFormat;
import java.util.ArrayList;
import java.util.List;

public class Jackson {
    // ObjectMapper是线程安全的，全局单例即可，建议加final修饰
    private static final ObjectMapper OBJECT_MAPPER = new ObjectMapper();

    // 全局配置Jackson规则，可根据业务需求调整
    static {
        // 忽略JSON中存在但Java对象没有的属性，避免反序列化报错
        OBJECT_MAPPER.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
        // 配置全局日期格式化规则
        OBJECT_MAPPER.setDateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"));
    }

    public static <T> List<T> parseList(String json, Class<T> elementClazz) {
        List<T> resultList = new ArrayList<>();
        try {
            // 利用TypeFactory构造指定元素类型的List类型
            resultList = OBJECT_MAPPER.readValue(json,
                    OBJECT_MAPPER.getTypeFactory().constructCollectionType(List.class, elementClazz));
        } catch (JsonProcessingException e) {
            e.printStackTrace();
            // 可根据业务需求调整异常逻辑，比如抛出自定义异常、返回null等
        }
        return resultList;
    }
}

使用示例

// 解析为WorkPosition列表
List<WorkPosition> workPositions = Jackson.parseList(response.body(), WorkPosition.class);
// 解析为其他类型列表，比如User列表，直接换Class参数即可
List<User> users = Jackson.parseList(userJson, User.class);

方案2：通用泛型解析，支持任意类型（含Map、自定义泛型类等） #

如果需要适配除了List之外的其他泛型类型（比如Map<String, User>、自定义泛型对象），可以提供接收TypeReference的通用方法：

新增通用方法

在上面的Jackson工具类中新增以下方法：

import com.fasterxml.jackson.core.type.TypeReference;

public static <T> T parse(String json, TypeReference<T> typeReference) {
    try {
        return OBJECT_MAPPER.readValue(json, typeReference);
    } catch (JsonProcessingException e) {
        e.printStackTrace();
        return null;
    }
}

使用示例

// 解析为WorkPosition列表
List<WorkPosition> workPositions = Jackson.parse(response.body(), new TypeReference<List<WorkPosition>>() {});
// 解析为Map类型
Map<String, User> userMap = Jackson.parse(mapJson, new TypeReference<Map<String, User>>() {});

注意事项 #

生产环境建议不要只打印异常堆栈，可根据业务逻辑选择抛出异常或者返回约定的默认值，避免问题被隐藏。

内容的提问来源于stack exchange，提问作者osc