如何给Lombok Builder提供默认值

最新推荐文章于 2025-06-24 19:04:06 发布

转载最新推荐文章于 2025-06-24 19:04:06 发布 · 4.3k 阅读

640?wx_fmt=gif 640?wx_fmt=jpeg

来源：生活点亮技术

1.概览

在这个教程中，我们将研究如何基于Lombok在实现 Builder模式时为属性提供默认值。

请务必阅读这篇Lombok简介。

2.Maven依赖

在本教程中，我们将使用Lombok ，因此，需要添加一个Maven依赖：

<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.16.18</version>
<scope>provided</scope>
</dependency>

3.基于`Lombok` `Builder`的POJO

首先，让我们看看 Lombok如何帮助我们从实现 Builder模式所需的样板代码中解脱出来。我们将从一个简单的 POJO开始：

public class Pojo {
private String name;
private boolean original;
}

为了使这个类可用，我们需要给每个字段实现一个getter。另外，如果希望将这个类用于ORM，我们可能需要一个默认构造函数。

除了这些，我们还需要一个用于构建这个POJO的Builder类。有了Lombok，我们就可以通过一些简单的注解来实现上面这样功能了:

@Getter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Pojo {
private String name;
private boolean original;
}

4.期望的效果

让我们以单元测试的形式来定义想要达到的效果。

最重要，也是最基本的要求是使用builder方法构建对象之后要有默认值：

@Test
public void givenBuilderWithDefaultValue_ThenDefaultValueIsPresent() {
Pojo build = Pojo.builder()
.build();
Assert.assertEquals("foo", build.getName());
Assert.assertTrue(build.isOriginal());
}

当然，这个测试用例肯定会失败，因为@Builder注解并不会给属性赋默认值。稍后，我们会让测试通过。如果使用了依赖默认构造函数的ORM框架，那么我们应该先从默认构造函数开始：

@Test
public void givenBuilderWithDefaultValue_NoArgsWorksAlso() {
Pojo build = Pojo.builder()
.build();
Pojo pojo = new Pojo();
Assert.assertEquals(build.getName(), pojo.getName());
Assert.assertTrue(build.isOriginal() == pojo.isOriginal());
}

在这个阶段，这个测试用例通过了，因为都没有默认值。现在，让我们看看如何让这两个测试用例都通过！

5.`Lombok`的`Builder.Default`注解

自从Lombokv1.16.16之后，我们就可以使用@Builder.Default注解：

// 添加在类上的注解同上
public class Pojo {
@Builder.Default
private String name = "foo";
@Builder.Default
private boolean original = true;
}

这个注解简单易读，但也有一些缺陷。

有了这个注解，默认值将将与构造函数一起出现，那么第一个测试用例将通过。不幸的是，由于@NoArgsConstructor不会得到默认值，因此第二个测试用例失败了。即使无参构造函数不是 Lombok自动生成而是显式编写的，也取不到默认值。

Builder.Default注解的这种副作用从一开始就有，可能还会持续很长时间。

6.初始化`Builder`

为了让这两个测试用例通过，我们可以尝试通过在一个极简的Builder中定义默认值：

// 添加在类上的注解同上
public class Pojo {
private String name = "foo";
private boolean original = true;
public static class PojoBuilder {
private String name = "foo";
private boolean original = true;
}
}

通过这种方式，这两个测试用例都通过了。很不幸，代价是代码重复。对于具有数十个属性的POJO，维护双重初始化可能会出错。

但是，如果愿意付出这个代价，我们还应该注意一件事。如果我们使用IDE中的重构功能来重命名类，静态内部类将不会自动重命名。这样，Lombok就找不到它了，我们的代码就出错了。

为了消除这种风险，我们可以再配置一下Builder注解：

// 添加在类上的注解同上
@Builder(builderClassName = "PojoBuilder")
public class Pojo {
private String name = "foo";
private boolean original = true;
public static class PojoBuilder {
private String name = "foo";
private boolean original = true;
}
}

7.使用`toBuilder`参数

@Builder还支持在原始类的实例中生成一个Builder实例。默认情况下这个特性是关闭的。我们可以通过在Builder注解中配置toBuilder参数来启用：

// class annotations as before
// 添加在类上的注解同上
@Builder(toBuilder = true)
public class Pojo {
private String name = "foo";
private boolean original = true;
}

这样，我们就可以避免*双重初始化 *。

当然，这也是有代价的。我们必须通过 实例化这个类来创建一个Builder实例。因此，相关的测试用例也必须修改：

@Test
public void givenBuilderWithDefaultValue_ThenDefaultValueIsPresent() {
Pojo build = new Pojo().toBuilder()
.build();
Assert.assertEquals("foo", build.getName());
Assert.assertTrue(build.isOriginal());
}
@Test
public void givenBuilderWithDefaultValue_thenNoArgsWorksAlso() {
Pojo build = new Pojo().toBuilder()
.build();
Pojo pojo = new Pojo();
Assert.assertEquals(build.getName(), pojo.getName());
Assert.assertTrue(build.isOriginal() == pojo.isOriginal());
}

同样，这两个测试用例会全部通过。因此使用无参构造函数与使用Builder具有相同的默认值。

8.总结

至此，我们已经展示了为Lombok Builder提供默认值的几种方法。

Builder.Default注解的副作用也很明显。但是，其他几个方案也有缺点。所以我们必须结合自身情况谨慎选择。

照例，文中用到的代码都可以在 GitHub上找到。

原文链接：https://www.baeldung.com/lombok-builder-default-value

作者： baeldung

译者： helloworldtang

·END·

近期热文：

640?wx_fmt=png

看完，赶紧点个“好看”鸭

点鸭点鸭

↓↓↓↓

如何给Lombok Builder提供默认值