Czym jest wzorzec Decorator?

Question

Accepted Answer

Wzorzec **Decorator** dynamicznie dodaje **zachowanie lub odpowiedzialność** do obiektów poprzez ich opakowywanie — bez modyfikowania oryginalnej klasy. Stanowi elastyczną alternatywę dla dziedziczenia, umożliwiając rozszerzanie funkcjonalności poprzez komponowanie zachowań.

## Co robi wzorzec Decorator

```text
DECORATOR → WRAP an object to add behavior, keeping the same interface:
  → the decorator wraps the original, adds its behavior, and delegates to the original
  → you can STACK decorators (wrap a wrapped object) → compose multiple behaviors
  → adds functionality WITHOUT modifying the original class or using subclassing
→ "wrap to extend" — flexible, composable behavior addition
```

## Przykład

```js
// base object
let coffee = { cost: () => 5, description: () => 'coffee' };
// decorators wrap and add behavior
function withMilk(c) {
  return { cost: () => c.cost() + 1, description: () => c.description() + ' + milk' };
}
function withSugar(c) {
  return { cost: () => c.cost() + 0.5, description: () => c.description() + ' + sugar' };
}
coffee = withSugar(withMilk(coffee));   // stack decorators
coffee.cost();          // 6.5 — composed behavior
```

## Korzyści i zastosowania

```text
BENEFITS:
  ✓ Add behavior WITHOUT modifying the original (open/closed) or subclass explosion
  ✓ COMPOSE behaviors flexibly at runtime (stack different decorators in combinations)
  ✓ Single responsibility → each decorator adds one thing
USES → I/O streams (wrapping streams), middleware (wrap request handlers), UI components,
  adding features (logging, caching, validation) around a core object; HOC in React
```

## Dlaczego to ważne

Zrozumienie wzorca Decorator jest wartościowe, ponieważ to **użyteczny wzorzec strukturalny** do elastycznego rozszerzania zachowania, dlatego stanowi praktycznie istotną wiedzę projektową.

Wzorzec Decorator dodaje zachowanie do obiektów poprzez ich **opakowywanie** (zachowując ten sam interfejs, delegując do oryginału przy jednoczesnym dodawaniu zachowania), bez modyfikowania oryginalnej klasy — zapewniając elastyczną alternatywę dla dziedziczenia.

Zrozumienie tego, co robi (opakowywanie obiektu w celu dodania zachowania, z możliwością **składania dekoratorów** w celu komponowania wielu zachowań) to kluczowa wiedza.

Zrozumienie **korzyści** jest istotne: dodaje zachowanie **bez modyfikowania oryginału** (zgodnie z zasadą open/closed) i unika **eksplozji podklas**, która wynikałaby z tworzenia podklas dla każdej kombinacji funkcji, umożliwia **elastyczne komponowanie zachowań w czasie wykonania** (składanie różnych dekoratorów w różnych kombinacjach) i wspiera Single Responsibility (każdy dekorator dodaje jedną rzecz).

Ta możliwość komponowania — budowanie zachowania poprzez składanie małych, skoncentrowanych dekoratorów — to główna siła wzorca, znacznie bardziej elastyczna niż sztywne dziedziczenie.

Zrozumienie **zastosowań** — strumienie I/O (klasyczny przykład opakowywania strumieni), middleware (opakowywanie procedur obsługi żądań — powszechne w frameworkach webowych), komponenty UI, dodawanie funkcji crosscuttingowych (logowanie, cachowanie, walidacja) wokół obiektu rdzenia, i komponenty wyższego rzędu React — wyjaśnia jego szeroką, rzeczywistą zastosowanie.

Wzorzec Decorator pojawia się w całych rzeczywistych frameworkach i bibliotekach.

Ponieważ wzorzec Decorator to użyteczny wzorzec strukturalny do elastycznego rozszerzania zachowania (opakowywanie w celu dodania zachowania bez modyfikowania oryginałów lub eksplozji podklas, komponowanie zachowań w czasie wykonania), a zrozumienie tego, co robi, jego korzyści i typowe zastosowania (strumienie, middleware, funkcje) jest praktycznie istotne, zrozumienie wzorca Decorator stanowi wartościową, powszechnie stosowaną wiedzę projektową — użyteczny wzorzec do elastycznego, komponentowalnego rozszerzania zachowania, pojawiający się w całych rzeczywistych frameworkach (strumienie, middleware, HOCs) i ważna wiedza projektowa do czystego rozszerzania funkcjonalności bez modyfikowania oryginałów lub tworzenia sztywnych hierarchii podklas.