本文介绍如何使用 spring resttemplate 和 jackson 将嵌套 json 响应（含下划线命名字段）映射为结构清晰的 java pojo，涵盖 dto 设计、`@jsonproperty` 注解使用及类型安全的反序列化实践。
在调用 REST API 时，若直接接收 String 类型响应（如 ResponseEntity
{
"data": {
"individuals": [
{
"cust_xref_id": "abf",
"cust_frd_alrt_in": "n",
"cust_satis_trd_ct": "4",
"gam_open_rv_trd_ct": "4",
"cust_extnl_delinq_90_day_ct": "1",
"cust_extnl_delinq_in": "y"
}
]
}
}推荐采用 强类型 + 分层 DTO 映射 方式，而非泛型 Map 或 JsonNode——既保障编译期安全，又提升可维护性与 IDE 支持。
✅ 正确的 POJO 结构设计（三层嵌套）
需严格对应 JSON 层级关系定义三个类：
- DataDTO：顶层容器，封装 "data" 字段；
- IndividualList：中间层，封装 "individuals" 数组；
- IndividualDTO：实体类，映射每个个体对象，并通过 @JsonProperty 显式绑定下划线命名的 JSON 字段。
public class DataDTO {
private IndividualList data;
@JsonProperty("data")
public IndividualList getData() {
return data;
}
public void setData(IndividualList data) {
this.data = data;
}
}
public class IndividualList {
private List<IndividualDTO> individuals;
@JsonProperty("individuals")
public List<IndividualDTO> getIndividuals() {
return individuals;
}
public void setIndividuals(List<IndividualDTO> individuals) {
this.individuals = individuals;
}
}
public class IndividualDTO {
@JsonProperty("cust_xref_id")
private String custXrefId;
@JsonProperty("cust_frd_alrt_in")
private String custFrdAlrtIn;
@JsonProperty("cust_satis_trd_ct")
private String custSatisTrdCt;
@JsonProperty("gam_open_rv_trd_ct")
private String gamOpenRvTrdCt;
@JsonProperty("cust_extnl_delinq_90_day_ct")
private String custExtnlDelinq90DayCt;
@JsonProperty("cust_extnl_delinq_in")
private String custExtnlDelinqIn;
// 省略 getter/setter（务必生成完整，否则 Jackson 无法设值）
}⚠️ 注意：所有字段必须配对提供 getter 和 setter；若使用 Lombok，可添加 @Data 或分别使用 @Getter/@Setter。
✅ 调用 RestTemplate 时直接反序列化（推荐方式）
无需先获取 String 再手动解析——应直接指定目标类型，由 Jackson 自动完成反序列化：
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
立即学习“Java免费学习笔记（深入）”；
// ✅ 推荐：一步到位，类型安全
ResponseEntity<DataDTO> response = restTemplate.postForEntity(
url,
entity,
DataDTO.class // 直接传入顶层 DTO 类型
);
if (response.getStatusCode().is2xxSuccessful()) {
DataDTO dataDTO = response.getBody();
List<IndividualDTO> individuals = dataDTO.getData().getIndividuals();
for (IndividualDTO individual : individuals) {
System.out.println("ID: " + individual.getCustXrefId());
// ... 其他业务逻辑
}
}该方式优势显著：
- 避免 String → Object 手动转换开销；
- 失败时自动抛出 HttpMessageNotReadableException，便于统一异常处理；
- 完整保留泛型类型信息（如 List
），无运行时擦除风险。
? 补充说明与最佳实践
- 依赖要求：确保项目已引入 spring-boot-starter-web（内置 Jackson Databind）；
- 空值/缺失字段容错：可在类级别添加 @JsonIgnoreProperties(ignoreUnknown = true) 防止未知字段导致反序列化失败；
- 数字类型优化：若 "cust_satis_trd_ct" 等字段语义为整数，建议声明为 Integer 并配合 @JsonAlias 兼容字符串/数字输入；
- 性能提示：避免重复创建 RestTemplate 实例，建议作为 @Bean 单例管理。
通过以上结构化设计与正确调用方式，即可稳健、可读、可扩展地完成 JSON 到 POJO 的映射任务。
