登录注册

当前位置：首页 > 文章列表 > 文章 > java教程 > Jackson多态反序列化实战技巧

Jackson多态反序列化实战技巧

2025-12-05 08:48:58 0浏览 收藏
推广推荐
免费电影APP ➜
支持 PC / 移动端，安全直达

知识点掌握了，还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战，手把手教大家学习《Java Jackson 多态反序列化技巧》，在实现功能的过程中也带大家重新温习相关知识点，温故而知新，回头看看说不定又有不一样的感悟！

Java Jackson 库中多态类型反序列化：处理父类属性为子类实例

本教程深入探讨了在 Java 中使用 Jackson 库进行多态反序列化时，如何将 JSON 中的父类属性正确地反序列化为子类实例。文章重点介绍了 `@JsonTypeInfo` 和 `@JsonSubTypes` 注解的用法，并解决了在 JSON 数据中缺少类型标识符时遇到的常见问题，强调了 JSON 结构与注解配置保持一致的重要性，提供了修改 JSON 结构以实现预期反序列化的解决方案。

在 Java 开发中，处理多态类型是常见的需求，尤其是在对象序列化和反序列化时。当一个类（如 Family）包含一个父类类型的属性（如 Parent），但实际运行时该属性可能是一个具体的子类实例（如 ChildA 或 ChildB）时，Jackson 库在反序列化过程中需要明确的指导才能正确地将 JSON 数据映射到对应的子类对象。

理解多态反序列化挑战

考虑以下类结构：

// Family 类包含一个 Parent 类型的属性
class Family {
    String address;
    Parent parent; // 实际运行时可能是 ChildA 或 ChildB
    // ... 其他属性和方法
}

// Parent 是基类
class Parent {
    String parentAttribute;
    // ... 其他属性和方法
}

// ChildA 继承自 Parent
class ChildA extends Parent {
    String attributeA;
    // ... 其他属性和方法
}

// ChildB 继承自 Parent
class ChildB extends Parent {
    String attributeB;
    // ... 其他属性和方法
}

假设我们有一个 JSON 字符串，它代表一个 Family 对象，其中 parent 字段实际上是一个 ChildA 的实例，例如：

{
    "address": "123 Main St",
    "parent": {
        "parentAttribute": "Mom",
        "attributeA": "Child A Type"
    }
}

当我们尝试将这个 JSON 反序列化为 Family 对象时，如果没有额外的配置，Jackson 默认会将 parent 字段反序列化为 Parent 类型，而 attributeA 这样的子类特有属性则会被忽略，因为 Parent 类中没有定义这些属性。为了让 Jackson 能够识别并创建正确的子类实例，我们需要使用 Jackson 提供的多态类型处理机制。

使用 Jackson 注解实现多态反序列化

Jackson 提供了 @JsonTypeInfo 和 @JsonSubTypes 注解来处理多态类型的序列化和反序列化。

  1. @JsonTypeInfo: 这个注解应用于父类（或接口），用于指示 Jackson 如何在 JSON 中包含类型信息。

    • use = JsonTypeInfo.Id.NAME: 指定使用一个逻辑名称作为类型标识符。
    • include = JsonTypeInfo.As.PROPERTY: 指定类型信息作为 JSON 对象的一个独立属性包含。
    • property = "type": 定义这个类型标识符属性的名称，例如 type。

  2. @JsonSubTypes: 这个注解也应用于父类（或接口），用于将逻辑名称映射到具体的子类。

    • @JsonSubTypes.Type(value = ChildA.class, name = "A"): 将逻辑名称 "A" 映射到 ChildA 类。
    • @JsonSubTypes.Type(value = ChildB.class, name = "B"): 将逻辑名称 "B" 映射到 ChildB 类。

根据上述说明，我们修改 Parent 类：

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

@JsonTypeInfo(
        use = JsonTypeInfo.Id.NAME,
        include = JsonTypeInfo.As.PROPERTY,
        property = "type")
