Budowniczy

// Stosowanie wzorca Budowniczy ma sens tylko gdy produkty w
// programie są złożone i wymagają kompleksowej konfiguracji.
// Poniższe dwa produkty są powiązane, ale nie mają wspólnego
// interfejsu.
class Car is
    // Samochód może mieć GPS, komputer pokładowy i pewną liczbę
    // siedzeń. Różne modele samochodów (sportowe, SUV-y,
    // kabriolety) mogą mieć różne opcjonalne funkcjonalności.

class Manual is
    // Do każdego samochodu powinna istnieć instrukcja obsługi,
    // która opisuje jego konfigurację i funkcje.


// Interfejs budowniczy określa metody służące tworzeniu
// poszczególnych części obiektów-produktów.
interface Builder is
    method reset()
    method setSeats(...)
    method setEngine(...)
    method setTripComputer(...)
    method setGPS(...)

// Konkretne klasy budowniczy są zgodne pod względem interfejsu
// i zawierają szczegółowe implementacje etapów budowania. Twój
// program może mieć wiele różnie zaimplementowanych wariacji
// budowniczych.
class CarBuilder implements Builder is
    private field car:Car

    // Nowo utworzona instancja budowniczego powinna zawierać
    // pusty obiekt-produkt, który będzie podstawą do dalszej
    // budowy.
    constructor CarBuilder() is
        this.reset()

    // Metoda resetująca zeruje budowany obiekt.
    method reset() is
        this.car = new Car()

    // Wszystkie etapy produkcji działają na tej samej instancji
    // produktu.
    method setSeats(...) is
        // Ustaw ilość siedzeń w aucie.

    method setEngine(...) is
        // Zamontuj dany silnik.

    method setTripComputer(...) is
        // Zamontuj komputer pokładowy.

    method setGPS(...) is
        // Zamontuj nawigację GPS.

    // Konkretni budowniczy powinni posiadać własne metody
    // pozyskiwania wyników działań, gdyż różni budowniczowie
    // tworzą różne produkty i nie zawsze zgodne pod względem
    // interfejsu. Dlatego też nie można zadeklarować takich
    // metod w interfejsie budowniczego (a przynajmniej nie
    // można tego dokonać w statycznie typowanym języku
    // programowania).
    //
    // Zazwyczaj po zwróceniu wyniku działania klientowi,
    // instancja budowniczego powinna być gotowa na rozpoczęcie
    // produkcji od nowa. Dlatego typową praktyką jest wywołanie
    // metody resetującej na końcu kodu metody `getProduct`. Nie
    // jest to jednak obowiązkowe i można odroczyć zerowanie do
    // momentu gdy klient prześle stosowne polecenie.
    method getProduct():Car is
        product = this.car
        this.reset()
        return product

// W przeciwieństwie do innych wzorców kreacyjnych, budowniczy
// pozwala konstruować produkty które nie mają wspólnego
// interfejsu.
class CarManualBuilder implements Builder is
    private field manual:Manual

    constructor CarManualBuilder() is
        this.reset()

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

    method setSeats(...) is
        // Udokumentuj specyfikację siedzeń.

    method setEngine(...) is
        // Dodaj instrukcję silnika.

    method setTripComputer(...) is
        // Dodaj instrukcję komputera pokładowego.

    method setGPS(...) is
        // Dodaj instrukcję nawigacji GPS.

    method getProduct():Manual is
        // Zwróć instrukcję obsługi i zresetuj budowniczego.


// Kierownik jest odpowiedzialny tylko za wywoływanie etapów
// budowy w odpowiedniej kolejności. Przydaje się to gdy
// tworzymy produkty według określonego porządku lub
// konfiguracji. Doprecyzowując — klasa kierownik jest
// opcjonalna, ponieważ klient może kontrolować budowniczych
// bezpośrednio.
class Director is
    // Kierownik może współdziałać z dowolną instancją
    // budowniczego jaką klient mu przekaże. Dzięki temu kod
    // klienta może zmienić ostateczny typ nowo utworzonego
    // produktu. Kierownik może skonstruować wiele wariacji
    // danego produktu postępując według tych samych etapów
    // budowy.
    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
        // ...


// Kod kliencki tworzy obiekt budowniczego, przekazuje go
// kierownikowi a następnie inicjuje proces konstrukcji.
// Ostateczny wynik działania pobiera się od obiektu
// budowniczego.
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)

        // Finalny produkt zwykle pobiera się od obiektu
        // budowniczego, ponieważ kierownik nic o nim nie wie i
        // nie jest zależny od konkretnych budowniczych czy
        // konkretnych produktów.
        Manual manual = builder.getProduct()