Padrão de projeto Chain of Responsibility em Python
Nesta lição, você vai usar o padrão Chain of Responsibility para passar uma solicitação por uma cadeia de handlers até que um deles a assuma.
Introdução
O problema
Um pedido pode precisar ser tratado por uma de várias pessoas ou regras, conforme o tamanho ou o tipo: despesas pequenas pelo líder da equipe, maiores pelo gerente. Se o remetente decide no próprio código quem trata cada caso, as regras ficam rígidas.
Pense assim
O Chain of Responsibility é como um pedido de reembolso subindo na empresa. O líder da equipe assina qualquer valor até 100; um pedido maior vai para o gerente, que assina até 1000. O funcionário sempre entrega o pedido só para o líder e não precisa saber quem vai assinar no fim.
Approver("Lead", 100, ...)🧑 O líder da equipe: assina até 100if amount <= self.limit:✅ Está dentro do meu limite?self.next.approve(amount)⬆️ Não: passe para a próxima pessoa"Manager approved 500"🧑💼 O gerente assinaO padrão Chain of Responsibility passa um pedido por uma cadeia de tratadores até que um deles o trate. Assim, o remetente não precisa saber qual tratador vai responder.
Pontos-chave
- Cada
Approvertem umlimite um aprovadornextopcional. approvetrata o valor se ele estiver dentro deself.limit.- Senão, chama
self.next.approve(amount), passando o pedido adiante. - 500 passa do limite de 100 do Lead, então o Manager aprova; acima de 1000 o resultado seria
"Declined".
Quando usar?
- Fluxos de aprovação com limites crescentes.
- Escalonamento de suporte e roteamento de pedidos.
- Middleware em frameworks web, em que cada camada pode tratar ou repassar uma requisição.
Quando não é preciso
- Sempre se aplica exatamente um tratador: uma consulta direta é mais simples.
- Pedidos que precisam passar por todos os passos: isso é um pipeline, não uma cadeia.
Código de exemplo
class Approver:
# Chain of Responsibility: offer a request to handlers in order.
def __init__(self, name, limit, next_approver=None):
self.name, self.limit, self.next = name, limit, next_approver
def approve(self, amount):
# Handle locally or pass the request along the chain.
if amount <= self.limit:
return f"{self.name} approved {amount}"
if self.next:
return self.next.approve(amount)
return "Declined"
chain = Approver("Lead", 100, Approver("Manager", 1000))
print(chain.approve(500))
Resultado da execução
Manager approved 500
Explicação do código
Cada Approver tem um limite. O líder (Lead) só aprova até 100, então o valor de 500 passa para o próximo da cadeia, Manager, com limite de 1000. O Manager aprova a solicitação e o resultado é Manager approved 500. Se ninguém na cadeia puder aprovar, o resultado é Declined.
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
Esquecer o fim da cadeia
Sem uma verificação, o último tratador chama None.approve e o programa quebra.
return self.next.approve(amount)
if self.next:
return self.next.approve(amount)
return "Declined"
Terminou esta lição?
Marque como aprendida para acompanhar seu progresso.