Padrão Decorator

Parte da seção Programação Orientada a Objetos do Journey de PHP da Coddy — lição 77 de 91.

O Decorator Pattern é um padrão de projeto estrutural que permite adicionar novos comportamentos a objetos dinamicamente, envolvendo-os em objetos wrapper especiais chamados decorators. Ao contrário da herança, que adiciona comportamento em tempo de compilação, os decorators adicionam comportamento em tempo de execução.

Imagine uma cafeteria. Você começa com um café básico e depois adiciona extras como leite, açúcar ou chantilly.

Cada adição envolve o café original e acrescenta à sua descrição e custo. A percepção principal é que tanto o café base quanto os decoradores compartilham a mesma interface.

<?php
interface Coffee {
    public function getDescription(): string;
    public function getCost(): float;
}

class SimpleCoffee implements Coffee {
    public function getDescription(): string {
        return "Simple Coffee";
    }
    
    public function getCost(): float {
        return 2.00;
    }
}

Decoradores implementam a mesma interface e envolvem outro objeto Coffee:

<?php
class MilkDecorator implements Coffee {
    public function __construct(private Coffee $coffee) {}
    
    public function getDescription(): string {
        return $this->coffee->getDescription() . ", Milk";
    }
    
    public function getCost(): float {
        return $this->coffee->getCost() + 0.50;
    }
}

class SugarDecorator implements Coffee {
    public function __construct(private Coffee $coffee) {}
    
    public function getDescription(): string {
        return $this->coffee->getDescription() . ", Sugar";
    }
    
    public function getCost(): float {
        return $this->coffee->getCost() + 0.25;
    }
}

$coffee = new SimpleCoffee();
$coffee = new MilkDecorator($coffee);
$coffee = new SugarDecorator($coffee);

echo $coffee->getDescription() . " = $" . $coffee->getCost();

Saída:

Simple Coffee, Milk, Sugar = $2.75

Cada decorador envolve o objeto anterior, formando uma cadeia. O padrão permite combinar comportamentos em qualquer ordem e quantidade sem criar uma classe para cada combinação possível. Precisa de leite duplo? Basta envolvê-lo duas vezes.

Desafio

Fácil

Vamos construir um sistema de pedidos de pizza usando o Decorator Pattern. Você começará com uma pizza básica e adicionará coberturas dinamicamente — cada cobertura envolve a pizza e adiciona à sua descrição e preço, assim como o exemplo do café da lição.

Você organizará seu código em quatro arquivos:

Pizza.php — Defina uma interface Pizza que estabelece o contrato para todas as pizzas e coberturas. Ela deve ter dois métodos: getDescription(): string e getPrice(): float.
BasePizza.php — Inclua a interface Pizza e crie uma classe MargheritaPizza que a implemente. Esta é a sua pizza base com uma descrição de "Margherita" e um preço de 8.00.
Toppings.php — Inclua a interface Pizza e crie três classes decoradoras que a implementem. Cada decorador envolve um objeto Pizza (aceite-o no construtor) e aprimora tanto a descrição quanto o preço:
- CheeseTopping — Adiciona ", Extra Cheese" à descrição e 1.50 ao preço
- PepperoniTopping — Adiciona ", Pepperoni" à descrição e 2.00 ao preço
- MushroomTopping — Adiciona ", Mushrooms" à descrição e 1.25 ao preço
main.php — Inclua os arquivos BasePizza e Toppings. Você receberá uma entrada: uma lista de coberturas separadas por vírgula para adicionar (ex: "cheese,pepperoni" ou "mushroom,cheese,cheese").
Comece com uma MargheritaPizza. Para cada cobertura na entrada, envolva sua pizza com o decorador apropriado:
- "cheese" envolve com CheeseTopping
- "pepperoni" envolve com PepperoniTopping
- "mushroom" envolve com MushroomTopping
Após aplicar todas as coberturas, imprima a descrição e o preço final da pizza neste formato:

[description] = $[price]

Formate o preço com duas casas decimais.

Observe como a mesma cobertura pode ser aplicada várias vezes — pedir queijo duplo significa simplesmente envolver com CheeseTopping duas vezes. Essa flexibilidade é o poder do Decorator Pattern!

Folha de consulta

O Decorator Pattern (Padrão Decorator) é um padrão de design estrutural que adiciona comportamentos a objetos dinamicamente, envolvendo-os em objetos decoradores em tempo de execução.

Tanto o objeto base quanto os decoradores implementam a mesma interface:

<?php
interface Coffee {
    public function getDescription(): string;
    public function getCost(): float;
}

class SimpleCoffee implements Coffee {
    public function getDescription(): string {
        return "Simple Coffee";
    }
    
    public function getCost(): float {
        return 2.00;
    }
}

Decoradores envolvem outro objeto do mesmo tipo de interface:

<?php
class MilkDecorator implements Coffee {
    public function __construct(private Coffee $coffee) {}
    
    public function getDescription(): string {
        return $this->coffee->getDescription() . ", Milk";
    }
    
    public function getCost(): float {
        return $this->coffee->getCost() + 0.50;
    }
}

class SugarDecorator implements Coffee {
    public function __construct(private Coffee $coffee) {}
    
    public function getDescription(): string {
        return $this->coffee->getDescription() . ", Sugar";
    }
    
    public function getCost(): float {
        return $this->coffee->getCost() + 0.25;
    }
}

Encadeie decoradores para combinar comportamentos:

$coffee = new SimpleCoffee();
$coffee = new MilkDecorator($coffee);
$coffee = new SugarDecorator($coffee);

echo $coffee->getDescription() . " = $" . $coffee->getCost();
// Saída: Simple Coffee, Milk, Sugar = $2.75

Decoradores podem ser aplicados várias vezes e em qualquer ordem sem a necessidade de criar classes para cada combinação.

Experimente você mesmo

<?php
require_once 'BasePizza.php';
require_once 'Toppings.php';

// Ler a entrada - lista de coberturas separada por vírgulas
$input = trim(fgets(STDIN));
$toppings = explode(',', $input);

// Começar com uma MargheritaPizza base
$pizza = new MargheritaPizza();

// TODO: Percorrer cada cobertura e envolver a pizza com o decorador apropriado
// - "cheese" -> envolver com CheeseTopping
// - "pepperoni" -> envolver com PepperoniTopping
// - "mushroom" -> envolver com MushroomTopping

// TODO: Imprimir o resultado no formato: [description] = $[price]
// Formatar o preço para 2 casas decimais usando number_format()

?>