Dekorator

// Interfejs komponentu definiuje działania które można
// modyfikować za pomocą dekoratorów.
interface DataSource is
    method writeData(data)
    method readData():data

// Konkretne komponenty dostarczają domyślnych implementacji
// działań. Może istnieć wiele odmian tych klas w całym
// programie.
class FileDataSource implements DataSource is
    constructor FileDataSource(filename) { ... }

    method writeData(data) is
        // Zapisz dane do pliku.

    method readData():data is
        // Wczytaj dane z pliku.

// Bazowa klasa dekorator ma taki sam interfejs jak inne
// komponenty. Głównym celem tej klasy jest zdefiniowanie
// interfejsu, który będzie opakowywał wszystkie konkretne
// dekoratory. Domyślna implementacja kodu opakowującego może
// zawierać pole służące przechowywaniu opakowywanego komponentu
// oraz narzędzia służące jego inicjalizacji.
class DataSourceDecorator implements DataSource is
    protected field wrappee: DataSource

    constructor DataSourceDecorator(source: DataSource) is
        wrappee = source

    // Dekorator bazowy po prostu deleguje całą pracę
    // opakowywanemu komponentowi. Dodatkową funkcjonalność
    // można dodać w formie kolejnych konkretnych dekoratorów.
    method writeData(data) is
        wrappee.writeData(data)

    // Konkretni dekoratorzy mogą wywoływać implementację
    // działania z nadklasy zamiast bezpośrednio z opakowywanego
    // obiektu. To podejście upraszcza rozszerzanie klas
    // dekoratorów.
    method readData():data is
        return wrappee.readData()

// Konkretne dekoratory wywołują metody opakowywanego obiektu,
// ale mogą wzbogacać ich funkcjonalność. Dekoratory mogą
// wykonywać swoje działania albo przed, albo po wywołaniu
// metody opakowywanego obiektu.
class EncryptionDecorator extends DataSourceDecorator is
    method writeData(data) is
        // 1. Zaszyfruj przekazane dane.
        // 2. Przekaż zaszyfrowane dane metodzie writeData
        // obiektu opakowywanego.

    method readData():data is
        // 1. Pobierz dane od metody readData obiektu
        // opakowywanego.
        // 2. Spróbuj odszyfrować dane jeśli są zaszyfrowane.
        // 3. Zwróć wynik.

// Można opakowywać obiekty wieloma warstwami dekoratorów.
class CompressionDecorator extends DataSourceDecorator is
    method writeData(data) is
        // 1. Skompresuj przekazane dane.
        // 2. Przekaż skompresowane dane metodzie writeData
        // opakowywanego obiektu.

    method readData():data is
        // 1. Pobierz dane od metody readData opakowywanego
        // obiektu.
        // 2. Spróbuj je zdekompresować jeśli są skompresowane.
        // 3. Zwróć wynik.


// Opcja 1. Prosty przykład zestawu dekoratorów.
class Application is
    method dumbUsageExample() is
        source = new FileDataSource("somefile.dat")
        source.writeData(salaryRecords)
        // Docelowy plik wypełniono danymi w formie otwartego
        // tekstu.

        source = new CompressionDecorator(source)
        source.writeData(salaryRecords)
        // Plik docelowy wypełniono skompresowanymi danymi.

        source = new EncryptionDecorator(source)
        // Zmienna source zawiera teraz:
        // Szyfrowanie > Kompresja > FileDataSource
        source.writeData(salaryRecords)
        // Plik zapisano zaszyfrowanymi i skompresowanymi
        // danymi.


// Opcja 2. Kod kliencki korzystający z zewnętrznego źródła
// danych. Obiekty SalaryManager nie znają szczegółów
// magazynowania danych. Pracują z już skonfigurowanym źródłem
// danych które otrzymały od konfiguratora aplikacji.
class SalaryManager is
    field source: DataSource

    constructor SalaryManager(source: DataSource) { ... }

    method load() is
        return source.readData()

    method save() is
        source.writeData(salaryRecords)
    // ...Inne przydatne metody...


// W aplikacji można złożyć różne stosy dekoratorów w trakcie
// działania programu — zależnie od konfiguracji lub środowiska
// uruchomieniowego.
class ApplicationConfigurator is
    method configurationExample() is
        source = new FileDataSource("salary.dat")
        if (enabledEncryption)
            source = new EncryptionDecorator(source)
        if (enabledCompression)
            source = new CompressionDecorator(source)

        logger = new SalaryManager(source)
        salary = logger.load()
    // ...