本文介绍如何借助 jackson 的多态反序列化机制（@jsontypeinfo + @jsonsubtypes），将 json 中的字符串标识（如 "text_equals"）类型安全地映射为具体策略实现类（如 textequalsmatcher），彻底替代冗长的 switch 或硬编码 map，提升可维护性与类型安全性。
本文介绍如何借助 jackson 的多态反序列化机制（@jsontypeinfo + @jsonsubtypes），将 json 中的字符串标识（如 "text_equals"）类型安全地映射为具体策略实现类（如 textequalsmatcher），彻底替代冗长的 switch 或硬编码 map，提升可维护性与类型安全性。
要实现从 JSON 字符串（如 "matcher": "text_equals"）到强类型策略对象（如 TextEqualsMatcher）的自动、类型安全反序列化，核心在于启用 Jackson 的运行时多态反序列化能力——而非依赖枚举中转或手动查找。这不仅能消除大型 switch/case 或初始化 map 的维护负担，还能在编译期捕获类型不匹配错误，并保持代码简洁与可扩展。
✅ 正确配置多态反序列化
关键在于在基接口上声明 @JsonTypeInfo 和 @JsonSubTypes，让 Jackson 知道如何根据 matcher 字段值动态选择具体子类：
@JsonTypeInfo(
use = JsonTypeInfo.Id.NAME,
include = JsonTypeInfo.As.PROPERTY,
property = "matcher", // 对应 JSON 中的字段名
defaultImpl = UnsupportedMatcher.class // 可选：兜底处理未知类型
)
@JsonSubTypes({
@JsonSubTypes.Type(value = TextEqualsMatcher.class, name = "text_equals"),
@JsonSubTypes.Type(value = TextContainsMatcher.class, name = "text_contains"),
@JsonSubTypes.Type(value = GreaterThanMatcher.class, name = "greater_than"),
@JsonSubTypes.Type(value = InListMatcher.class, name = "in_list")
})
public interface FieldMatcher {
Predicate toPredicate(CriteriaBuilder cb, Path<string> path, String value);
}</string>
⚠️ 注意：@JsonTypeInfo 必须标注在被反序列化的接口或抽象类上（此处为 FieldMatcher），且 property 值需严格匹配 JSON 中用于区分类型的字段名（本例为 "matcher"）；@JsonSubTypes 则显式注册所有合法子类及其对应 JSON 标识符。
✅ 示例实现类（无需额外注解）
子类只需实现接口，无需重复标注 @JsonTypeName（除非你希望支持双向序列化且保持字段名一致）：
public class TextEqualsMatcher implements FieldMatcher {
@Override
public Predicate toPredicate(CriteriaBuilder cb, Path<string> path, String value) {
return cb.equal(path, value);
}
}
public class GreaterThanMatcher implements FieldMatcher {
@Override
public Predicate toPredicate(CriteriaBuilder cb, Path<string> path, String value) {
return cb.greaterThan(path, value);
}
}</string></string>
✅ 集成到主数据结构中
确保 FieldElement 正确引用该多态接口，并启用泛型反序列化支持：
@JsonTypeName("field")
public record FieldElement(
@JsonProperty("id") UUID id,
@JsonProperty("value") String value,
@JsonProperty("matcher") FieldMatcher matcher // Jackson 自动按 "matcher" 值实例化对应类
) implements Filter {
@Override
public Predicate toPredicate(CriteriaBuilder cb, Path<string> path) {
return matcher.toPredicate(cb, path, value);
}
}</string>
反序列化时，Jackson 将自动读取 "matcher": "text_equals"，查找已注册的 TextEqualsMatcher 类型，并完成类型安全的实例构造——整个过程由 Jackson 运行时保障，无反射隐患，无字符串硬编码风险。
? 补充说明与最佳实践
- 类型安全性保障：若 JSON 中出现未注册的 matcher 值（如 "text_starts_with"），Jackson 默认抛出 JsonMappingException；可通过 defaultImpl 指定兜底类（如 UnsupportedMatcher）实现优雅降级。
- 避免 @JsonTypeName 冗余：在 @JsonSubTypes 已明确定义映射关系的前提下，子类上添加 @JsonTypeName 属于冗余（除非你同时需要序列化时输出该名称）。
- 模块化扩展：新增匹配器时，仅需创建新实现类 + 在 @JsonSubTypes 中追加一行，完全解耦，零侵入现有逻辑。
- 兼容 Hibernate Criteria API：此方案天然适配 CriteriaBuilder 和 Path，策略类直接封装领域逻辑，符合单一职责原则。
通过这一设计，你获得的不仅是一个“更短的 switch”，而是一套可静态验证、易扩展、低耦合、且与 Jackson 深度集成的类型驱动过滤策略体系。
