Builder — 分離複雜物件的建構與表示

Tue, 07 Aug 2018 02:16:32 +0800

1. 意圖

將一個複雜物件的建構步驟與最終表示分離，使同樣的建構流程可以產生不同的物件，同時消除因可選參數過多而衍生的「伸縮建構子」反模式。

2. UML 類圖

classDiagram
    class Director {
        +construct(Builder)
    }
    class Builder {
        <>
        +buildPartA()
        +buildPartB()
        +getResult() Product
    }
    class ConcreteBuilder {
        -product Product
        +buildPartA()
        +buildPartB()
        +getResult() Product
    }
    class Product
    Director --> Builder
    Builder <|.. ConcreteBuilder
    ConcreteBuilder --> Product

3. 何時用 / 何時別用

用：

建構子有 4 個以上參數，且部分為可選（Effective Java Item 2）
物件不可變（immutable），但欄位多到無法一次傳入
需要在 build() 時做跨欄位的驗證邏輯

別用：

欄位少且全為必填，直接用建構子更清晰
物件非常簡單（考慮改用 Java Record）
效能極敏感路徑（每次 build() 都產生一個中間 Builder 物件）

4. Java 範例

以 HTTP 請求設定為例，展示必填欄位在 Builder 建構子中固定、可選欄位採 fluent 設定：

Builder on Bill.Lin's Notes

Builder — 分離複雜物件的建構與表示

1. 意圖

2. UML 類圖

3. 何時用 / 何時別用

4. Java 範例