Java中的@Builder注解问题详解

 更新时间:2023年10月02日 10:10:58   作者:Archie_java  
这篇文章主要介绍了Java中的@Builder注解详解,@Builder 注解的其中一个大坑会导致默认值失效,这是使用此注解出现的一个问题,总的来说,不推荐再使用 @Builder 注解,接下来讲重点介绍其原因和替代方案,需要的朋友可以参考下

一、前言

 @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" rel="external nofollow" >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);
    }
}

4.2 手动模拟 @Accessor

由于 @Accessor 在 lombok.experimental包下,有极个非常谨慎的人会担心未来不稳定,未来可能被移除。 其实,在我看来这个担心有些多余,目前这个注解比 @Builder 更适合使用,而且一个成熟的工具类库不会轻易移除一个功能,而且及时移除了这个功能编译期就可以感知到,替换起来也很容易。 如果真的担心不稳定或者不想依赖 lombok,那么自己在默认生成的 Setter 方法上改造一下即可。

五、启发

大多数同学使用 lombok 注解都不会主动看源码,了解有哪些高级配置。建议工作之余稍微花点时间去看一下源码。 大家在使用 lombok 注解时,一定要在脑海中能够准确“编译” 出背后的代码。如果你没有这个能力,早晚会遇到坑。如果你没有这个能力,那么多去看编译后的类,熟能生巧。

并不是大家都在用的都是对的,使用某些功能时需要主动思考是否正确,哪怕是正确的是否是最佳的。@Builder 注解的确和构建器设计模式有些背离,很多时候我们需要的是@Accessor 的行为。

到此这篇关于Java中的@Builder注解问题详解的文章就介绍到这了,更多相关Java的@Builder内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • MyBatis动态创建表的实例代码

    MyBatis动态创建表的实例代码

    在项目需求中,我们经常会遇到动态操作数据表的需求,常见的我们会把日志、设备实时位置信息等存入数据表,并且以一定时间段生成一个表来存储。接下来通过本文给大家介绍MyBatis动态创建表的方法,感兴趣的朋友一起看看吧
    2018-07-07
  • 注解@TableName,@TableField,pgsql的模式对应方式

    注解@TableName,@TableField,pgsql的模式对应方式

    这篇文章主要介绍了注解@TableName,@TableField,pgsql的模式对应方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-04-04
  • 解决Maven项目pom.xml文件Ignored的问题

    解决Maven项目pom.xml文件Ignored的问题

    在Maven项目中,若不慎删除了.iml文件,可能会导致pom.xml文件显示为Ignored状态,影响项目构建,解决方法是通过IDEA的设置取消Ignored Files中对应文件的忽略,再刷新Maven项目即可恢复,此操作可有效解决pom.xml文件被误忽略的问题,保证项目正常构建和运行
    2024-09-09
  • SpringBoot Maven项目依赖冲突问题排查与解决全攻略

    SpringBoot Maven项目依赖冲突问题排查与解决全攻略

    本文将深入剖析SpringBoot项目中关于Maven依赖冲突问题的排查与解决,文内会提供三种实用排查方案与实战代码,希望可以帮助大家彻底搞定依赖冲突
    2026-03-03
  • java Socket简易聊天工具

    java Socket简易聊天工具

    这篇文章主要为大家详细介绍了java Socket简易聊天工具,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-10-10
  • Mybatis-plus查询语句加括号(.or(),.and())问题

    Mybatis-plus查询语句加括号(.or(),.and())问题

    这篇文章主要介绍了Mybatis-plus查询语句加括号(.or(),.and())问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-04-04
  • 关于Logback+MyBatis日志输出问题的一些思考

    关于Logback+MyBatis日志输出问题的一些思考

    这篇文章主要介绍了关于Logback+MyBatis日志输出问题的一些思考,具有很好的参考价值,希望对大家有所帮助,
    2023-09-09
  • SpringBoot整合Kafka实现高可用消息队列集群详解

    SpringBoot整合Kafka实现高可用消息队列集群详解

    Apache Kafka是一个分布式流处理平台,这篇文章主要介绍了SpringBoot如何整合Kafka实现高可用消息队列集群,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下
    2026-01-01
  • 手把手教你搭建第一个Spring Batch项目的步骤

    手把手教你搭建第一个Spring Batch项目的步骤

    这篇文章主要介绍了手把手教你搭建第一个Spring Batch项目的步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-09-09
  • Java AOP实现自定义滑动窗口限流器方法详解

    Java AOP实现自定义滑动窗口限流器方法详解

    这篇文章主要介绍了Java AOP实现自定义滑动窗口限流器方法,其中滑动窗口算法弥补了计数器算法的不足,滑动窗口算法把间隔时间划分成更小的粒度,当更小粒度的时间间隔过去后,把过去的间隔请求数减掉,再补充一个空的时间间隔,需要的朋友可以参考下
    2022-07-07

最新评论