Design pattern in Python

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.

  • Avanzato
  • 2 min di lettura
  • 1 esempio eseguibile

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.

Dall'adattatore da viaggio al codice
gateway.pay(25)🔌 La tua spina: paga in dollari
PaymentAdapter🔁 L'adattatore da viaggio in mezzo
round(dollars * 100)💱 Converti i dollari in centesimi
make_payment(cents)🧱 La vecchia presa: vuole centesimi
L'adapter traduce la chiamata; nessuno dei due lati cambia.
In una frase

Il 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

  1. LegacyGateway offre solo make_payment(cents).
  2. PaymentAdapter offre pay(dollars), il metodo che il resto del programma vuole chiamare.
  3. round(dollars * 100) converte i dollari in centesimi prima di chiamare make_payment.
  4. gateway.pay(25) funziona senza cambiare per niente LegacyGateway.

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

Esegui codice →
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))
Crea un pulsante Run per questo esempio

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.

  1. Sostituisci il dominio di esempio mantenendo la struttura del pattern.
  2. Confronta il pattern con un’implementazione più semplice e spiegane i compromessi.
  3. Scrivi test per ogni partecipante prima di aggiungere un’altra implementazione.
Esegui nel compilatore Python →

Errori comuni

Dimenticare di convertire i valori

Rinominare solo il metodo manda dollari dove servono centesimi.

Problema
def pay(self, dollars):
    return self.gateway.make_payment(dollars)
Correzione
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