本文详解如何使用 lombok `@builder` 构建含嵌套泛型集合（如 `list
在基于 REST API 的 Java 项目中，常需将复杂嵌套 JSON 请求体映射为 POJO，并通过 Lombok 的 @Builder 高效构造实例。但当模型包含多层集合字段（如 demoPackages: [{ "myparts": "...", "myPackages": ["..."] }]）时，开发者易陷入「该传 String 还是 List？该用 ArrayList 还是 List？为什么 .demoPackages(...) 报错？」等典型误区。根本原因在于：字段类型声明、Builder 方法签名与实际入参三者未严格对齐。
✅ 正确建模：优先使用接口类型 + 明确泛型
首先，修正 DTO 设计——避免硬编码具体实现类（如 ArrayList），改用 List
@Data
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class DemoRequest {
private String myId;
private String myFirstName;
private String myLastName;
private List<DemoPackage> demoPackages; // ✅ 使用 List<DemoPackage>，非 ArrayList<DemoPackage>
}
@Data
@AllArgsConstructor
@NoArgsConstructor
@Builder
public class DemoPackage {
private String myparts;
private List<String> myPackages; // ✅ 使用 List<String>，明确元素类型
}⚠️ 注意：Lombok @Builder 会为每个字段自动生成同名 setter 式方法（如 .demoPackages(List)）。若字段声明为 ArrayList，则 Builder 方法只接受 ArrayList 实例——这极大限制灵活性，且与 Jackson 反序列化默认行为（返回 ArrayList 实例但字段类型为 List）不兼容。
✅ 正确构建：分层组装，类型严格一致
createMyPayload 方法需按数据结构层级逐级构建：
- 先创建内层 DemoPackage 实例（传入 String myparts 和 List
myPackages）； - 再将其加入外层 List
； - 最后注入 DemoRequest.builder()。
示例实现如下：
import java.util.*;
public class PayloadBuilder {
public DemoRequest createMyPayload(
String myId,
String myFirstName,
String myLastName,
String myParts, // 对应 DemoPackage.myparts
List<String> myPackages // 对应 DemoPackage.myPackages
) {
// Step 1: 构建单个 DemoPackage
DemoPackage demoPackage = DemoPackage.builder()
.myparts(myParts)
.myPackages(myPackages) // ✅ 类型完全匹配：List<String> → List<String>
.build();
// Step 2: 构建 demoPackages 列表（支持多个 package，此处仅一个）
List<DemoPackage> demoPackages = new ArrayList<>();
demoPackages.add(demoPackage);
// Step 3: 构建顶层 DemoRequest
return DemoRequest.builder()
.myId(myId)
.myFirstName(myFirstName)
.myLastName(myLastName)
.demoPackages(demoPackages) // ✅ 类型完全匹配：List<DemoPackage> → List<DemoPackage>
.build();
}
// 调用示例
public static void main(String[] args) {
PayloadBuilder builder = new PayloadBuilder();
String myParts = "https://example.com/myparts/a1234567-5d25-9gf1-23ua-45pb3874265l";
List<String> myPackages = Arrays.asList(
"https:/example.com/myPackages/0sk98926-939a-444a-95ta-8eb40125f7r1"
);
DemoRequest payload = builder.createMyPayload(
"studentOne",
"joe",
"bloggs",
myParts,
myPackages
);
System.out.println(payload); // 验证构建结果
}
}? 关键要点总结
-
类型声明即契约：POJO 字段用 List
，Builder 方法签名自动适配；若误写 ArrayList ，调用方必须传 new ArrayList()，丧失通用性。 -
入参粒度要合理：createMyPayload 不应接收原始 ArrayList 参数，而应接收语义清晰的 String myParts 和 List
myPackages —— 这既降低调用方负担，又提升可读性。 - 避免链式误用：.demoPackages(...) 只能设一次整个列表，不可多次调用（如原代码中 .releasePackages(myparts).releasePackages(myPackages) 是无效的，字段名与类型均错误）。
- 测试驱动验证：建议搭配 Jackson ObjectMapper 序列化输出，确认生成 JSON 与预期完全一致：
ObjectMapper mapper = new ObjectMapper(); System.out.println(mapper.writeValueAsString(payload)); // 输出符合题干要求的嵌套 JSON 结构
遵循以上规范，即可稳健、清晰地通过 Lombok Builder 构造任意深度嵌套的集合型请求对象，彻底规避编译错误与运行时类型异常。
