Design pattern in Python

Il design pattern Visitor in Python

In questa lezione userai il pattern Visitor per aggiungere nuove operazioni a un gruppo di oggetti senza modificarne le classi.

  • Avanzato
  • 3 min di lettura
  • 1 esempio eseguibile

Introduzione

Il problema

Hai un insieme stabile di classi, come forme o prodotti, e continui ad aggiungere nuove operazioni: prezzo totale, tasse, esportazione in JSON. Aggiungere ogni operazione come metodo in ogni classe sparpaglia una funzionalità in molti file.

Immaginalo così

Il pattern Visitor è come un ispettore fiscale che visita negozi diversi. Ogni negozio fa semplicemente entrare l'ispettore e dice che tipo di negozio è. L'ispettore porta con sé le regole per ogni tipo di negozio, quindi nuove regole significano un nuovo ispettore, non modifiche a ogni negozio.

Dall'ispettore fiscale al codice
item.accept(visitor)🚪 Il negozio fa entrare l'ispettore
visitor.visit_book(self)🏷️ Dice che tipo di negozio è
PriceVisitor🧾 L'ispettore con le regole
15💰 Il totale per un libro e un film
L'operazione vive nel visitor, non nelle classi degli elementi.
In una frase

Il pattern Visitor sposta un'operazione da un gruppo di classi di elementi a un oggetto visitor separato; ogni elemento chiama il metodo del visitor che corrisponde al suo tipo.

Punti chiave

  1. Book.accept chiama visitor.visit_book(self); Movie.accept chiama visitor.visit_movie(self).
  2. PriceVisitor contiene le regole di prezzo per entrambi i tipi.
  3. sum(item.accept(visitor) for item in [Book(), Movie()]) somma 10 e 5.
  4. Una nuova operazione, come le tasse, sarebbe una nuova classe visitor senza cambiare Book o Movie.

Quando si usa?

  • Molte operazioni su un insieme stabile di tipi: prezzi, esportazioni, disegno.
  • Percorrere strutture come gli alberi sintattici nei compilatori.
  • Tenere il codice di una funzionalità in un solo posto.

Quando non serve

  • Si aggiungono spesso nuovi tipi di elementi: ogni visitor va allora aggiornato.
  • Codice Python in cui un dizionario di funzioni per tipo o functools.singledispatch è più semplice.

Codice di esempio

Esegui codice →
main.py
class Book:
    # Visitor: move new operations outside stable element classes.
    def accept(self, visitor): return visitor.visit_book(self)


class Movie:
    def accept(self, visitor): return visitor.visit_movie(self)


class PriceVisitor:
    def visit_book(self, book): return 10
    def visit_movie(self, movie): return 5


# Each element dispatches to the matching visitor method.
visitor = PriceVisitor()
print(sum(item.accept(visitor) for item in [Book(), Movie()]))
Crea un pulsante Run per questo esempio

Risultato dell'esecuzione

15

Spiegazione del codice

Ogni elemento ha il metodo accept(), che chiama il metodo corrispondente del visitor: Book chiama visit_book() e Movie chiama visit_movie(). PriceVisitor contiene tutta la logica dei prezzi, quindi le classi Book e Movie non devono sapere nulla dei prezzi. Il totale è 10 + 5 = 15.

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

Chiamare il metodo sbagliato del visitor

Un elemento deve chiamare il metodo per il suo tipo, altrimenti riceve le regole sbagliate.

Problema
class Movie:
    def accept(self, visitor): return visitor.visit_book(self)
Correzione
class Movie:
    def accept(self, visitor): return visitor.visit_movie(self)

Hai finito questa lezione?

Segnala come imparata per tenere traccia dei tuoi progressi.