【转】通过lombok带你读透Builder构建器

时间:2023-03-09 21:15:33
【转】通过lombok带你读透Builder构建器

原地址:https://www.jianshu.com/p/0d8fc3df3647?from=timeline&isappinstalled=0

很久之前,我在《effective java》上看过Builder构建器相关的内容,但实际开发中不经常用。后来,在项目中使用了lombok,发现它有一个注解“@Builder”,就是为java bean生成一个构建器。于是,回头重新复习了下相关知识,整理如下。

1. lombok使用样例

 // 创建名为Officer的java bean
@Builder
public class Officer {
private final String id;
private final String name;
private final int age;
private final String department;
} // 调用构建器生成Officer实例
class BuilderTest {
public static void main(String[] args) {
Officer officer = Officer.builder().id("00001").name("simon qi")
.age(26).department("departmentA").build();
}
}

2. 反编译lombok生成的Officer.class

注意:下面请区分两组名词:"builder方法"和“build方法”,“构造器”和“构建器”。

 public class Officer {
private final String id;
private final String name;
private final int age;
private final String department; Officer(String id, String name, int age, String department) {
this.id = id;
this.name = name;
this.age = age;
this.department = department;
} public static Officer.OfficerBuilder builder() {
return new Officer.OfficerBuilder();
} public static class OfficerBuilder {
private String id;
private String name;
private int age;
private String department; OfficerBuilder() {
} public Officer.OfficerBuilder id(String id) {
this.id = id;
return this;
} public Officer.OfficerBuilder name(String name) {
this.name = name;
return this;
} public Officer.OfficerBuilder age(int age) {
this.age = age;
return this;
} public Officer.OfficerBuilder department(String department) {
this.department = department;
return this;
} public Officer build() {
return new Officer(this.id, this.name, this.age, this.department);
} public String toString() {
return "Officer.OfficerBuilder(id=" + this.id + ", name=" + this.name + ", age=" + this.age + ", department=" + this.department + ")";
}
}
}

我们通过反编译Officer.class,获得上方的源码(最好用idea自带的反编译器,jd-gui反编译的源码不全)。

我们发现源码中有一个OfficerBuilder的静态内部类,我们在调用builder方法时,实际返回了这个静态内部类的实例。这个OfficerBuilder类,具有和Officer相同的成员变量,且拥有名为id,name,age和department的方法。这些以Officer的成员变量命名的方法,都是给OfficerBuilder的成员变量赋值,并返回this。

这些方法返回this,其实就是返回调用这些方法的OfficerBuilder对象,也可称为“返回对象本身”。通过返回对象本身,形成了方法的链式调用。

再看build方法,它是OfficerBuilder类的方法。它创建了一个新的Officer对象,并将自身的成员变量值,传给了Officer的成员变量。所以Officer officer = Officer.builder().id("00001").name("simon qi").age(26).department("departmentA").build();的写法,等价于下面的写法:

 Officer.OfficerBuilder officerBuilder = new Officer.OfficerBuilder();
officerBuilder.id("00001").name("simon qi").age(26).department("departmentA");
Officer officer = officerBuilder.build();

所以为什么这种模式叫“构建器”,因为要创建Officer类的实例,首先要创建OfficerBuilder类的实例。而这个OfficerBuilder也就是构建器,是创建Officer对象的一个过渡者。所以利用这种模式,会有中间实例的创建,会加大虚拟机内存的消耗。

3. 只用@Builder注解的bug

我们只用@Builder注解,我发现lombok为Officer类生成的构造器是“default”的(不添加权限修饰符,默认为“default”的)。

我们之所以用构建器模式,是希望用户用构建器提供的方法去创建实例。但“default”的构造器,可以被同package的类调用(default限制不同package类的调用)。所以,我们需要将此构造器设为private的。这时就需要用到“@AllArgsConstructor(access = AccessLevel.PRIVATE)”。我们这时再看反编译后的构造器:

 private Officer(String id, String name, int age, String department) {
this.id = id;
this.name = name;
this.age = age;
this.department = department;
}

所以,使用lombok的构建器,应将“@Builder”和“@AllArgsConstructor(access = AccessLevel.PRIVATE)”相结合,最终写法:

 @Builder
@AllArgsConstructor(access = AccessLevel.PRIVATE)
public class Officer {
private final String id;
private final String name;
private final int age;
private final String department;
}

4. 为什么使用构建器模式

若一个类具有大量的成员变量,我们就需要提供一个全参的构造器或大量的set方法。这让实例的创建和赋值,变得很麻烦,且不直观。我们通过构建器,可以让变量的赋值变成链式调用,而且调用的方法名对应着成员变量的名称。让对象的创建和赋值都变得很简洁、直观。

5. 链式方法赋值,一定要用构建器模式吗?

不一定要用到构建器模式,之所以使用构建器模式,是因为我们要创造的对象是一个成员变量不可变的对象

你返回去看Officer类和OfficerBuilder类,你会发现Officer类的成员变量都是final的,而OfficerBuilder的成员变量却没用final修饰。因为final修饰的成员变量,需要在实例创建时就把值确定下来。但在类具有大量成员变量的时候,我们是不希望用户直接调用全参构造器的。

所以我们使用了OfficerBuilder的中间类。这个类为了实现链式赋值,才将变量设为非final的。无论你OfficerBuilder实例怎么赋值,怎么改变,当你调用build方法时,就会返回一个成员变量不可变的Officer实例。

那如果有大量属性,但不需要它是成员变量不可变的对象,我们还需要构建器模式吗?答案是,不需要,我们可以参考构建器,把代码赋值改成链式的即可:

 public class Officer {
private String id;
private String name;
private int age;
private String department; public static Officer build() {
return new Officer();
} private Officer() {
} public Officer id(String id) {
this.id = id;
return this;
} public Officer name(String name) {
this.name = name;
return this;
} public Officer age(int age) {
this.age = age;
return this;
} public Officer department(String department) {
this.department = department;
return this;
}
} 调用样式:
Officer officer = Officer.build().id("00001").name("simon qi").age(26).department("departmentA");
其实这时候构造器设为非private也行,写成private,只是为了调用build()显得更好看。
将构造器设为非private,可以写为如下形式:
Officer officer = new Officer().id("00001").name("simon qi").age(26).department("departmentA");

所以,我觉得你在使用lombok的"@Builder"注解的时候,还是要思考一下。当你不需要成员变量不可变的时候,你完全没必要使用构建器模式,因为这会消耗java虚拟机的内存。

6. 总结

所以,我一直推荐学习知识,要在项目中去学习。通过项目,去探索项目以外的知识点,才是提升自己的快捷方法。而且知识不能学死了,不能网上有哪些知识点,我们就只考虑这些知识点。我们要去思考一些别人不常想到的问题。比如,我们为什么要用中间类去做过渡,这么写的目的是什么。

将上述知识吃透,面试应对构建器的时候,也就得心应手了。而且通过实战去回答问题,也更能彰显你是个爱思考的员工。