Padrão Decorator

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

O padrão Decorator é um padrão de projeto estrutural que permite adicionar dinamicamente novos comportamentos aos objetos, envolvendo-os em objetos especiais de encapsulamento chamados decoradores. Diferentemente da herança, que adiciona comportamentos em tempo de compilação, os decoradores adicionam comportamentos 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 informações à sua descrição e ao seu custo. A principal percepção é 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 decorator 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 criar um sistema de pedidos de pizza usando o Padrão Decorator. Você começará com uma pizza básica e adicionará coberturas dinamicamente: cada cobertura envolve a pizza e acrescenta algo à sua descrição e ao seu preço, assim como no exemplo do café da lição.

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

Pizza.php: Defina uma interface Pizza que estabeleça 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 é sua pizza base, com a descrição "Margherita" e o preço 8.00.
Toppings.php: Inclua a interface Pizza e crie três classes decorator que a implementem. Cada decorator 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 separada por vírgulas das coberturas a serem adicionadas (por exemplo, "cheese,pepperoni" ou "mushroom,cheese,cheese").
Comece com uma MargheritaPizza. Para cada cobertura na entrada, envolva sua pizza com o decorator apropriado:
- "cheese" envolve com CheeseTopping
- "pepperoni" envolve com PepperoniTopping
- "mushroom" envolve com MushroomTopping
Depois de aplicar todas as coberturas, imprima a descrição e o preço finais 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 extra simplesmente significa envolver com CheeseTopping duas vezes. Essa flexibilidade é o poder do Padrão Decorator!

Experimente você mesmo

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

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

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

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

// TODO: Imprima o resultado no formato: [description] = $[price]
// Formate o preço com 2 casas decimais usando number_format()

?>