Padrão de projeto Decorator em Python
Nesta lição, você vai usar o padrão Decorator para adicionar funcionalidades a um objeto sem alterar a sua classe.
Introdução
O problema
Você quer acrescentar um comportamento a um objeto, como log, formatação ou cache, sem mudar a classe dele e sem criar uma subclasse para cada combinação de extras.
Pense assim
O padrão Decorator é como embrulhar um presente. O presente continua o mesmo; cada camada de embrulho acrescenta algo, como papel, depois uma fita, depois um cartão. Você pode pôr as camadas em qualquer ordem, e o resultado ainda é um presente entregue do mesmo jeito.
Message()🎁 O presente originalUppercase(...)🧻 Uma camada que muda a aparênciaLogger(...)🎀 Outra camada por cima.render()🤲 Entregue do mesmo jeito: LOG: HELLOO padrão Decorator envolve um objeto em outro objeto com a mesma interface, que chama o objeto envolvido e acrescenta comportamento antes ou depois.
Pontos-chave
Message.render()devolve"hello".Uppercaseguarda o objeto envolvido e devolve o resultado dele em letras maiúsculas.Loggercoloca"LOG: "na frente do resultado do objeto envolvido.Logger(Uppercase(Message())).render()empilha os dois embrulhos e dá"LOG: HELLO".
Quando usar?
- Acrescentar log, cache, validação ou formatação em volta de objetos existentes.
- Combinar extras opcionais sem uma subclasse para cada combinação.
- Entender a sintaxe
@decoratordo Python, que aplica a mesma ideia a funções.
Quando não é preciso
- Só é preciso um comportamento extra fixo: mude a classe ou adicione um método.
- Muitas camadas que dependem da ordem umas das outras: a pilha fica difícil de entender.
Código de exemplo
class Message:
# Decorator: wrap an object to add behavior dynamically.
def render(self): return "hello"
class Uppercase:
def __init__(self, wrapped): self.wrapped = wrapped
def render(self): return self.wrapped.render().upper()
class Logger:
def __init__(self, wrapped): self.wrapped = wrapped
def render(self):
# Add behavior while preserving the render interface.
return "LOG: " + self.wrapped.render()
print(Logger(Uppercase(Message())).render())
Resultado da execução
LOG: HELLO
Explicação do código
Uppercase envolve o objeto Message e converte o resultado para maiúsculas, e depois Logger envolve Uppercase e adiciona o prefixo LOG:. As três classes têm o método render(), então podem se envolver em qualquer ordem. O resultado final é LOG: HELLO.
Altere os valores e execute o programa no compilador Python online CodeUtility sem instalar Python.
Exercícios práticos
Tente modificar o código seguindo as sugestões abaixo. Mudar o código e observar o resultado ajuda você a entender muito mais do que só ler.
- Substitua o domínio do exemplo preservando a estrutura do padrão.
- Compare o padrão com uma implementação mais simples e explique as diferenças.
- Escreva testes para cada participante antes de adicionar outra implementação.
Erros comuns
Quebrar a interface comum
Um embrulho com outro nome de método não pode ser embrulhado de novo nem usado no lugar do original.
class Uppercase:
def show(self): ...
class Uppercase:
def render(self): ...
Terminou esta lição?
Marque como aprendida para acompanhar seu progresso.
Pratique com um desafio
Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.
Todos os desafios