@JsonSubTypes({
        @JsonSubTypes.Type(value = ChildA.class, name = "A"),
        @JsonSubTypes.Type(value = ChildB.class, name = "B")
})
class Parent {
    String parentAttribute;
    // ... 构造函数、getter/setter
}

class ChildA extends Parent {
    String attributeA;
    // ... 构造函数、getter/setter
}

class ChildB extends Parent {
    String attributeB;
    // ... 构造函数、getter/setter
}

class Family {
    String address;
    Parent parent;
    // ... 构造函数、getter/setter
}

解决“缺少类型标识符”问题

在上述注解配置完成后，当我们尝试反序列化最初的 JSON 字符串时，可能会遇到以下错误：

com.fasterxml.jackson.databind.exc.InvalidTypeIdException: Could not resolve subtype of [simple type, class Family ]: missing type id property 'type' (for POJO property 'parent')

这个错误信息明确指出问题所在：Jackson 在尝试反序列化 parent 属性时，期望在 JSON 数据中找到一个名为 type 的属性来确定具体的子类类型，但当前的 JSON 字符串中缺少这个 type 属性。

原始的 JSON 结构：

{
    "address": "123 Main St",
    "parent": {
        "parentAttribute": "Mom",
        "attributeA": "Child A Type"
    }
}

它并没有包含任何 type 字段，因此 Jackson 无法根据 @JsonTypeInfo 的配置识别出是 ChildA 还是 ChildB。

解决方案：修改 JSON 结构以包含类型标识符

最直接且推荐的解决方案是修改 JSON 字符串，使其包含 Jackson 所期望的类型标识符属性。根据 @JsonTypeInfo(..., property = "type") 的配置，我们需要在 parent 对象内部添加一个 type 属性，其值对应 @JsonSubTypes 中定义的 name。

例如，如果 parent 属性实际上是 ChildA 类型，那么 JSON 应该修改为：

{
    "address": "123 Main St",
    "parent": {
        "type": "A", // 添加类型标识符
        "parentAttribute": "Mom",
        "attributeA": "Child A Type"
    }
}

如果 parent 属性是 ChildB 类型，则 JSON 应该是：

{
    "address": "123 Main St",
    "parent": {
        "type": "B", // 添加类型标识符
        "parentAttribute": "Dad",
        "attributeB": "Child B Type"
    }
}

有了这个 type 字段，Jackson 在反序列化时就能正确地识别出 parent 属性应该被反序列化为 ChildA 或 ChildB 的实例。

示例代码：完整反序列化流程

以下是一个完整的 Java 示例，演示如何使用修改后的 JSON 字符串进行多态反序列化：

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

// Family 类
class Family {
    public String address;
    public Parent parent;

    public Family() {} // Jackson 需要无参构造函数
    public Family(String address, Parent parent) {
        this.address = address;
        this.parent = parent;
    }

    @Override
    public String toString() {
        return "Family{" +
               "address='" + address + '\'' +
               ", parent=" + parent +
               '}';
    }
}

// Parent 基类，添加多态注解
@JsonTypeInfo(
        use = JsonTypeInfo.Id.NAME,
        include = JsonTypeInfo.As.PROPERTY,
        property = "type")
@JsonSubTypes({
        @JsonSubTypes.Type(value = ChildA.class, name = "A"),
        @JsonSubTypes.Type(value = ChildB.class, name = "B")
})
abstract class Parent { // 建议将基类声明为抽象类
    public String parentAttribute;

    public Parent() {}
    public Parent(String parentAttribute) {
        this.parentAttribute = parentAttribute;
    }

    @Override
    public String toString() {
        return "Parent{" +
               "parentAttribute='" + parentAttribute + '\'' +
               '}';
    }
}

// ChildA 子类
class ChildA extends Parent {
    public String attributeA;

    public ChildA() {}
    public ChildA(String parentAttribute, String attributeA) {
        super(parentAttribute);
        this.attributeA = attributeA;
    }

