1. 为什么我们需要Builder模式
第一次看到Builder模式时,我正被一个包含15个参数的构造函数折磨得死去活来。那是一个电商系统的订单创建接口,随着业务发展,订单属性越来越多,构造函数变成了这样:
java复制public Order(Long orderId, Long userId, List<OrderItem> items,
String address, String phone, Integer paymentType,
Integer deliveryType, String remark, Integer invoiceType,
String invoiceTitle, String couponCode, Integer source,
Date createTime, Integer status, String trackingNumber) {
// 构造逻辑...
}
每次调用这个构造函数时,我都得数着参数位置,生怕把发票类型和支付类型填反了。更可怕的是,随着业务发展,这个构造函数还在不断膨胀...
1.1 传统构造方式的痛点
这种"大而全"的构造方式存在几个致命问题:
- 可读性差:调用时难以直观理解每个参数的含义
- 灵活性低:必须提供所有参数,即使有些是可选的非必填项
- 维护困难:新增参数需要修改所有调用点
- 安全性弱:无法在构造过程中进行参数校验和业务规则验证
1.2 Builder模式的优势
Builder模式通过链式调用和分步构建,完美解决了这些问题:
java复制Order order = new OrderBuilder()
.orderId(12345L)
.userId(1001L)
.items(itemList)
.address("北京市海淀区")
.phone("13800138000")
.build();
这样的代码不仅可读性更好,还能:
- 按需设置属性
- 支持参数校验
- 保持对象不可变性
- 隐藏复杂构造逻辑
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础Builder模式实现
2.1 经典实现方式
让我们从一个简单的User类开始,看看基础Builder如何实现:
java复制public class User {
private final String username; // 必选
private final String password; // 必选
private final String email; // 可选
private final String phone; // 可选
private User(Builder builder) {
this.username = builder.username;
this.password = builder.password;
this.email = builder.email;
this.phone = builder.phone;
}
public static class Builder {
private final String username;
private final String password;
private String email;
private String phone;
public Builder(String username, String password) {
this.username = username;
this.password = password;
}
public Builder email(String email) {
this.email = email;
return this;
}
public Builder phone(String phone) {
this.phone = phone;
return this;
}
public User build() {
return new User(this);
}
}
}
使用方式:
java复制User user = new User.Builder("admin", "123456")
.email("admin@example.com")
.phone("13800138000")
.build();
2.2 实现要点解析
- 静态内部类:Builder通常作为目标类的静态内部类
- 必选参数:通过Builder构造函数强制要求
- 可选参数:通过setter方法按需设置
- 链式调用:每个setter返回Builder实例本身
- build()方法:最终构建目标对象
注意:目标类的构造器应该设为private,强制通过Builder创建实例
3. 进阶:阶梯式Builder模式
当对象构造过程存在多个必选步骤,且这些步骤有明确顺序要求时,基础Builder就显得力不从心了。这时就需要阶梯式Builder。
3.1 场景案例:订单构建
考虑一个电商订单的构建过程:
- 必须设置订单基本信息(ID、用户ID)
- 必须添加至少一个商品项
- 必须设置配送信息
- 可选设置发票信息
传统Builder无法强制这些步骤的顺序和必选性,而阶梯式Builder可以:
java复制public interface OrderBuilder {
interface BuildStep {
Order build();
}
interface InvoiceStep {
BuildStep withInvoice(String invoiceType, String invoiceTitle);
BuildStep withoutInvoice();
}
interface DeliveryStep {
InvoiceStep withDelivery(String address, String phone);
}
interface ItemsStep {
DeliveryStep withItems(List<OrderItem> items);
}
interface InitialStep {
ItemsStep
