Jackson解析：将复杂嵌套JSON映射至父/子类结构的非标准POJO

嘿，这个问题我帮不少开发者处理过，Jackson应对这种“API返回未知类型对象、需要自动映射到对应子类”的场景，有几套成熟的玩法，刚好适配你的需求。下面给你拆解最常用的几种：

1. 官方推荐：用@JsonTypeInfo+@JsonSubTypes注解（最省心） #

这是Jackson原生支持的标准多态映射方案，核心是靠一个类型标识字段来区分不同子类——比如API返回的JSON里可能有个type字段，值是user或者product，我们就用这个字段告诉Jackson该映射到哪个子类。

举个具体的代码例子，假设你的父类是BaseResponse，子类是UserResponse和ProductResponse：

import com.fasterxml.jackson.annotation.JsonTypeInfo;
import com.fasterxml.jackson.annotation.JsonSubTypes;

// 告诉Jackson：用JSON里的"type"字段作为类型标识，用名称来区分不同子类
@JsonTypeInfo(
    use = JsonTypeInfo.Id.NAME,
    include = JsonTypeInfo.As.PROPERTY,
    property = "type" // 这里填API返回JSON里的类型标识字段名，比如你的API可能用"responseType"，就改这里
)
// 把所有子类和对应的标识值做映射
@JsonSubTypes({
    @JsonSubTypes.Type(value = UserResponse.class, name = "user"),
    @JsonSubTypes.Type(value = ProductResponse.class, name = "product")
})
public abstract class BaseResponse {
    // 父类的公共字段，比如返回码、提示信息
    private int code;
    private String message;
    // getter/setter 就不写了，你懂的
}

// 子类1：用户相关返回
public class UserResponse extends BaseResponse {
    private String username;
    private String email;
}

// 子类2：商品相关返回
public class ProductResponse extends BaseResponse {
    private String productId;
    private double price;
}

这样Jackson解析的时候，会自动读type字段的值，匹配到对应的子类，完全不用你手动判断。如果你的API没有现成的类型标识字段，也可以用@JsonTypeInfo.Id.CLASS（直接用类的全路径当标识，但灵活性差点），或者自己加一个标识字段。

2. 自定义类型解析器（适合复杂判断场景） #

如果API返回的JSON没有明显的类型标识字段，或者需要靠多个字段组合判断（比如同时存在userId和orderId才是某子类），那可以自定义类型解析器，完全掌控判断逻辑。

步骤大概是：

• 写一个TypeResolverBuilder的实现类，重写类型序列化和反序列化的方法，在里面写你的判断逻辑
• 把这个自定义解析器注册到ObjectMapper里：

ObjectMapper mapper = new ObjectMapper();
mapper.setDefaultTyping(new YourCustomTypeResolverBuilder());

这种方式自由度最高，但代码量会多一点，适合特殊场景。

3. 给父类指定自定义反序列化器（子类少的时候用） #

如果你的子类数量不多，判断逻辑也简单，直接给父类加个自定义反序列化器就行——手动读JSON的字段，判断该映射到哪个子类。

示例代码：

import com.fasterxml.jackson.databind.deser.std.StdDeserializer;
import com.fasterxml.jackson.core.JsonParser;
import com.fasterxml.jackson.databind.DeserializationContext;
import com.fasterxml.jackson.databind.JsonNode;
import java.io.IOException;

// 告诉Jackson用这个自定义反序列化器来解析BaseResponse
@JsonDeserialize(using = BaseResponseDeserializer.class)
public abstract class BaseResponse {
    // 父类公共字段
}

public class BaseResponseDeserializer extends StdDeserializer<BaseResponse> {
    protected BaseResponseDeserializer() {
        super(BaseResponse.class);
    }

    @Override
    public BaseResponse deserialize(JsonParser p, DeserializationContext ctxt) throws IOException {
        JsonNode node = p.getCodec().readTree(p);
        // 手动判断：比如有username字段就是UserResponse，有productId就是ProductResponse
        if (node.has("username")) {
            return p.getCodec().treeToValue(node, UserResponse.class);
        } else if (node.has("productId")) {
            return p.getCodec().treeToValue(node, ProductResponse.class);
        }
        // 处理未知类型的情况，抛异常或者返回默认对象都行
        throw new IOException("Unknown response type received");
    }
}

这种方式很直观，写起来快，适合子类不多的场景。

几个注意点 #

• 所有子类必须有无参构造函数，Jackson默认靠这个实例化对象
• 如果JSON字段和Java类字段名不匹配，记得用@JsonProperty("json_field_name")来映射
• 测试的时候一定要覆盖所有可能的返回类型，避免漏处理

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