    @Override
    public String toString() {
        return "ChildA{" +
               "parentAttribute='" + parentAttribute + '\'' +
               ", attributeA='" + attributeA + '\'' +
               '}';
    }
}

// ChildB 子类
class ChildB extends Parent {
    public String attributeB;

    public ChildB() {}
    public ChildB(String parentAttribute, String attributeB) {
        super(parentAttribute);
        this.attributeB = attributeB;
    }

    @Override
    public String toString() {
        return "ChildB{" +
               "parentAttribute='" + parentAttribute + '\'' +
               ", attributeB='" + attributeB + '\'' +
               '}';
    }
}

public class PolymorphicDeserializationDemo {
    public static void main(String[] args) throws Exception {
        ObjectMapper objectMapper = new ObjectMapper();

        // 示例 JSON 字符串，包含 ChildA 类型信息
        String jsonStringA = "{" +
                             "\"address\": \"123 Main St\"," +
                             "\"parent\": {" +
                             "\"type\": \"A\"," + // 关键的类型标识符
                             "\"parentAttribute\": \"Mom\"," +
                             "\"attributeA\": \"Child A Type\"" +
                             "}" +
                             "}";

        // 示例 JSON 字符串，包含 ChildB 类型信息
        String jsonStringB = "{" +
                             "\"address\": \"456 Oak Ave\"," +
                             "\"parent\": {" +
                             "\"type\": \"B\"," + // 关键的类型标识符
                             "\"parentAttribute\": \"Dad\"," +
                             "\"attributeB\": \"Child B Type\"" +
                             "}" +
                             "}";

        // 反序列化 ChildA
        Family familyA = objectMapper.readValue(jsonStringA, Family.class);
        System.out.println("Deserialized Family A: " + familyA);
        System.out.println("Parent type in Family A: " + familyA.parent.getClass().getName());
        if (familyA.parent instanceof ChildA) {
            ChildA childA = (ChildA) familyA.parent;
            System.out.println("ChildA specific attribute: " + childA.attributeA);
        }
        System.out.println("------------------------------------");

        // 反序列化 ChildB
        Family familyB = objectMapper.readValue(jsonStringB, Family.class);
        System.out.println("Deserialized Family B: " + familyB);
        System.out.println("Parent type in Family B: " + familyB.parent.getClass().getName());
        if (familyB.parent instanceof ChildB) {
            ChildB childB = (ChildB) familyB.parent;
            System.out.println("ChildB specific attribute: " + childB.attributeB);
        }
    }
}

输出示例：

Deserialized Family A: Family{address='123 Main St', parent=ChildA{parentAttribute='Mom', attributeA='Child A Type'}}
Parent type in Family A: ChildA
ChildA specific attribute: Child A Type
------------------------------------
Deserialized Family B: Family{address='456 Oak Ave', parent=ChildB{parentAttribute='Dad', attributeB='Child B Type'}}
Parent type in Family B: ChildB
ChildB specific attribute: Child B Type

从输出可以看出，Jackson 成功地将 parent 属性反序列化成了正确的子类 (ChildA 或 ChildB) 实例。

注意事项与总结

  1. JSON 结构与注解匹配是关键：Jackson 的多态反序列化机制依赖于 JSON 数据中明确的类型标识符。@JsonTypeInfo 配置的 property 名称（例如 type）必须与 JSON 中实际的字段名一致。
  2. 控制 JSON 源：如果能够控制 JSON 数据的生成方，那么在 JSON 中包含类型标识符是最简单、最健壮的解决方案。
  3. 自定义反序列化器（高级场景）：如果无法修改 JSON 结构（例如，接收的是第三方数据源），并且 JSON 中没有明确的类型标识符，但可以通过其他属性的组合来推断类型，那么可能需要实现自定义的 JsonDeserializer。然而，这种方法通常更复杂，且容易出错，因为它需要手动编写类型推断逻辑。
  4. 基类设计：将多态基类（如 Parent）设计为抽象类是一个好习惯，因为它通常不应该被直接实例化，而只作为子类的通用接口。

