当前位置: 代码网 > it编程>编程语言>Java > Java中使用 @Builder 注解的简单示例

Java中使用 @Builder 注解的简单示例

2025年07月22日 Java 我要评论
大多数同学使用 @builder 无非就是为了链式编程,然而 @builder 并不是链式编程的最佳实践,它会额外创建内部类,存在继承关系时还需要使用 @superbuilder 注解,设置默认值时也

大多数同学使用 @builder 无非就是为了链式编程,然而 @builder 并不是链式编程的最佳实践,它会额外创建内部类,存在继承关系时还需要使用 @superbuilder 注解,设置默认值时也需要额外的 @builder.default 去设置默认值,无疑增加了很多不必要的复杂度。

一、案例

@builder 注解是 lombok 库中的一个注解,用于简化 java 对象的构建过程。它通过生成一个构建器模式(builder pattern)来创建对象,使得代码更简洁和易于维护。以下是一个使用 @builder 注解的简单示例:

假设我们有一个 user 类:

import lombok.builder;
import lombok.tostring;
@builder
@tostring
public class user {
    private string name;
    private int age;
    private string email;
}

在例子中,@builder 注解会为 user 类生成一个静态内部类 userbuilder,用于构建 user 对象。@tostring 注解则是为了方便输出对象信息。

使用 @builder 注解生成的构建器来创建 user 对象:

public class main {
    public static void main(string[] args) {
        user user = user.builder()
                        .name("john doe")
                        .age(30)
                        .email("johndoe@example.com")
                        .build();
        system.out.println(user);
    }
}

在这个示例中,通过 user.builder() 方法获取一个 userbuilder 实例,然后通过链式调用设置各个属性,最后调用 build() 方法创建 user 对象。

这种方式的优点是可以灵活地设置对象的属性,并且不需要创建多个构造函数来满足不同的初始化需求。特别是在属性较多的类中,使用 @builder 可以显著提高代码的可读性和可维护性。

二、不足之处

@builder 生成的构造器不是完美的,它不能区分哪些参数是必须的,哪些是可选的。如果没有提供必须的参数,构造器可能会创建出不完整或者不合法的对象。

假设我们有一个 order 类,其中 orderid 是必须的,而 description 是可选的:

import lombok.builder;
import lombok.tostring;
@builder
@tostring
public class order {
    private string orderid;  // 必须的参数
    private string description;  // 可选的参数
}

在使用 @builder 构建 order 对象时,可能会出现这样的情况:

public class main {
    public static void main(string[] args) {
        // 忘记设置必须的 orderid
        order order = order.builder()
                           .description("this is an optional description")
                           .build();
        system.out.println(order);
    }
}

在这个示例中,由于 orderid 是一个必须的参数,但在构建 order 对象时没有提供 orderid,导致生成的对象可能不合法或不完整。

很多人 喜欢 @builder 和 @data 搭配使用,导致生成的构造器是可变的,它允许使用 setter 方法修改构造器的状态。这违反了构造器模式的原则,构造器应该是不可变的,一旦创建就不能被修改。

如果非要使用 @builder ,那么不要用 @data ,要用 @getter。相对来说,反而 @accessors 的行为更符合这个要求。

@builder 生成的构造器不适合用于短暂的对象,它会增加代码的复杂度和冗余。构造器模式更适合用于生命周期较长、有多种变体的对象。

实际使用中经常发现 @builder 滥用的情况,有些仅仅一两个属性的类也都要用 @builder,真的没必要用,直接用全参的构造方法都比这更简洁。

@builder 生成的构造器不能处理抽象类型的参数,它只能接受具体类型的对象。这限制了构造器的灵活性和扩展性,不能根据不同的需求创建不同风格的对象。

假设我们有一个抽象的 vehicle 类和一个具体的 car 类:

public abstract class vehicle {
    private string brand;
    public vehicle(string brand) {
        this.brand = brand;
    }
    public string getbrand() {
        return brand;
    }
}
public class car extends vehicle {
    private int numberofdoors;
    public car(string brand, int numberofdoors) {
        super(brand);
        this.numberofdoors = numberofdoors;
    }
    public int getnumberofdoors() {
        return numberofdoors;
    }
}

现在,我们尝试使用 @builder 来创建一个包含 vehicle 类型参数的 garage 类:

import lombok.builder;
import lombok.tostring;
@builder
@tostring
public class garage {
    private vehicle vehicle;  // 抽象类型参数
}

在使用 @builder 创建 garage 对象时,我们会遇到问题,因为 vehicle 是一个抽象类,无法直接实例化:

public class main {
    public static void main(string[] args) {
        // 这段代码会有问题,因为 vehicle 是抽象的,不能直接实例化
        garage garage = garage.builder()
                              .vehicle(new vehicle("generic brand") {})  // 错误:不能实例化抽象类
                              .build();
        system.out.println(garage);
    }
}

解决方案:使用具体类型:在构建器中使用具体类型的对象,而不是抽象类型。例如,直接使用 car 类

public class main {
    public static void main(string[] args) {
        car car = new car("toyota", 4);
        garage garage = garage.builder()
                              .vehicle(car)
                              .build();
        system.out.println(garage);
    }
}

继承关系时,子类需要使用 @superbuilder。对象继承后,子类的 builder 因为构造函数的问题,使用不当大概率会报错,并且无法设置父类的属性,还需要使用 @superbuilder 来解决问题。

假设我们有一个父类 vehicle 和一个子类 car,并希望通过构建器来设置它们的属性:通过 @superbuilder,我们可以在子类的构建器中设置父类的属性:

public class main {
    public static void main(string[] args) {
        car car = car.builder()
                     .brand("toyota")      // 设置父类的属性
                     .model("corolla")     // 设置父类的属性
                     .numberofdoors(4)     // 设置子类的属性
                     .build();
        system.out.println("brand: " + car.getbrand());
        system.out.println("model: " + car.getmodel());
        system.out.println("number of doors: " + car.getnumberofdoors());
    }
}

@superbuilder 注解:它是 @builder 的增强版本,专门用于处理继承关系。使用 @superbuilder 可以在子类的构建器中访问和设置父类的属性。

final 关键字:在这个示例中,属性被声明为 final,确保它们在对象构建后不可变。

构建器链:@superbuilder 允许在子类的构建器中调用父类的构建器方法,从而设置父类的属性。

设置默认值需要使用 @builder.default。很容易因为对此不了解,导致默认值不符合预期导致出现 bug。

import lombok.builder;
import lombok.getter;
import lombok.tostring;
@getter
@builder
@tostring
public class user {
    private final string username;
    private final string email;
    @builder.default
    private final boolean active = true;  // 默认值
    @builder.default
    private final int loginattempts = 0;  // 默认值
}
public class main {
    public static void main(string[] args) {
        // 使用构建器创建对象,并未显式设置 active 和 loginattempts
        user user = user.builder()
                        .username("john_doe")
                        .email("john.doe@example.com")
                        .build();
        system.out.println(user);
        // 显式设置 active 和 loginattempts
        user anotheruser = user.builder()
                               .username("jane_doe")
                               .email("jane.doe@example.com")
                               .active(false)
                               .loginattempts(3)
                               .build();
        system.out.println(anotheruser);
    }
}

到此这篇关于java中使用 @builder 注解的简单示例的文章就介绍到这了,更多相关java使用 @builder 注解内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com