讲师中心 微信公众号
AI工具推荐 视频效率加速

将 JSON 数据高效映射为类型安全、可访问的 Java 对象

老墨小哥_4883

老墨小哥_4883

发布时间:2026-02-04 20:05:06

|

992人浏览过

|

来源于php中文网

原创

将 JSON 数据高效映射为类型安全、可访问的 Java 对象

本文介绍如何使用 jackson 库将嵌套 json 结构(含数组与对象)精准反序列化为结构清晰、支持 getter/setter 访问的 java 实体类,替代原始 map 方式,提升代码可维护性与类型安全性。

在实际开发中,直接将 JSON 解析为 Map(如 GSON 的 TypeToken 方式)虽能快速读取数据,但缺乏编译期类型检查、无法直接调用属性方法、难以进行字段级编辑或校验,且嵌套结构(如 systems 数组中的对象列表)访问繁琐易错。更专业、可持续的方案是基于 JSON 结构定义强类型的 Java Bean 类,并借助成熟的序列化库完成双向映射。

推荐使用 Jackson Databind(比 GSON 更广泛用于 Spring 生态,对泛型、嵌套集合支持更稳健)。首先,根据提供的 JSON 结构创建两个对应类:

// 主配置类,对应顶层 JSON 对象
public class AppInventory {
    private String title;
    private String description;
    private List<SystemInfo> systems;

    // 构造函数(可选)
    public AppInventory() {}

    // Getter 和 Setter 方法(务必完整实现,否则 Jackson 反序列化失败)
    public String getTitle() { return title; }
    public void setTitle(String title) { this.title = title; }

    public String getDescription() { return description; }
    public void setDescription(String description) { this.description = description; }

    public List<SystemInfo> getSystems() { return systems; }
    public void setSystems(List<SystemInfo> systems) { this.systems = systems; }
}

// 嵌套系统信息类,对应 "systems" 数组中的每个对象
public class SystemInfo {
    private String name;
    private String purpose;
    private String owner;
    private List<String> subOwner;  // 注意:JSON 中键名为 "sub_owner",Java 属性名可小写驼峰
    private String location;
    private String tag;

    // Getter 和 Setter(同上,必须提供)
    public String getName() { return name; }
    public void setName(String name) { this.name = name; }

    public String getPurpose() { return purpose; }
    public void setPurpose(String purpose) { this.purpose = purpose; }

    public String getOwner() { return owner; }
    public void setOwner(String owner) { this.owner = owner; }

    public List<String> getSubOwner() { return subOwner; }
    public void setSubOwner(List<String> subOwner) { this.subOwner = subOwner; }

    public String getLocation() { return location; }
    public void setLocation(String location) { this.location = location; }

    public String getTag() { return tag; }
    public void setTag(String tag) { this.tag = tag; }
}
✅ 关键注意事项:Jackson 默认按 Java Bean 约定(getter/setter) 匹配字段,不依赖 @JsonProperty 注解即可工作;若 JSON 键名与 Java 属性名不一致(如 "sub_owner" → subOwner),Jackson 默认启用 SNAKE_CASE 或 LOWER_CAMEL_CASE 自动映射(2.12+ 版本默认支持下划线转驼峰);所有字段的 setter 方法必须存在,否则反序列化时该字段将为 null;使用 List 而非原始数组,便于后续增删改查操作;若需兼容旧版 Jackson 或自定义命名策略,可在 ObjectMapper 中配置:ObjectMapper mapper = new ObjectMapper(); mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE);

接下来,执行反序列化并访问/修改数据:

Java 接口排错助手
Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。

下载
import com.fasterxml.jackson.databind.ObjectMapper;
import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.List;

public class JsonToJavaExample {
    public static void main(String[] args) throws IOException {
        ObjectMapper mapper = new ObjectMapper();

        // 读取 JSON 文件内容
        String jsonData = Files.readString(Paths.get("Java/system.json"));

        // 一行代码完成强类型反序列化
        AppInventory inventory = mapper.readValue(jsonData, AppInventory.class);

        // ✅ 安全、直观地访问任意层级数据
        System.out.println("App Title: " + inventory.getTitle());
        System.out.println("Total Systems: " + inventory.getSystems().size());

        // 修改第一个系统的 owner
        if (!inventory.getSystems().isEmpty()) {
            SystemInfo firstSystem = inventory.getSystems().get(0);
            firstSystem.setOwner("New IT Lead");
            System.out.println("Updated owner: " + firstSystem.getOwner());
        }

        // ✅ 序列化回 JSON(验证修改是否生效)
        String updatedJson = mapper.writerWithDefaultPrettyPrinter().writeValueAsString(inventory);
        System.out.println(updatedJson);
    }
}

通过此方式,你不仅能精准访问 inventory.getSystems().get(0).getSubOwner().get(1) 这类深层路径,还能利用 IDE 自动补全、编译检查、单元测试和 Lombok 简化模板代码,真正实现 JSON ↔ Java 对象的可维护、可扩展、可调试映射。避免“字符串键查找”的脆弱性,是构建健壮配置管理或 API 客户端的基础实践。

立即学习“Java免费学习笔记(深入)”;

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2851

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

517

2026.01.26

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2275

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

3662

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

1216

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

4239

2025.09.10

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7179

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

549

2023.09.22

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

20

2026.11.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn