Padrões de projeto em Python

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.

  • Avançado
  • 2 min de leitura
  • 1 exemplo executável

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.

Do pedido de reembolso ao código
Approver("Lead", 100, ...)🧑 O líder da equipe: assina até 100
if 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 assina
Cada tratador resolve o pedido ou o passa adiante.
Em uma frase

O 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

  1. Cada Approver tem um limit e um aprovador next opcional.
  2. approve trata o valor se ele estiver dentro de self.limit.
  3. Senão, chama self.next.approve(amount), passando o pedido adiante.
  4. 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

Executar código →
main.py
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))
Gerar um botão Run para este exemplo

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.

  1. Substitua o domínio do exemplo preservando a estrutura do padrão.
  2. Compare o padrão com uma implementação mais simples e explique as diferenças.
  3. Escreva testes para cada participante antes de adicionar outra implementação.
Executar no compilador Python →

Erros comuns

Esquecer o fim da cadeia

Sem uma verificação, o último tratador chama None.approve e o programa quebra.

Problema
return self.next.approve(amount)
Correção
if self.next:
    return self.next.approve(amount)
return "Declined"

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.