本文深入探讨lombok `@superbuilder`在处理多层继承时的正确用法，以及如何确保子类能够继承并构建父类的属性。重点阐述了在调试过程中，当发现父类属性似乎未被正确设置时，如何通过为子类添加`@tostring(callsuper=true)`注解来完整显示对象状态，避免误解，从而有效验证属性的正确赋值。
引言：Lombok @SuperBuilder与继承
在Java开发中，构建器模式（Builder Pattern）是一种常用的创建复杂对象的方法，它能提高代码的可读性和可维护性。Lombok库通过@Builder注解极大地简化了构建器的生成。然而，当涉及到继承体系时，标准的@Builder无法直接支持父类属性的构建。为此，Lombok提供了@SuperBuilder注解，专门用于解决在类继承链中构建器模式的实现问题，使得子类构建器能够同时构建父类和子类的属性。
在实际应用中，开发者可能会遇到一种情况，即在使用@SuperBuilder构建子类对象并赋值了父类属性后，通过打印对象发现父类属性并未显示，从而误认为属性没有被正确设置。本文将通过一个具体的示例，深入分析这一现象，并提供正确的解决方案。
考虑以下Java类结构：
// 父类
@Data
@SuperBuilder
public class CParent {
protected Integer parentId;
}
// 子类，继承自CParent
@Data
@SuperBuilder
@EqualsAndHashCode(callSuper = true) // 确保equals和hashCode方法包含父类属性
public class CChild extends CParent {
protected String childId;
}
// 包含CParent类型属性的类
@Data
@SuperBuilder
public class CHouse {
String address;
String description;
CParent parent; // 这里使用CParent类型
}我们期望通过@SuperBuilder构建CChild和CHouse对象，并验证其属性是否正确赋值：
public class Main {
public static void main(String [] args) {
// 构建CChild对象，同时设置父类属性parentId和子类属性childId
CParent child = CChild
.builder()
.parentId(123)
.childId("789")
.build();
// 构建CHouse对象，其中parent属性是一个CChild实例
CHouse house = CHouse
.builder()
.address("address")
.description("description")
.parent(child)
.build();
System.out.println("构建的CChild对象: " + child);
System.out.println("构建的CHouse对象: " + house);
}
}在上述代码中，开发者可能会发现，当打印child对象时，其输出可能只包含childId而缺少parentId，这导致了对@SuperBuilder是否正确处理父类属性的疑问。
理解@SuperBuilder的继承机制
首先，需要明确的是，Lombok的@SuperBuilder设计初衷就是为了在继承体系中提供完整的构建器功能。当一个子类（如CChild）使用@SuperBuilder并继承自另一个也使用了@SuperBuilder的父类（如CParent）时，Lombok会自动生成一个构建器，该构建器能够接收并设置父类的所有属性以及子类自身的属性。因此，在上述示例中，CChild.builder().parentId(123).childId("789").build()这行代码是完全能够正确地将parentId和childId赋值给新创建的CChild对象的。
@EqualsAndHashCode(callSuper = true)注解的作用是确保在生成equals()和hashCode()方法时，会将父类的属性也纳入计算，这对于对象比较的正确性至关重要，但它与构建器如何设置属性本身没有直接关系。
调试陷阱：toString()的默认行为
问题的根源并非@SuperBuilder未能正确构建父类属性，而是Lombok为类自动生成的toString()方法的默认行为。默认情况下，Lombok生成的toString()方法只会包含当前类（子类）自身声明的属性，而不会递归地包含其父类中的属性。
例如，对于CChild类，在没有额外配置的情况下，Lombok生成的toString()可能类似于：
// 假设Lombok生成的CChild的toString()方法
public String toString() {
return "CChild(childId=" + this.childId + ")";
}这导致了在打印CChild对象时，parentId属性没有被显示出来，从而给开发者造成了“parentId未被设置”的假象。实际上，parentId已经被正确地设置到了CChild实例的父类部分。
解决方案：利用@ToString(callSuper=true)
要解决这个问题，并让toString()方法能够完整地显示父类属性，我们需要在子类上使用@ToString(callSuper=true)注解。这个注解会指示Lombok在生成toString()方法时，首先调用父类的toString()方法，然后将父类的输出与子类自身的属性输出结合起来。
修改后的CChild类代码如下：
// 子类，继承自CParent
@Data
@SuperBuilder
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true) // 关键：确保toString()包含父类属性
public class CChild extends CParent {
protected String childId;
}添加@ToString(callSuper = true)后，当打印CChild对象时，其输出将包含父类CParent的属性，从而完整地展示对象的内部状态。
完整代码示例与验证
现在，让我们结合修改后的CChild类，运行完整的示例代码：
// CParent.java
import lombok.Data;
import lombok.experimental.SuperBuilder;
@Data
@SuperBuilder
public class CParent {
protected Integer parentId;
}
// CChild.java
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.ToString;
import lombok.experimental.SuperBuilder;
@Data
@SuperBuilder
@EqualsAndHashCode(callSuper = true)
@ToString(callSuper = true) // 添加此行
public class CChild extends CParent {
protected String childId;
}
// CHouse.java
import lombok.Data;
import lombok.experimental.SuperBuilder;
@Data
@SuperBuilder
public class CHouse {
String address;
String description;
CParent parent;
}
// Main.java
public class Main {
public static void main(String [] args) {
CParent child = CChild
.builder()
.parentId(123)
.childId("789")
.build();
CHouse house = CHouse
.builder()
.address("address")
.description("description")
.parent(child)
.build();
System.out.println("构建的CChild对象: " + child);
System.out.println("构建的CHouse对象: " + house);
}
}运行上述Main类，你将观察到如下输出（具体格式可能因Lombok版本略有不同，但会包含父类信息）：
构建的CChild对象: CChild(super=CParent(parentId=123), childId=789) 构建的CHouse对象: CHouse(address=address, description=description, parent=CChild(super=CParent(parentId=123), childId=789))
从输出中可以清晰地看到，CChild对象现在完整地显示了parentId和childId，这证明了@SuperBuilder确实正确地构建了父类属性，而@ToString(callSuper=true)解决了调试时的显示问题。
最佳实践与注意事项
- @SuperBuilder的正确使用：在设计具有继承关系的类时，如果需要使用构建器模式，请确保父类和所有子类都使用@SuperBuilder。
- @ToString(callSuper=true)的重要性：对于继承体系中的子类，强烈建议在@Data或@ToString注解旁边添加callSuper=true，以便在调试、日志记录或任何需要完整对象表示的场景中，能够查看到父类的属性。这能有效避免因toString()输出不完整而导致的误解。
- @EqualsAndHashCode(callSuper=true)的必要性：同样，在继承体系中，如果需要正确比较对象（即equals()方法）或在哈希集合中使用对象（即hashCode()方法），务必在子类上使用@EqualsAndHashCode(callSuper=true)，以确保父类属性也被纳入比较和哈希计算。
- 理解Lombok注解的细节：Lombok注解虽然强大，但每个注解都有其特定的行为和影响。深入理解这些细节对于避免潜在问题和编写健壮的代码至关重要。
总结
Lombok的@SuperBuilder是一个非常实用的特性，它完美地解决了在继承体系中实现构建器模式的复杂性。本文通过一个常见的问题场景，揭示了@SuperBuilder在处理父类属性时的正确行为，并强调了@ToString(callSuper=true)在调试和对象表示中的关键作用。掌握这些Lombok注解的细节，将帮助开发者更高效、更准确地构建和调试复杂的Java对象模型。
