当前位置：首页 > 文章列表 > 文章 > java教程 > Lombok@Builder是创建新对象，而非修改原对象。

Lombok@Builder是创建新对象，而非修改原对象。

2025-08-13 08:09:28 0浏览收藏

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《Lombok @Builder 是创建新对象还是修改原对象？》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

使用 Lombok 的 @Builder 修改对象：创建新对象还是原地修改？

Lombok 的 @Builder 注解极大地简化了 Java 中对象的创建过程，特别是对于拥有大量字段的类。它通过生成一个内部的 Builder 类，使得我们可以链式地设置对象的属性，最终构建出对象实例。然而，一个常见的问题是：@Builder 是否可以用于修改已经创建的对象？答案并非直接的修改，而是通过一种巧妙的方式——创建新对象。

@Builder 的核心功能：对象构建

@Builder 的主要职责是简化对象构建。它自动生成一个 Builder 类，该类包含所有字段的 Setter 方法，以及一个 build() 方法用于创建对象实例。例如：

import lombok.Builder;
import lombok.Value;

@Value
@Builder
public class Person {
    String firstName;
    String lastName;
    int age;
}

使用 @Builder 创建 Person 对象：

Person person = Person.builder()
                .firstName("John")
                .lastName("Doe")
                .age(30)
                .build();

利用 toBuilder=true 实现“修改”效果

虽然 @Builder 本身不提供修改对象的功能，但通过设置 toBuilder=true 参数，可以生成一个 toBuilder() 方法，该方法会基于现有对象创建一个新的 Builder 实例。然后，我们可以利用这个新的 Builder 实例修改部分属性，并构建出一个新的对象。

import lombok.Builder;
import lombok.Value;

@Value
@Builder(toBuilder = true)
public class Product {
    String name;
    double price;
}

示例代码：

Product product = Product.builder().name("Apple").price(1.0).build();
System.out.println(product); // 输出: Product(name=Apple, price=1.0)

Product updatedProduct = product.toBuilder().price(1.2).build();
System.out.println(updatedProduct); // 输出: Product(name=Apple, price=1.2)

在这个例子中，我们首先创建了一个 Product 对象。然后，通过调用 toBuilder() 方法，创建了一个基于原始 Product 对象的 Builder 实例。接着，我们修改了 price 属性，并调用 build() 方法创建了一个新的 Product 对象 updatedProduct。注意，原始的 product 对象并没有被修改，而是创建了一个新的对象。

为什么要使用 toBuilder=true 而不是 Setter？

不可变性： @Value 注解创建的是不可变对象，这意味着对象一旦创建，其属性就不能被修改。使用 toBuilder=true 可以创建一个新的对象，从而保持了原始对象的不可变性。
链式调用： toBuilder() 方法返回一个 Builder 实例，可以继续进行链式调用，使得代码更加简洁易读。
避免副作用： 直接使用 Setter 方法可能会引入副作用，例如触发某些业务逻辑或导致并发问题。使用 toBuilder=true 可以避免这些问题，因为它只是创建一个新的对象。

注意事项与总结