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.
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.
gateway.pay(25)🔌 Seu plugue: pagar em dólaresPaymentAdapter🔁 O adaptador de viagem no meioround(dollars * 100)💱 Converter dólares em centavosmake_payment(cents)🧱 A tomada antiga: quer centavosO 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
LegacyGatewaysó oferecemake_payment(cents).PaymentAdapteroferecepay(dollars), o método que o resto do programa quer chamar.round(dollars * 100)converte dólares em centavos antes de chamarmake_payment.gateway.pay(25)funciona sem mudar nada emLegacyGateway.
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
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))
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.
- 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 de converter os valores
Só renomear o método manda dólares onde se esperam centavos.
def pay(self, dollars):
return self.gateway.make_payment(dollars)
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