apps/patterns/decorator-pattern
010 · Padrões Fundamentais · ≈ 5 min de estudo
Acrescenta responsabilidades a um objeto em tempo de execução, por composição: cada decorador implementa a mesma interface, envolve o serviço e roda o próprio comportamento antes ou depois de delegar. Evita uma subclasse por combinação de logging, validação, auditoria e taxa.
Cenário
Um serviço de transferências grava cada transferência no PostgreSQL. Conforme o canal, a mesma operação ganha log, validação, trilha de auditoria (também no PostgreSQL) ou taxa de 2,5%, sem nenhuma subclasse: as combinações são montadas em tempo de execução.
Planta
Classes8 passos — reproduza para seguir o fluxo
Como funciona
6 passos
Empilha comportamento sem alterar a classe.
Esconde cada passo: lembre antes de tocar para revelar.
Vocabulário compartilhado
ContratoInterfacePaymentService.transfer(accountFromId, accountToId, amountCents)
Componente realServicePaymentPostgres insere a linha em transfers
DecoradoresValidação rejeita antes de chegar ao serviço; taxa soma a tarifa em centavos (basis points); auditoria grava cada tentativa em transfer_audit; logging registra início, fim e falha
Ordem de empilhamentoValidação mais interna, logging mais externo — o log registra até o erro de validação
TransparênciaNenhum decorador engole erro; auditoria e logging registram e relançam
Composição dinâmicaA mesma instância do serviço real é envolvida por pilhas diferentes no demo
apps/patterns/decorator-pattern
6 arquivossql/
transfers e transfer_auditsrc/
./
Executar · com Docker
./docker.sh up# sobe PostgreSQLcp .env.example .env# variáveis de ambientebun install# dependênciasbun run demo# roda o cenárioTestes: bun run test.
Por que se relacionam
Teste rápido
Qual destes combina com Decorator Pattern?
O kit envolve a chamada em camadas. Abrir Resilience Kit →
Seu progresso
0/179 estudados
Fica salvo só neste navegador.