前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >每天一小步:如何给Lombok Builder提供默认值

每天一小步:如何给Lombok Builder提供默认值

作者头像
烟雨平生
发布2023-03-07 14:34:17
1.8K0
发布2023-03-07 14:34:17
举报
文章被收录于专栏:数字化之路数字化之路
原文链接:https://www.baeldung.com/lombok-builder-default-value

作者: baeldung

译者: helloworldtang

1.概览

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

请务必阅读这篇Lombok简介 。

2.Maven依赖

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

代码语言:javascript
复制
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.16.18</version>
    <scope>provided</scope>
</dependency>

3.基于Lombok Builder的POJO

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

代码语言:javascript
复制
public class Pojo {
    private String name;
    private boolean original;
}

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

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

代码语言:javascript
复制
@Getter
@Builder
@NoArgsConstructor
@AllArgsConstructor
public class Pojo {
    private String name;
    private boolean original;
}

4.期望的效果

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

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

代码语言:javascript
复制
@Test
public void givenBuilderWithDefaultValue_ThenDefaultValueIsPresent() {
    Pojo build = Pojo.builder()
        .build();
    Assert.assertEquals("foo", build.getName());
    Assert.assertTrue(build.isOriginal());
}

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

代码语言:javascript
复制
@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.LombokBuilder.Default注解

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

代码语言:javascript
复制
// 添加在类上的注解同上
public class Pojo {
    @Builder.Default
    private String name = "foo";
    @Builder.Default
    private boolean original = true;
}

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

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

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

6.初始化Builder

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

代码语言:javascript
复制
// 添加在类上的注解同上
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注解:

代码语言:javascript
复制
// 添加在类上的注解同上
@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参数来启用:

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

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

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

代码语言:javascript
复制
@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上找到

本文参与 腾讯云自媒体同步曝光计划,分享自微信公众号。
原始发表:2018-12-09,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 的数字化之路 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体同步曝光计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 1.概览
  • 2.Maven依赖
  • 3.基于Lombok Builder的POJO
  • 4.期望的效果
  • 5.Lombok的Builder.Default注解
  • 6.初始化Builder
  • 7.使用toBuilder参数
  • 8.总结
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档