Decorator

Intent

Attaches new behaviours to objects by placing them inside wrapper objects that share the same interface.

Problem

Users want notifications by email, SMS and Slack in any combination. Subclassing every combination explodes.

Solution

Wrap the base notifier in decorators. Each adds its behaviour and delegates to the wrapped object.

Real-world analogy

Structure

Hover or tap a numbered role to highlight it in the diagram.

1. 1Component — Component declares the interface shared by wrappers and wrapped objects.
2. 2ConcreteComponent — Concrete Component is the object being wrapped; it defines the basic behaviour.
3. 3BaseDecorator — Base Decorator holds a reference to a wrapped Component and delegates all work to it.
4. 4ConcreteDecorator — Concrete Decorators add behaviour before or after calling the parent method.
5. 5Client — Client wraps components in as many layers as it needs.

Try it

Code example

public interface INotifier { void Send(string message); }

public class EmailNotifier : INotifier
{
    public void Send(string message) => Console.WriteLine(
quot;email: {message}");
}

public abstract class NotifierDecorator : INotifier
{
    private readonly INotifier inner;
    protected NotifierDecorator(INotifier inner) => this.inner = inner;
    public virtual void Send(string message) => inner.Send(message);
}

public class SlackDecorator : NotifierDecorator
{
    public SlackDecorator(INotifier inner) : base(inner) { }
    public override void Send(string message)
    {
        base.Send(message);
        Console.WriteLine(
quot;slack: {message}");
    }
}

// INotifier n = new SlackDecorator(new EmailNotifier());

Applicability

How to implement

1. Make sure the domain can be a primary component with optional layers
2. Define a component interface
3. Create a concrete component
4. Create a base decorator holding a wrapped component and delegating to it
5. Create concrete decorators that add behaviour before or after delegating
6. Let the client compose decorators

Pros and cons

Relations with other patterns

Check yourself