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的成员,就算前面的映射通了,所有车款数据也会被直接丢弃。 - 字段类型与值语义不匹配
- 原JSON里的
date是数字格式的毫秒时间戳,你在Car类里定义成了String类型,即便能通过Jackson的强制转换拿到字符串,也完全丢失了时间值的数值语义,后续计算、格式化都很不方便。时间戳要么用Long直接存储,要么引入Jackson的Java8时间模块直接映射成Instant类型更合理。 - 原JSON里的
age字段存的是"2020""1990"这类字符串格式的生产年份,你在CarValue里定义成了Long类型,遇到非数字的脏值时会直接抛出反序列化异常;而且字段名age(车龄)和实际存的年款值语义完全不符,改成modelYear这类对应语义的名字能大幅降低后续维护的歧义。
- 原JSON里的
- 封装不规范
你在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
相关产品推荐
相关产品推荐

