架构与系统设计 / 系统课时

建造者收敛复杂构造参数

建造者收敛复杂构造参数

当一个对象拥有大量可选参数、默认值和构造顺序要求时,长参数构造器会让调用代码难读且容易传错。建造者把“收集参数”和“最终创建对象”分开,同时适合表达分步骤构造和对象不变量。

学习目标

  • 识别多参数构造器真正难维护的原因
  • 能使用 Builder 组织必填参数、可选参数与默认值
  • 能判断 Builder 是否值得引入,而不是把所有构造器都改成 Builder

多参数构造器的问题

考虑一个导出任务,它要求名称和目标目录,同时允许设置格式、压缩、并发数等选项。直接使用构造器时,参数类型相同或含义接近,调用者很难仅靠位置判断含义;随着参数增加,重载构造器也会迅速膨胀。

java
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 构造器,可选项则提供带默认值的方法。

java
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);
    }
}

预期输出

text
job created: daily-orders

这个实现还有一个重要特点:ExportJob 的字段最终都是 final,对象一旦由 build() 创建就不会再被 Builder 的后续修改影响。参数校验集中在 Builder 中,非法组合可以在对象离开构造阶段前被拒绝。

Builder 与普通构造器的边界

参数很少、顺序自然、几乎没有可选项时,普通构造器更简单。Builder 更适合以下情况:可选参数较多、默认值明显、调用代码需要强调参数含义,或者构造过程中需要进行组合校验。

不要把 Builder 理解成“更高级的构造器”。它真正解决的是构造过程的可读性与约束集中。如果 Builder 只是机械地把两个参数包一层,却没有降低调用复杂度,就会增加不必要的类和方法。

另一个常见边界是分步骤构造。如果对象必须先设置基础信息,再设置某些依赖项,Builder 可以把这些步骤组织起来;但若步骤本身代表业务流程,例如“申请 → 审批 → 支付”,就不应把整个业务流程塞进 Builder。Builder 负责构造对象,而不是替代领域流程编排。

重构时怎么判断

可以先看原有构造器的三个信号:调用点是否出现连续布尔值或多个同类型字符串,是否存在大量构造器重载,是否需要在创建对象前执行多项参数校验。命中越多,Builder 的收益通常越明显。

最终边界很清楚:普通构造器适合简单且稳定的参数集合;Builder 适合复杂、可选、需要默认值或需要集中校验的对象构造。重构的目标不是增加一个模式,而是让创建对象这件事本身更容易读、改和验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

建造者收敛复杂构造参数

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通