架构与系统设计 / 系统课时
建造者收敛复杂构造参数
建造者收敛复杂构造参数
当一个对象拥有大量可选参数、默认值和构造顺序要求时,长参数构造器会让调用代码难读且容易传错。建造者把“收集参数”和“最终创建对象”分开,同时适合表达分步骤构造和对象不变量。
学习目标
- 识别多参数构造器真正难维护的原因
- 能使用 Builder 组织必填参数、可选参数与默认值
- 能判断 Builder 是否值得引入,而不是把所有构造器都改成 Builder
多参数构造器的问题
考虑一个导出任务,它要求名称和目标目录,同时允许设置格式、压缩、并发数等选项。直接使用构造器时,参数类型相同或含义接近,调用者很难仅靠位置判断含义;随着参数增加,重载构造器也会迅速膨胀。
class ExportJob {
private final String name;
private final String outputDir;
private final String format;
private final boolean compress;
private final int parallelism;
ExportJob(String name, String outputDir, String format,
boolean compress, int parallelism) {
this.name = name;
this.outputDir = outputDir;
this.format = format;
this.compress = compress;
this.parallelism = parallelism;
}
}这种代码本身没有语法问题,问题在于调用点表达能力弱:读者必须回到构造器定义才能确认第三、第四和第五个参数的含义。
Builder 如何收敛参数
Builder 的核心做法是让调用者按参数名称逐步设置选项,最后由 build() 完成一次最终校验和对象创建。必填项可以放进 Builder 构造器,可选项则提供带默认值的方法。
public class BuilderDemo {
static final class ExportJob {
private final String name;
private final String outputDir;
private final String format;
private final boolean compress;
private final int parallelism;
private ExportJob(Builder builder) {
this.name = builder.name;
this.outputDir = builder.outputDir;
this.format = builder.format;
this.compress = builder.compress;
this.parallelism = builder.parallelism;
}
static final class Builder {
private final String name;
private final String outputDir;
private String format = "csv";
private boolean compress = false;
private int parallelism = 1;
Builder(String name, String outputDir) {
if (name == null || name.isBlank()) {
throw new IllegalArgumentException("name is required");
}
if (outputDir == null || outputDir.isBlank()) {
throw new IllegalArgumentException("outputDir is required");
}
this.name = name;
this.outputDir = outputDir;
}
Builder format(String format) {
if (!format.equals("csv") && !format.equals("json")) {
throw new IllegalArgumentException("unsupported format");
}
this.format = format;
return this;
}
Builder compress(boolean compress) {
this.compress = compress;
return this;
}
Builder parallelism(int parallelism) {
if (parallelism < 1 || parallelism > 8) {
throw new IllegalArgumentException("parallelism must be 1..8");
}
this.parallelism = parallelism;
return this;
}
ExportJob build() {
return new ExportJob(this);
}
}
}
public static void main(String[] args) {
ExportJob job = new ExportJob.Builder("daily-orders", "/data/export")
.format("json")
.compress(true)
.parallelism(4)
.build();
System.out.println("job created: " + job.name);
}
}预期输出
job created: daily-orders这个实现还有一个重要特点:ExportJob 的字段最终都是 final,对象一旦由 build() 创建就不会再被 Builder 的后续修改影响。参数校验集中在 Builder 中,非法组合可以在对象离开构造阶段前被拒绝。
Builder 与普通构造器的边界
参数很少、顺序自然、几乎没有可选项时,普通构造器更简单。Builder 更适合以下情况:可选参数较多、默认值明显、调用代码需要强调参数含义,或者构造过程中需要进行组合校验。
不要把 Builder 理解成“更高级的构造器”。它真正解决的是构造过程的可读性与约束集中。如果 Builder 只是机械地把两个参数包一层,却没有降低调用复杂度,就会增加不必要的类和方法。
另一个常见边界是分步骤构造。如果对象必须先设置基础信息,再设置某些依赖项,Builder 可以把这些步骤组织起来;但若步骤本身代表业务流程,例如“申请 → 审批 → 支付”,就不应把整个业务流程塞进 Builder。Builder 负责构造对象,而不是替代领域流程编排。
重构时怎么判断
可以先看原有构造器的三个信号:调用点是否出现连续布尔值或多个同类型字符串,是否存在大量构造器重载,是否需要在创建对象前执行多项参数校验。命中越多,Builder 的收益通常越明显。
最终边界很清楚:普通构造器适合简单且稳定的参数集合;Builder 适合复杂、可选、需要默认值或需要集中校验的对象构造。重构的目标不是增加一个模式,而是让创建对象这件事本身更容易读、改和验证。