本文详解如何通过 Jackson 的 @JsonTypeInfo 和 @JsonSubTypes 注解，实现基于 JSON 中 type 字段值自动选择并实例化对应子类（如 MyClass1/MyClass2），从而避免手动类型判断，提升反序列化灵活性与可维护性。
本文详解如何通过 jackson 的 `@jsontypeinfo` 和 `@jsonsubtypes` 注解，实现基于 json 中 type 字段值自动选择并实例化对应子类（如 myclass1/myclass2），从而避免手动类型判断，提升反序列化灵活性与可维护性。
Jackson 默认仅根据声明类型（如 BaseClass）进行反序列化，无法自动识别运行时应创建的具体子类。要实现“根据 "type": "MyClass1" 动态构造 MyClass1 实例”，需启用其多态类型处理（Polymorphic Type Handling）机制——核心在于为基类添加元数据注解，显式告知 Jackson 如何将 JSON 中的类型标识映射到 Java 类。
关键步骤如下：
-
在基类
BaseClass上添加类型识别注解：
使用@JsonTypeInfo指定类型信息来源（此处为 JSON 属性"type"），并用@JsonSubTypes声明所有合法子类及其对应名称：
@JsonTypeInfo(
use = JsonTypeInfo.Id.NAME, // 使用自定义名称（非类全限定名）
include = JsonTypeInfo.As.PROPERTY, // 将类型信息作为 JSON 属性嵌入
property = "type" // 对应 JSON 中的字段名
)
@JsonSubTypes({
@JsonSubTypes.Type(value = MyClass1.class, name = "MyClass1"),
@JsonSubTypes.Type(value = MyClass2.class, name = "MyClass2")
})
public class BaseClass {
String id;
// 注意：type 字段仍需保留（Jackson 会自动读取并用于类型匹配，无需手动赋值）
}
-
确保子类无额外干扰注解：
MyClass1和MyClass2保持简洁，继承即可，无需重复标注（除非需定制子类序列化行为）：
public class MyClass1 extends BaseClass { /* 可扩展字段或方法 */ }
public class MyClass2 extends BaseClass { /* 可扩展字段或方法 */ }
-
反序列化时直接使用泛型集合：
ObjectMapper 会自动根据"type"值选择目标子类，无需修改SomeClass定义：
ObjectMapper mapper = new ObjectMapper();
String json = "{ \"list\": [{\"id\":\"1\",\"type\":\"MyClass1\"}, {\"id\":\"2\",\"type\":\"MyClass2\"}] }";
SomeClass result = mapper.readValue(json, SomeClass.class);
// result.list 现在包含 MyClass1 和 MyClass2 实例，而非 BaseClass
✅ 注意事项：
Wjs Localizing Video
下载
用于端到端视频本地化流程的轻量编排器，路由至四个专注子技能——/wjs-transcribing-audio、/wjs-translating-subtitles...
-
@JsonTypeInfo必须标注在基类（或接口）上，而非字段或容器类； -
name值必须与 JSON 中"type"字段的字符串严格一致（区分大小写）； - 若
BaseClass中已有type字段，Jackson 会自动将其设为反序列化后的值，但该字段不参与类型推断逻辑——推断完全由注解配置驱动； - 如需支持未知
type值，可添加@JsonSubTypes.Type(value = BaseClass.class, name = "unknown")或配置@JsonTypeInfo(defaultImpl = BaseClass.class)作为兜底。
此方案是 Jackson 处理多态 JSON 的标准实践，语义清晰、类型安全，且完全避免运行时 instanceof 判断或反射手动构造，显著提升代码健壮性与可测试性。
