Padrões de projeto em Python

Padrão de projeto Adapter em Python

Nesta lição, você vai usar o padrão Adapter para conectar uma classe antiga, com outra interface, ao código que espera uma interface nova.

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

Introdução

O problema

Muitas vezes você precisa usar um código que não pode alterar, como um sistema de pagamento antigo ou uma biblioteca de terceiros. Só que os métodos dele não batem com o que o resto do programa espera. Reescrever cada chamada é arriscado. Um adapter traduz entre os dois.

Pense assim

Um adapter é como um adaptador de tomada para viagem. O plugue do seu notebook encaixa nas tomadas de casa, mas as do hotel têm outro formato. O adaptador fica no meio, assim nem o notebook nem a parede precisam mudar.

Do adaptador de tomada ao código
gateway.pay(25)🔌 Seu plugue: pagar em dólares
PaymentAdapter🔁 O adaptador de viagem no meio
round(dollars * 100)💱 Converter dólares em centavos
make_payment(cents)🧱 A tomada antiga: quer centavos
O adapter traduz a chamada, e nenhum dos lados precisa mudar.
Em uma frase

O padrão Adapter envolve um objeto de interface incompatível numa classe que oferece a interface que o cliente espera e traduz cada chamada.

Pontos-chave

  1. LegacyGateway só oferece make_payment(cents).
  2. PaymentAdapter oferece pay(dollars), o método que o resto do programa quer chamar.
  3. round(dollars * 100) converte dólares em centavos antes de chamar make_payment.
  4. gateway.pay(25) funciona sem mudar nada em LegacyGateway.

Quando usar?

  • Usar código antigo ou de terceiros por trás da interface que o seu programa espera.
  • Trocar de fornecedor, como serviços de pagamento ou e-mail, sem mudar quem chama.
  • Converter unidades ou formatos de dados na fronteira.

Quando não é preciso

  • Os dois lados são seus e você pode simplesmente renomear ou mudar um deles.
  • As interfaces são tão diferentes que o adapter teria a maior parte da lógica: redesenhe a fronteira.

Código de exemplo

Executar código →
main.py
class LegacyGateway:
    # Adapter: wrap an incompatible API with the expected interface.
    def make_payment(self, cents):
        return f"PAY {cents / 100:.2f}"


class PaymentAdapter:
    def __init__(self, gateway):
        self.gateway = gateway

    def pay(self, dollars):
        # Translate both the method name and amount format.
        return self.gateway.make_payment(round(dollars * 100))


gateway = PaymentAdapter(LegacyGateway())
print(gateway.pay(25))
Gerar um botão Run para este exemplo

Resultado da execução

PAY 25.00

Explicação do código

A classe LegacyGateway só tem o método make_payment(), que recebe o valor em centavos, enquanto o código novo quer chamar pay(). A classe PaymentAdapter envolve LegacyGateway e transforma a chamada pay() em make_payment() com a unidade correta, por isso o resultado é PAY 25.00.

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 de converter os valores

Só renomear o método manda dólares onde se esperam centavos.

Problema
def pay(self, dollars):
    return self.gateway.make_payment(dollars)
Correção
def pay(self, dollars):
    return self.gateway.make_payment(round(dollars * 100))

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