Builder

// Builder パターンの使用は、製品が非常に複雑で細かな構成が必要な場合にの
// み意味がある。以下の二つのプロダクトは、共通のインターフェースは持たな
// いが、関連している。
class Car is
    // 車には、GPS とトリップコンピューターといくつかの座席がある。異なる
    // モデルの車（スポーツカー、SUV、オープンカー）には、異なる機能が搭
    // 載されている。

class Manual is
    // 車ごとに、その車の構成に従ったマニュアルがあり、全機能を説明する。


// ビルダー・インターフェースは、プロダクト・オブジェクトの異なる部品を作
// 成するメソッドを指定。
interface Builder is
    method reset()
    method setSeats(……)
    method setEngine(……)
    method setTripComputer(……)
    method setGPS(……)

// 具象ビルダー・クラスはビルダー・インターフェースに従い、構築ステップの
// 特定の実装を行う。プログラムには、いくつかの異種のビルダーがあるかもし
// れない。
class CarBuilder implements Builder is
    private field car:Car

    // できたてのビルダーのインスタンスは、今後の組み立てに使用される、空
    // のプロダクト・オブジェクトがある。
    constructor CarBuilder() is
        this.reset()

    // リセット・メソッドは、構築されるオブジェクトを一掃する。
    method reset() is
        this.car = new Car()

    // 全生産ステップは、同一のプロダクト・インスタンスに対して機能。
    method setSeats(……) is
        // 座席数を指定。

    method setEngine(……) is
        // 指定のエンジンを搭載。

    method setTripComputer(……) is
        // トリップコンピュータを取り付け。

    method setGPS(……) is
        // GPS を取り付け。

    // 具象ビルダーは、結果を取得するための独自のメソッドを提供することに
    // なっている。ビルダーによっては、まったく異なるプロダクトを生成する
    // 可能性があり、同じインターフェースに従えないため。したがって、結果
    // 取得のためのメソッドは、ビルダー・インターフェース（少なくとも静的
    // 型付けプログラミング言語）では宣言できない。
    //
    // 通常、最終結果をクライアントに返した後、ビルダーのインスタンスは別
    // のプロダクトの構築を開始する準備ができているものと期待される。その
    // ため、普通はプロダクト取得メソッドの中でリセット・メソッドを呼び出
    // す。 ただし、これは必須ではない。クライアント・コードからの明示的
    // なリセット呼び出しを待ってから今までの結果を廃棄してもよい。
    method getProduct():Car is
        product = this.car
        this.reset()
        return product

// 他の生成に関するパターンと異なり、Builder では、共通インターフェースに
// 従わないプロダクトを構築可能。
class CarManualBuilder implements Builder is
    private field manual:Manual

    constructor CarManualBuilder() is
        this.reset()

    method reset() is
        this.manual = new Manual()

    method setSeats(……) is
        // 車の座席の特徴に関する記述。

    method setEngine(……) is
        // エンジンに関する説明を追加。

    method setTripComputer(……) is
        // トリップコンピューターに関する説明を追加。

    method setGPS(……) is
        // GPS に関する説明を追加。

    method getProduct():Manual is
        // マニュアルを返し、ビルダーをリセット。


// ディレクターは、構築ステップを特定の順番で実行することのみの責任を持つ。
// プロダクトを特定の順番や構成で作り出す時に便利。クライアントはビル
// ダーを直接管理できるので、ディレクター・クラスは厳密には必須でない。
class Director is
    // ディレクターは、クライアント・コードが渡すどんなビルダー・インスタ
    // ンスとでも機能する。このため、クライアント・コードは、新規に組み立
    // てられたプロダクトの最終的な型を変更可能。ディレクターは、同一の
    // 構築ステップを使っていくつものプロダクトの異種を構築可能。
    method constructSportsCar(builder: Builder) is
        builder.reset()
        builder.setSeats(2)
        builder.setEngine(new SportEngine())
        builder.setTripComputer(true)
        builder.setGPS(true)

    method constructSUV(builder: Builder) is
        // ……


// クライアント・コードはビルダー・オブジェクトを作成し、それをディレク
// ターに渡し、構築プロセスを開始。最終結果はビルダーオブジェクトから取得。
class Application is

    method makeCar() is
        director = new Director()

        CarBuilder builder = new CarBuilder()
        director.constructSportsCar(builder)
        Car car = builder.getProduct()

        CarManualBuilder builder = new CarManualBuilder()
        director.constructSportsCar(builder)

        // ディレクターは具象ビルダーのクラスとプロダクトを認識していない
        // ため、最終製品はビルダー・オブジェクトから取得することが多い。
        Manual manual = builder.getProduct()