不要再使用 @Builder 注解了！有深坑呀！

曾经，我在《千万不要再随便使用 lombok 的 @Builder 了！》一文中提到 @Builder 注解的其中一个大坑会导致默认值失效！

最近阅读了《Oh !! Stop using @Builder》发现 @Builder 的问题还不止一个，@Builder 会让人误以为是遵循构建器模式，实则不然，后面会介绍。

总的来说，不推荐再使用 @Builder 注解，接下来讲重点介绍其原因和替代方案。

二、场景复现

2.1 如果不使用 @Builder

类定义：

package io.gitrebase.demo;import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;@Data
@NoArgsConstructor
@AllArgsConstructor
public class APIResponse<T> {private T payload;private Status status;}

使用示例：

package io.gitrebase.demo;import lombok.extern.slf4j.Slf4j;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;@Slf4j
@RestControllerAdvice(assignableTypes = io.gitrebase.demo.RestApplication.class)
public class ApplicationExceptionHandler {@ResponseStatus(code = HttpStatus.INTERNAL_SERVER_ERROR)public APIResponse handleException(Exception exception) {log.error("Unhandled Exception", exception);Status status = new Status();status.setResponseCode("RESPONSE_CODE_IDENTIFIER");status.setDescription("Bla Bla Bla");APIResponse response = new APIResponse();response.setStatus(status);return response;}}

2.2 使用 @Builder

类定义：

package io.gitrebase.demo;import lombok.AllArgsConstructor;
import lombok.Builder;
import lombok.Data;
import lombok.NoArgsConstructor;@Builder
@Data
@NoArgsConstructor
@AllArgsConstructor
public class APIResponse<T> {private T payload;private Status status;}

使用示例：

package io.gitrebase.demo;import lombok.extern.slf4j.Slf4j;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;@Slf4j
@RestControllerAdvice(basePackageClasses = io.gitrebase.demo.RestApplication.class)
public class ApplicationExceptionHandler {@ResponseStatus(code = HttpStatus.INTERNAL_SERVER_ERROR)public APIResponse handleException(Exception exception) {log.error("Unhandled Exception", exception);return APIResponse.builder().status(Status.builder().responseCode("RESPONSE_CODE_IDENTIFIER").description("Bla Bla Bla").build()).build();}}

三、为什么不推荐使用 @Builder?

@Builder 会生成一个不完美的构建器，它不能区分哪些参数是必须的，哪些是可选的。这可能会导致构建对象时出现错误或不一致的情况。

很多人习惯于将 @Builder 和 @Data 一起使用使用会生成一个可变的构建器，它有 setter 方法可以修改构建器的状态。这违反了构建器模式的原则，即构建器应该是不可变的，一旦创建就不能修改。

@Builder 会生成一个具体类型的构建器，它不能适应不同类型的参数。这限制了构建器模式的优势，即可以根据不同的抽象类型创建不同风格的对象。

@Builder 的使用场景很有限，它只适合那些有很多参数且大部分是可选的对象。对于那些只想实现一个流式风格的对象创建，@Builder 并不是一个好的选择。

四、替代方案

4.1 首推：@Accessor

类的定义：

package io.gitrebase.demo;import lombok.Data;
import lombok.experimental.Accessors;@Data
@Accessors(chain = true)
public class APIResponse<T> {private T payload;private Status status;}

编译后的类：

package io.gitrebase.demo;import lombok.experimental.Accessors;@Accessors(chain = true)
public class APIResponse<T> {private T payload;private Status status;public T getPayload() {return this.payload;}public APIResponse<T> setPayload(T payload) {this.payload = payload;return this;}public Status getStatus() {return this.status;}public APIResponse<T> setStatus(Status status) {this.status = status;return this;}
}

使用示例：

package io.gitrebase.demo;import lombok.extern.slf4j.Slf4j;
import lombok.var;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;@Slf4j
@RestControllerAdvice(basePackageClasses = io.gitrebase.demo.RestApplication.class)
public class ApplicationExceptionHandler {@ResponseStatus(code = HttpStatus.INTERNAL_SERVER_ERROR)public APIResponse handleException(Exception exception) {log.error("Unhandled Exception", exception);var status = new Status().setResponseCode("RESPONSE_CODE_IDENTIFIER").setDescription("Bla Bla Bla");return new APIResponse().setStatus(status);}}

此外，该注解还支持一些高级方法：

/*** A container for settings for the generation of getters and setters.* <p>* Complete documentation is found at <a href="https://projectlombok.org/features/experimental/Accessors">the project lombok features page for &#64;Accessors</a>.* <p>* Using this annotation does nothing by itself; an annotation that makes lombok generate getters and setters,* such as {@link lombok.Setter} or {@link lombok.Data} is also required.*/
@Target({ElementType.TYPE, ElementType.FIELD})
@Retention(RetentionPolicy.SOURCE)
public @interface Accessors {/*** If true, accessors will be named after the field and not include a {@code get} or {@code set}* prefix. If true and {@code chain} is omitted, {@code chain} defaults to {@code true}.* <strong>default: false</strong>* * @return Whether or not to make fluent methods (named {@code fieldName()}, not for example {@code setFieldName}).*/boolean fluent() default false;/*** If true, setters return {@code this} instead of {@code void}.* <strong>default: false</strong>, unless {@code fluent=true}, then <strong>default: true</strong>* * @return Whether or not setters should return themselves (chaining) or {@code void} (no chaining).*/boolean chain() default false;/*** If present, only fields with any of the stated prefixes are given the getter/setter treatment.* Note that a prefix only counts if the next character is NOT a lowercase character or the last* letter of the prefix is not a letter (for instance an underscore). If multiple fields* all turn into the same name when the prefix is stripped, an error will be generated.* * @return If you are in the habit of prefixing your fields (for example, you name them {@code fFieldName}, specify such prefixes here).*/String[] prefix() default {};
}

另外如果一个类有些参数必传，有些参数选传，可以将必传参数定义到构造方法上，非必传参数采用 @Accessor 方式链式设置。

// 导入 lombok 注解
import lombok.Data;
import lombok.experimental.Accessors;// 定义 Person 类
@Getter // 自动生成 getter 方法
@Accessors(chain = true) // 开启链式调用
public class Person {// 定义必传的属性private String name; // 姓名private int id; // 编号// 定义选填的属性private int age; // 年龄private String address; // 地址// 定义构造函数，接收必传的参数public Person(String name, int id) {this.name = name;this.id = id;}
}// 使用示例
public class Main {public static void main(String[] args) {// 创建一个 Person 对象，传入必要的参数,通过链式调用，设置选填的属性Person person = new Person("张三", 1001).setAge(25).setAddress("北京市");// 打印 Person 对象的信息System.out.println(person);}
}