通过正确配置 Jackson 的多态注解并确保 JSON 数据包含必要的类型标识符，可以有效地解决 Java 中父类属性反序列化为子类实例的问题，从而实现灵活且强大的数据处理能力。

理论要掌握，实操不能落！以上关于《Jackson多态反序列化实战技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！

Excel条件格式全攻略，数据可视化技巧分享Excel条件格式全攻略，数据可视化技巧分享
上一篇
Excel条件格式全攻略，数据可视化技巧分享
百度AI官网入口及平台最新链接
下一篇
百度AI官网入口及平台最新链接
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案，代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景，打造一站式知识长龙服务，适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例，全面具体可落地，从理论到实践，一步一步将GO核心编程技术、编程思想、底层实现融会贯通，使学习者贴近时代脉搏，做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信：Le-studyg；在课程中，我们将首先介绍MySQL8的新特性，包括性能优化、安全增强、新数据类型等，帮助学生快速熟悉MySQL8的最新功能。接着，我们将深入解析MySQL的网络通信机制，包括协议、连接管理、数据传输等，让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网，分为导航，轮播，关于我们，成功案例，服务流程，团队介绍，数据部分，公司动态，底部信息等内容区块。网站整体采用CSSGrid布局，支持响应式，有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • ChatExcel酷表：告别Excel难题，北大团队AI助手助您轻松处理数据
    ChatExcel酷表
    ChatExcel酷表是由北京大学团队打造的Excel聊天机器人，用自然语言操控表格，简化数据处理，告别繁琐操作，提升工作效率！适用于学生、上班族及政府人员。
    3207次使用
  • Any绘本：开源免费AI绘本创作工具深度解析
    Any绘本
    探索Any绘本（anypicturebook.com/zh），一款开源免费的AI绘本创作工具，基于Google Gemini与Flux AI模型，让您轻松创作个性化绘本。适用于家庭、教育、创作等多种场景，零门槛，高自由度，技术透明，本地可控。
    3421次使用
  • 可赞AI：AI驱动办公可视化智能工具，一键高效生成文档图表脑图
    可赞AI
    可赞AI，AI驱动的办公可视化智能工具，助您轻松实现文本与可视化元素高效转化。无论是智能文档生成、多格式文本解析，还是一键生成专业图表、脑图、知识卡片，可赞AI都能让信息处理更清晰高效。覆盖数据汇报、会议纪要、内容营销等全场景，大幅提升办公效率，降低专业门槛，是您提升工作效率的得力助手。
    3450次使用
  • 星月写作：AI网文创作神器，助力爆款小说速成
    星月写作
    星月写作是国内首款聚焦中文网络小说创作的AI辅助工具，解决网文作者从构思到变现的全流程痛点。AI扫榜、专属模板、全链路适配，助力新人快速上手，资深作者效率倍增。
    4558次使用
  • MagicLight.ai：叙事驱动AI动画视频创作平台 | 高效生成专业级故事动画
    MagicLight
    MagicLight.ai是全球首款叙事驱动型AI动画视频创作平台，专注于解决从故事想法到完整动画的全流程痛点。它通过自研AI模型，保障角色、风格、场景高度一致性，让零动画经验者也能高效产出专业级叙事内容。广泛适用于独立创作者、动画工作室、教育机构及企业营销，助您轻松实现创意落地与商业化。
    3828次使用
查看更多
相关文章
关于我们 免责声明 意见反馈 联系我们 内容提交
Golang学习网：公益在线Go学习平台，帮助Go学习者快速成长！
技术交流群
Copyright 2023 http://www.17golang.com/ All Rights Reserved ｜ 苏ICP备2023003363号-1
  • Golang学习网
    关注公众号
    Golang学习网
微信登录更方便
  • 密码登录
  • 注册账号
忘记密码
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码
发送验证码