You need to enable JavaScript to run this app. SpringBoot中如何将嵌套JSON映射为Car类对象模型、校验设计合理性并编写测试
优惠活动
大模型
产品
解决方案
定价
更多

SpringBoot中如何将嵌套JSON映射为Car类对象模型、校验设计合理性并编写测试

现有类设计的核心问题
  • 字段名与JSON结构完全错位
    JSON顶层的键是car,但你在CarResponse里定义的列表字段名是quotes,即便配置了忽略未知属性,Jackson默认只会匹配和字段名一致的JSON键,car数组的内容根本无法填充到quotes字段中,最终反序列化得到的会是空列表。再加上DataLoader里残留了其他项目的代码(返回值写的是QuoteResponse),整个流程根本无法跑通。
  • Car类缺失嵌套结构的关联字段
    原JSON里每个Car对象下有个values数组,对应多个CarValue车款信息,但你当前的Car类只定义了shop、date两个字段,完全没有声明List<CarValue> values的成员,就算前面的映射通了,所有车款数据也会被直接丢弃。
  • 字段类型与值语义不匹配
    1. 原JSON里的date是数字格式的毫秒时间戳,你在Car类里定义成了String类型,即便能通过Jackson的强制转换拿到字符串,也完全丢失了时间值的数值语义,后续计算、格式化都很不方便。时间戳要么用Long直接存储,要么引入Jackson的Java8时间模块直接映射成Instant类型更合理。
    2. 原JSON里的age字段存的是"2020""1990"这类字符串格式的生产年份,你在CarValue里定义成了Long类型,遇到非数字的脏值时会直接抛出反序列化异常;而且字段名age(车龄)和实际存的年款值语义完全不符,改成modelYear这类对应语义的名字能大幅降低后续维护的歧义。
  • 封装不规范
    你在CarResponse里定义的quotes字段是包级私有权限,不符合JavaBean的规范,部分Jackson版本的默认访问策略会因为权限问题无法读取字段值,导致反序列化失败。
  • 容错配置的副作用
    你配置的FAIL_ON_UNKNOWN_PROPERTIES=false虽然能兼容JSON里新增的额外字段,但也会掩盖字段名不匹配的问题——比如字段名和JSON键对不上的时候,程序不会抛出明确的报错,只会默默返回空值,排查问题时成本极高。
  • 资源初始化的不合理设计
    你在load方法里每次调用都新建ObjectMapper实例,实际上ObjectMapper是线程安全的,初始化和配置的开销很高,完全可以把它做成Spring容器管理的单例Bean注入到DataLoader里,不用每次拉取数据时都重复初始化,浪费系统资源。
修正后的类设计参考

按照原JSON的实际结构,调整后的模型类定义如下:

// 顶层响应类,对应JSON最外层结构
public class CarResponse {
    // 字段名和JSON顶层的"car"键完全匹配
    private List<Car> car;
    // 补充getter、setter方法
}

// 车店维度的记录类,对应car数组中的单个对象
public class Car {
    private String shop;
    // 用Long类型存储毫秒时间戳,需要时间格式化时再做转换
    private Long date;
    // 增加和JSON中values数组对应的关联字段
    private List<CarValue> values;
    // 补充getter、setter方法
}

// 单款车辆的信息类,对应values数组中的单个对象
public class CarValue {
    private String name;
    // 用String类型存储年款值,和JSON的实际类型保持一致
    private String age;
    private String country;
    // 补充getter、setter方法
}

同时需要修正DataLoader里的残留问题:把拼写错误的urlStrl改成urlStr,把返回值类型从QuoteResponse改成CarResponse,保证代码能正常编译。

JSON映射逻辑的测试编写方案

测试不需要真的请求远程地址,把测试拆成两层分别验证:

1. 纯反序列化逻辑测试

直接用静态的测试JSON做输入,校验映射的正确性,测试步骤:

  • 把你提供的示例JSON作为测试输入,要么存在测试资源目录下,要么直接写在测试方法里
  • 初始化和生产环境配置完全一致的ObjectMapper实例
  • 调用readValue方法把JSON转成CarResponse对象,逐层做断言校验:
    • 校验顶层car列表的长度是否符合预期
    • 校验Car对象的shop、date字段值是否和JSON内容一致
    • 校验values列表的长度,逐个对比每个CarValue的name、age、country字段值

参考测试代码:

@Test
void testJsonDeserialization() throws JsonProcessingException {
    // 测试用JSON,直接嵌入或者从资源文件读取
    String testJson = """
        {"car": [{"shop": "Audi Germany", "date": 1573599600000, "values": [{"name": "Audi Xl", "age": "2020", "country": "Germany"}]}]}
        """;
    ObjectMapper mapper = new ObjectMapper();
    mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);

    CarResponse response = mapper.readValue(testJson, CarResponse.class);

    // 逐层断言校验
    assertEquals(1, response.getCar().size());
    assertEquals("Audi Germany", response.getCar().get(0).getShop());
    assertEquals(1573599600000L, response.getCar().get(0).getDate());
    assertEquals(1, response.getCar().get(0).getValues().size());
}

2. DataLoader服务的集成测试

因为DataLoader是从远程URL拉取JSON,测试时不要真的请求外部服务,可以用本地模拟服务的方式:

  • 用MockWebServer这类工具启动一个临时的本地HTTP服务,返回和测试用例完全一致的JSON内容
  • 把DataLoader里注入的urlStr配置成这个本地模拟服务的地址
  • 调用load()方法,校验返回的CarResponse对象字段和预期值完全一致,覆盖异常场景(比如连接超时、JSON格式错误时的异常抛出逻辑)

内容的提问来源于stack exchange,提问作者user9347049

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 17:27:00