如何基于字段存在性与字段值实现 JSON 多级类型反序列化

千浩酱_2000

千浩酱_2000

2026-06-23

267人浏览

原创

如何基于字段存在性与字段值实现 JSON 多级类型反序列化

本文详解如何使用 Jackson 实现两级条件反序列化:先根据 job 或 notify 字段存在性判断抽象子类(JobCallback/NotificationCallback),再依据 object.type 值精确映射到四个具体实现类。核心在于自定义反序列化器 + 正确配置 ObjectMapper 的可见性策略。

本文详解如何使用 jackson 实现两级条件反序列化:先根据 `job` 或 `notify` 字段存在性判断抽象子类(jobcallback/notificationcallback),再依据 `object.type` 值精确映射到四个具体实现类。核心在于自定义反序列化器 + 正确配置 objectmapper 的可见性策略。

在复杂 JSON 消息路由场景中,常需根据动态字段组合决定目标 Java 类型。本例涉及四层继承结构:根抽象类 Callback → 两个中间抽象类 JobCallback 和 NotificationCallback → 四个终态实现类(如 DomainJobCallback)。反序列化逻辑需分两步决策:

  1. 第一级判别:检查 JSON 是否含 "job"(→ JobCallback)或 "notify"(→ NotificationCallback)字段;
  2. 第二级判别:解析 "object.type" 字段值("Domain" 或 "Transfer"),确定最终具体类型。

直接使用 @JsonTypeInfo 配合嵌套 @JsonSubTypes 会失败——Jackson 不支持在子类上覆盖父类的类型信息配置(jackson-databind #3358),且手动调用 treeToValue() 易引发 StackOverflowError(因递归触发同一自定义反序列器)。

✅ 正确实践:模块化注册 + 字段级可见性控制

关键在于避免递归反序列化,改用 Jackson 内置的字段访问机制直接构造对象。以下是完整可运行方案:

Miller CSV TSV JSON 数据处理器
Miller CSV TSV JSON 数据处理器

Miller (mlr) 是一个命令行工具,用于查询、整形和重新格式化名称索引数据,如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。

下载
// 1. 配置 ObjectMapper(必须!)
ObjectMapper objectMapper = new ObjectMapper();
SimpleModule module = new SimpleModule();
module.addDeserializer(Callback.class, new CallbackDeserializer());
objectMapper.registerModule(module);
// 关键:禁用 getter/setter 自动发现,启用字段直读
objectMapper.setVisibility(PropertyAccessor.ALL, JsonAutoDetect.Visibility.NONE);
objectMapper.setVisibility(PropertyAccessor.FIELD, JsonAutoDetect.Visibility.ANY);

⚠️ 注意:若不设置 PropertyAccessor.FIELD 可见性,Jackson 默认仅通过 public getter/setter 访问字段,而示例中所有字段均为 private 且无 accessor,将导致反序列化失败或空对象。

? 自定义反序列化器实现(无递归、高内聚)

public static class CallbackDeserializer extends JsonDeserializer<callback> {
    @Override
    public Callback deserialize(JsonParser p, DeserializationContext ctxt) 
            throws IOException {
        JsonNode node = p.getCodec().readTree(p);

        // 第一级:识别子类类型
        if (node.has("job")) {
            return deserializeJobCallback(node);
        } else if (node.has("notify")) {
            return deserializeNotificationCallback(node);
        }
        throw new JsonMappingException(p, "Missing 'job' or 'notify' field");
    }

    private Callback deserializeJobCallback(JsonNode node) {
        String type = node.path("object").path("type").asText();
        return switch (type) {
            case "Domain" -> new Callback.JobCallback.DomainJobCallback(
                    node.path("job").asText(),
                    new Callback.Obj(type)
            );
            case "Transfer" -> new Callback.JobCallback.TransferJobCallback(
                    node.path("job").asText(),
                    new Callback.Obj(type)
            );
            default -> throw new IllegalArgumentException("Unknown job type: " + type);
        };
    }

    private Callback deserializeNotificationCallback(JsonNode node) {
        String type = node.path("object").path("type").asText();
        return switch (type) {
            case "Domain" -> new Callback.NotificationCallback.DomainNotificationCallback(
                    node.path("notify").asText(),
                    new Callback.Obj(type)
            );
            case "Transfer" -> new Callback.NotificationCallback.TransferNotificationCallback(
                    node.path("notify").asText(),
                    new Callback.Obj(type)
            );
            default -> throw new IllegalArgumentException("Unknown notify type: " + type);
        };
    }
}</callback>

? 类定义要点(精简、无冗余注解)

@JsonDeserialize(using = CallbackDeserializer.class)
public abstract static class Callback {
    protected Obj object; // 必须为 protected 或 package-private(配合 FIELD 可见性)

    public static class Obj {
        public String type; // public 字段,或保留 private + @JsonProperty
    }

    public abstract static class JobCallback extends Callback {
        public String job;
    }

    public static class DomainJobCallback extends JobCallback {
        public DomainJobCallback(String job, Obj object) {
            this.job = job;
            this.object = object;
        }
    }

    public static class TransferJobCallback extends JobCallback {
        public TransferJobCallback(String job, Obj object) {
            this.job = job;
            this.object = object;
        }
    }

    public static class NotificationCallback extends Callback {
        public String notify;
    }

    public static class DomainNotificationCallback extends NotificationCallback {
        public DomainNotificationCallback(String notify, Obj object) {
            this.notify = notify;
            this.object = object;
        }
    }

    public static class TransferNotificationCallback extends NotificationCallback {
        public TransferNotificationCallback(String notify, Obj object) {
            this.notify = notify;
            this.object = object;
        }
    }
}

✅ 验证与最佳实践总结

  • 测试用例:对四种 JSON 样例均能正确反序列化为对应具体类,instanceof 检查返回 true;
  • 性能与安全:避免反射调用 getter/setter,减少运行时开销;显式构造确保字段完整性;
  • 扩展性:新增类型只需在 switch 中添加分支 + 新增类,无需修改反序列器主逻辑;
  • 替代方案提醒:若坚持使用 treeToValue(),需为每个具体类注册独立反序列器(非递归),但手工构造更清晰可控。

此方案平衡了 Jackson 的声明式能力与程序化控制,是处理多条件 JSON 类型路由的生产级推荐实践。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

json javascript java js

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

8697

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

5922

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

5312

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

964

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

808

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1136

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2309

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19651

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1055

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程