本文将深入探讨 L%ignore_a_1%mbok 的 @Builder 注解的一个高级特性：如何在不直接修改现有对象的情况下，通过创建新的 Builder 实例来实现“复制并修改”对象的需求。这对于处理不可变（Immutable）对象尤其有效，它允许开发者基于现有对象的值生成一个预填充的 Builder，然后仅修改特定字段以构建一个新的对象实例，从而避免了传统 Setter 带来的可变性问题。
@Builder 的基本作用与进阶需求
lombok 的 @builder 注解极大地简化了复杂对象的创建过程，通过提供链式调用的 builder 模式，使得对象实例化更加清晰和安全。然而，当面临需要“修改”一个已创建对象的需求时，开发者可能会疑惑 @builder 是否也能派上用场。传统的做法是使用 setter 方法，但这通常意味着对象是可变的，这与函数式编程或构建不可变对象的设计理念相悖。直接使用 @builder 创建新对象，虽然可以达到修改部分字段的目的，但如果需要保留大部分现有字段的值，则需要手动复制这些值，这无疑增加了冗余。
解决方案：@Builder(toBuilder=true) 实现“复制并修改”
Lombok 针对这一需求提供了优雅的解决方案：在 @Builder 注解中设置 toBuilder=true 参数。当一个类被 @Builder(toBuilder=true) 注解时，Lombok 会为该类自动生成一个名为 toBuilder() 的方法。
这个 toBuilder() 方法的作用是：
它不是直接修改原对象。它会基于当前对象的所有字段值，创建一个新的 Builder 实例。这个新的 Builder 实例已经预填充了当前对象的所有属性值。
开发者可以在这个预填充的 Builder 上，像创建新对象一样，链式调用 Builder 的 Setter 方法来修改（或覆盖）特定的字段值，最终通过 build() 方法生成一个全新的对象实例。这个新对象拥有原对象的大部分属性，但特定被修改的属性则反映了新的值。
示例代码
让我们通过一个具体的例子来演示这一机制：
import lombok.Builder;import lombok.Value;/** * 示例类 A，使用 @Value 和 @Builder(toBuilder=true) * @Value 确保对象不可变，@Builder 提供构建器，toBuilder=true 提供复制构建器能力 */@Value // @Value 自动生成 final 字段、getter、equals/hashCode/toString，并默认使对象不可变@Builder(toBuilder = true) // 启用 Builder 模式，并允许通过 toBuilder() 方法创建新的 Builderpublic class A { String name; long value;}
现在，我们来看如何使用这个类来创建对象并进行“修改”：
public class BuilderModificationDemo { public static void main(String[] args) { // 1. 使用 Builder 创建初始对象 var a = A.builder() .name("test-name") .value(1234L) .build(); System.out.println("原始对象 a: " + a); // 2. 使用 toBuilder() 方法从对象 a 创建一个新的 Builder // 然后修改其中的 value 字段，构建一个新的对象 b var b = a.toBuilder() // 获取一个预填充了 a 所有值的 Builder .value(4321L) // 修改 Builder 中的 value 字段 .build(); // 构建新的对象 b System.out.println("修改后的新对象 b: " + b); // 验证原始对象 a 是否被修改（结果证明没有被修改） System.out.println("再次检查原始对象 a: " + a); }}
运行上述代码，将得到如下输出：
原始对象 a: A(name=test-name, value=1234)修改后的新对象 b: A(name=test-name, value=4321)再次检查原始对象 a: A(name=test-name, value=1234)
从输出可以看出，对象 a 的 name 字段值保持不变，而 value 字段的值在对象 b 中被成功“修改”了。最重要的是，原始对象 a 并没有被改变，这完美地支持了不可变对象的特性。
注意事项与最佳实践
创建新对象，而非修改旧对象： 务必理解 toBuilder() 方法及其后续操作是创建了一个全新的对象实例。原始对象保持不变。这是实现不可变性的核心。适用于不可变对象： 这种模式与不可变对象（Immutable Objects）的设计理念高度契合。当一个对象一旦创建就不能被修改时（例如使用 @Value 或手动将字段声明为 final），toBuilder() 提供了一种安全、函数式的“修改”方式。避免与 Setter 混淆： 如果你的类是可变的，并且已经提供了 Setter 方法，那么 toBuilder() 模式可能不是必需的。但即使是可变类，使用 toBuilder() 也能提供一种更清晰、更安全的批量更新字段的方式，尤其是在需要部分更新且希望保持链式调用的场景下。性能考量： 每次调用 toBuilder().build() 都会创建新的对象。对于极度性能敏感的场景，需要权衡对象创建的开销。然而，在大多数业务应用中，这种开销通常可以忽略不计。Lombok 文档： 深入了解 Lombok 的 @Builder 和 @Value 特性，可以查阅官方文档以获取更多详细信息和高级用法。
总结
Lombok 的 @Builder(toBuilder=true) 特性提供了一种强大的机制，用于在保持对象不可变性的前提下，实现“复制并修改”对象的需求。它通过生成 toBuilder() 方法，允许开发者基于现有对象的值快速构建一个新的 Builder，然后对特定字段进行修改，最终生成一个全新的、具有所需更新属性的对象。这种模式在构建健壮、可维护的应用程序时，尤其是在处理不可变数据结构和采用函数式编程范式时，显得尤为重要和实用。
以上就是Lombok @Builder 的高级用法：实现对象不可变修改与复制的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/120529.html
微信扫一扫 
支付宝扫一扫 
