Design pattern in Python

Il design pattern Decorator in Python

In questa lezione userai il pattern Decorator per aggiungere funzionalità a un oggetto senza modificarne la classe.

  • Avanzato
  • 3 min di lettura
  • 1 esempio eseguibile

Introduzione

Il problema

Vuoi aggiungere un comportamento in più a un oggetto, come logging, formattazione o cache, senza cambiare la sua classe e senza creare una sottoclasse per ogni combinazione di extra.

Immaginalo così

Il pattern Decorator è come incartare un regalo. Il regalo resta lo stesso, ma ogni strato aggiunge qualcosa: prima la carta, poi un nastro, poi un biglietto. Puoi aggiungere gli strati nell'ordine che vuoi e alla fine hai sempre un regalo, che consegni allo stesso modo.

Dall'incartare un regalo al codice
Message()🎁 Il regalo originale
Uppercase(...)🧻 Uno strato che cambia il suo aspetto
Logger(...)🎀 Un altro strato sopra
.render()🤲 Consegnato allo stesso modo: LOG: HELLO
Ogni involucro offre lo stesso metodo e aggiunge il suo comportamento.
In una frase

Il pattern Decorator avvolge un oggetto in un altro oggetto con la stessa interfaccia. Il nuovo oggetto chiama quello avvolto e aggiunge un comportamento prima o dopo.

Punti chiave

  1. Message.render() restituisce "hello".
  2. Uppercase tiene l'oggetto avvolto e restituisce il suo risultato in maiuscolo.
  3. Logger aggiunge "LOG: " davanti al risultato dell'oggetto avvolto.
  4. Logger(Uppercase(Message())).render() impila entrambi gli involucri, e dà "LOG: HELLO".

Quando si usa?

  • Aggiungere logging, cache, validazione o formattazione attorno a oggetti esistenti.
  • Combinare extra opzionali senza una sottoclasse per ogni combinazione.
  • Capire la sintassi @decorator di Python, che applica la stessa idea alle funzioni.

Quando non serve

  • Serve un solo comportamento extra fisso: cambia la classe o aggiungi un metodo.
  • Molti strati che funzionano solo in un certo ordine: la pila diventa difficile da capire.

Codice di esempio

Esegui codice →
main.py
class Message:
    # Decorator: wrap an object to add behavior dynamically.
    def render(self): return "hello"


class Uppercase:
    def __init__(self, wrapped): self.wrapped = wrapped
    def render(self): return self.wrapped.render().upper()


class Logger:
    def __init__(self, wrapped): self.wrapped = wrapped

    def render(self):
        # Add behavior while preserving the render interface.
        return "LOG: " + self.wrapped.render()


print(Logger(Uppercase(Message())).render())
Crea un pulsante Run per questo esempio

Risultato dell'esecuzione

LOG: HELLO

Spiegazione del codice

Uppercase avvolge l'oggetto Message e converte il risultato in maiuscolo, poi Logger avvolge Uppercase e aggiunge il prefisso LOG:. Tutte e tre le classi hanno il metodo render(), quindi possono avvolgersi a vicenda in qualsiasi ordine. Il risultato finale è LOG: HELLO.

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

Rompere l'interfaccia comune

Un involucro con un nome di metodo diverso non si può avvolgere di nuovo né usare al posto dell'originale.

Problema
class Uppercase:
    def show(self): ...
Correzione
class Uppercase:
    def render(self): ...

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