(Builder Design Pattern) How can I add to a array that is a component to an object, and and how modify/change a component in a builder design pattern

在面向对象编程中，Builder设计模式因其优雅的对象构建方式而备受开发者青睐。然而，当对象包含数组类型组件时，如何高效地向数组中添加元素、如何动态修改已有组件，往往成为实践中的痛点。近日，多位资深架构师在技术社区分享了他们的经验，这套技巧不仅能提升代码可读性，还能有效规避“副作用”陷阱。

一、Builder模式的核心与数组组件的挑战

Builder模式的核心在于将复杂对象的构建过程与其表示分离，通过逐步配置来生成最终对象。典型的Builder接口包含一系列withXxx方法，每个方法返回Builder自身以实现链式调用，最后通过build()生成目标对象。

当组件为简单类型（如字符串、数值）时，直接赋值即可。但当组件为数组或集合时，直接提供setArray方法会导致两个问题：一是用户无法增量添加元素，二是如果Builder内部持有同一个数组引用，多次构建可能产生数据污染。

例如，一个Order对象包含List<Item>组件。若Builder提供items(List<Item> items)方法，用户不得不先构造完整的List，无法按需分步添加；如果Builder内部直接复用传入的List引用，则在构建后修改List会影响已构建的对象——这违反了不可变对象的初衷。

二、向数组组件添加元素：链式增量方法

解决增量添加的关键在于：Builder不应暴露“设置整个数组”的接口，而应提供“添加单个元素”的方法。以Java为例，典型的实现如下：

public class OrderBuilder {
    private List<Item> items = new ArrayList<>();

    public OrderBuilder addItem(Item item) {
        items.add(item);
        return this;
    }

    public Order build() {
        // 防御性拷贝，保护内部状态
        return new Order(new ArrayList<>(items));
    }
}

这样用户可链式调用：new OrderBuilder().addItem(item1).addItem(item2).build()。如果支持批量添加，可额外提供addAll(Collection<Item> items)方法，同样返回Builder自身。关键是所有添加操作都基于Builder内部持有的新ArrayList，不依赖外部传入的引用。

三、修改/更改已有组件：延迟赋值与副本机制

“修改组件”通常有两种场景：一是用户在构建过程中想替换Builder中已添加的某个元素；二是构建完成后需要修改对象内部的组件。后者应通过对象自身提供的方法（如addItem）实现，而非依赖Builder。Builder的责任仅在构建阶段。

针对构建过程中的修改，典型需求是：先通过addItem添加了默认商品，后来想替换某个位置或条件的商品。此时可提供modifyItem(int index, Item newItem)或replaceItem(Predicate<Item> condition, Item newItem)。但更常见的做法是：Builder不直接修改已有元素，而是让用户重新“构建”一个调整后的Builder。例如：

public OrderBuilder replaceItem(int index, Item newItem) {
    if (index < 0 || index >= items.size()) {
        throw new IndexOutOfBoundsException();
    }
    List<Item> cloned = new ArrayList<>(items);
    cloned.set(index, newItem);
    items = cloned; // 替换内部引用，避免影响已构建对象
    return this;
}

注意这里再次使用了防御性拷贝。如果Builder在构建前就持有可变List，且用户后续通过getItems()获取了内部引用，则可能破坏封装。因此建议Builder内部始终使用不可变列表或返回副本。

四、最佳实践：不可变性优先，防御性拷贝贯穿始终

在Builder模式中，对数组组件的处理应当遵循三条原则：

绝不暴露内部可变引用：Builder的build()方法返回时，应创建完整的不可变副本，或直接使用Collections.unmodifiableList()包装。对象的setter应被移除或设为私有。
增量式添加：避免setItems，改用addItem/addAll。这不仅使客户端代码更清晰，还允许条件分支逐步构建。
构建后对象不可篡改：如果对象内部需要动态修改数组组件，应通过对象提供的专门方法（如Order.addItem）完成，这些方法同样需执行拷贝或返回新对象。

五、实际案例：从订单系统到配置对象

以一个邮件配置构建器为例，组件包含List<Attachment>。如果采用setAttachments，用户必须提前创建好完整列表；而采用addAttachment，则可在读取文件列表时循环添加：

Email email = new EmailBuilder()
    .to("user@example.com")
    .subject("Report")
    .addAttachment(new Attachment("report.pdf"))
    .addAttachment(new Attachment("summary.pptx"))
    .build();

修改场景在复杂配置中更常见：用户先添加了默认附件，后发现需替换其中一个。通过replaceAttachment方法，可以优雅地实现替换而无需重新构造整个Builder。

六、总结

Builder模式中的数组组件并非棘手的难题，只需改变思维：将“设置”变为“添加”，将“直接引用”变为“防御性拷贝”。优秀的Builder设计应当让开发者以自然的方式构建对象，同时确保最终的实例具备不可变性。随着函数式编程理念的普及，越来越多语言原生支持不可变集合，但Builder模式依然是最灵活的解决方案之一。掌握这些技巧，你的代码将兼具简洁性与健壮性，在团队协作中也能减少因引用共享导致的隐蔽Bug。

相关阅读