Il design pattern Adapter in Python
In questa lezione userai il pattern Adapter per collegare una vecchia classe, con un'interfaccia diversa, al codice che si aspetta un'interfaccia nuova.
Introduzione
Il problema
Spesso devi usare codice che non puoi cambiare, come un vecchio sistema di pagamento o una libreria di terze parti, i cui metodi non corrispondono a ciò che si aspetta il resto del programma. Riscrivere ogni chiamante è rischioso. Un adapter traduce tra i due.
Immaginalo così
Un adapter è come un adattatore per prese da viaggio. La spina del tuo portatile entra nelle prese di casa, e le prese dell'hotel hanno una forma diversa. L'adattatore sta in mezzo, così né il portatile né il muro devono cambiare.
gateway.pay(25)🔌 La tua spina: paga in dollariPaymentAdapter🔁 L'adattatore da viaggio in mezzoround(dollars * 100)💱 Converti i dollari in centesimimake_payment(cents)🧱 La vecchia presa: vuole centesimiIl pattern Adapter avvolge un oggetto con un'interfaccia incompatibile in una classe che offre l'interfaccia che si aspetta il client e traduce ogni chiamata.
Punti chiave
LegacyGatewayoffre solomake_payment(cents).PaymentAdapteroffrepay(dollars), il metodo che il resto del programma vuole chiamare.round(dollars * 100)converte i dollari in centesimi prima di chiamaremake_payment.gateway.pay(25)funziona senza cambiare per nienteLegacyGateway.
Quando si usa?
- Usare codice vecchio o di terze parti dietro l'interfaccia che si aspetta il tuo programma.
- Passare da un fornitore all'altro, come servizi di pagamento o email, senza cambiare i chiamanti.
- Convertire unità o formati di dati al confine.
Quando non serve
- Possiedi entrambi i lati e puoi semplicemente rinominarne o cambiarne uno.
- Le interfacce sono così diverse che l'adapter conterrebbe gran parte della logica: riprogetta invece il confine.
Codice di esempio
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))
Risultato dell'esecuzione
PAY 25.00
Spiegazione del codice
La classe LegacyGateway ha solo il metodo make_payment(), che riceve l'importo in centesimi, mentre il codice nuovo vuole chiamare pay(). La classe PaymentAdapter avvolge LegacyGateway e trasforma la chiamata pay() in make_payment() con l'unità corretta, per questo il risultato è PAY 25.00.
Modifica i valori ed esegui il programma nel compilatore Python online CodeUtility senza installare Python.
Esercizi di approfondimento
Prova a modificare il codice seguendo i suggerimenti qui sotto. Cambiare il codice e osservare il risultato ti aiuta a capire molto più che leggerlo soltanto.
- Sostituisci il dominio di esempio mantenendo la struttura del pattern.
- Confronta il pattern con un’implementazione più semplice e spiegane i compromessi.
- Scrivi test per ogni partecipante prima di aggiungere un’altra implementazione.
Errori comuni
Dimenticare di convertire i valori
Rinominare solo il metodo manda dollari dove servono centesimi.
def pay(self, dollars):
return self.gateway.make_payment(dollars)
def pay(self, dollars):
return self.gateway.make_payment(round(dollars * 100))
Hai finito questa lezione?
Segnala come imparata per tenere traccia dei tuoi progressi.
Esercitati con una sfida
Usa ciò che questa lezione spiega per risolvere un problema reale. Ogni sfida gira nel browser, con test immediati e una revisione dell'IA.
Tutte le sfide