17370845950

如何在子类 Builder 中继承父类的默认值

当使用 lombok 的 `@builder` 时,子类无法自动继承父类中 `@default` 注解定义的默认值;本文提供一种不依赖实验性 `@superbuilder` 的稳健方案,通过“基类构造器 + 委托式构建”实现默认值复用。

在标准 Lombok @Builder 机制下,子类生成的 Builder 不会感知父类字段的 @Default 值,即使父类字段已声明默认值(如 isActive = true、type = "XYZ"),子类 Builder 构建出的对象中这些字段仍为 null。这是因为 @Builder 仅作用于当前类的直接字段,且不支持自动委托父类初始化逻辑。

由于题目明确排除了实验性注解 @SuperBuilder,我们采用一种清晰、可维护、无反射的替代方案:为父类添加拷贝构造器(copy constructor),并在子类 Builder 中以父类实例为参数进行委托构建

✅ 推荐实现方式

首先,修正父类命名与访问修饰符(注意:原问题中类名拼写为 BaseCusmtomer,应为 BaseCustomer;字段 cutomerId 应为 customerId):

@NoArgsConstructor
@AllArgsConstructor
@Getter
@Builder(builderMethodName = "baseBuilder")
public class BaseCustomer {
    protected String customerId;
    protected String age;
    @Default
    protected Boolean isActive = true;
    @Default
    protected String type = "XYZ";

    // 拷贝构造器:用于从已有 BaseCustomer 实例初始化新实例(保留默认值)
    public BaseCustomer(BaseCustomer base) {
        this.customerId = base.customerId;
        this.age = base.age;
        this.isActive = base.isActive;
        this.type = base.type;
    }
}

接着,定义子类 Customer,其私有构造器接收 BaseCustomer 实例和自身特有字段,并通过 super(base) 完成父类字段初始化:

import lombok.Builder;
import lombok.Data;
import lombok.EqualsAndHashCode;

@Data
@EqualsAndHashCode(callSuper = true)
public class Customer extends BaseCustomer {
    private String name;

    @Builder
    private Customer(BaseCustomer base, String name) {
        super(base); // 关键:触发拷贝构造器,确保 isActive/type 使用默认值或已设值
        this.name = name;
    }
}
? 注意:@Data 已隐含 @Getter/@Setter/@ToString 等,无需重复添加;@EqualsAndHashCode(callSuper = true) 保证父类字段参与 equals/hashCode 计算。

? 使用示例

构建时分两步:先用 BaseCustomer.baseBuilder() 设置父类字段(未设置的字段将自动采用 @Default 值),再传入子类 Builder:

Customer customer = Customer.builder()
    .base(BaseCustomer.baseBuilder()
        .customerId("1")
        .age("23")
        .build())
    .name("Alice")
    .build();

// 输出验证
System.out.println(customer.getCustomerId()); // "1"
System.out.println(customer.getAge());         // "23"
System.out.println(customer.getIsActive());    // true ← 来自 @Default
System.out.println(customer.getType());        // "XYZ" ← 来自 @Default
System.out.println(customer.getName());        // "Alice"

⚠️ 注意事项与优势

  • 零侵入父类变更:若未来 BaseCustomer 新增字段并赋予 @Default,只需更新拷贝构造器即可,子类 Customer 构造器无需修改;
  • 类型安全 & IDE 友好:所有字段初始化均在编译期检查,避免运行时 NullPointerException;
  • 语义清晰:.base(...) 明确表达了“继承父类配置”的意图,比手动重复设置更易读、易维护;
  • 不依赖实验特性:完全基于稳定版 Lombok(≥1.18.20),适用于生产环境。

❌ 不推荐的替代方案(简要说明)

  • 手动在子类构造器中硬编码默认值(如 this.isActive = true):违反 DRY 原则,父类默认值变更时极易遗漏同步;
  • 使用 @Builder(defaults = true)(不存在该属性)或 @Singular 等误配注解:Lombok 不支持此类行为;
  • 反射注入默认值:破坏封装性、降低可测试性、增加维护成本。

综上,通过拷贝构造器 + Builder 参数委托,是兼顾简洁性、健壮性与可扩展性的最佳实践。