Il design pattern Builder in Python
In questa lezione userai il pattern Builder per costruire un oggetto complesso in passaggi chiari.
Introduzione
Il problema
Alcuni oggetti hanno molte parti opzionali: un report può avere un titolo, un grafico, una tabella, un piè di pagina, o qualsiasi combinazione. Un costruttore con dieci argomenti opzionali è difficile da leggere e facile da chiamare male. Un builder aggiunge le parti un passo alla volta, in modo chiaro.
Immaginalo così
Un builder è come ordinare un panino al banco. Chiedi pane, poi formaggio, poi pomodoro, e il panino cresce a ogni richiesta. Quando dici che hai finito, ricevi il panino pronto.
ReportBuilder()🍞 Inizia un ordine vuoto.add_title()🧀 Aggiungi un ingrediente.add_chart()🍅 Aggiungine un altro: l'ordine conta.build()🥪 Consegna il panino finitoIl pattern Builder costruisce un oggetto complesso passo dopo passo tramite metodi separati, poi restituisce l'oggetto finito con una chiamata finale a build.
Punti chiave
self.partsraccoglie le parti aggiunte finora.add_titleeadd_chartaggiungono ciascuno una parte e fannoreturn self, così le chiamate si possono concatenare.ReportBuilder().add_title().add_chart().build()si legge come una lista di istruzioni.build()trasforma le parti raccolte nel testo del report finito.
Quando si usa?
- Oggetti con molte parti opzionali: report, richieste HTTP, query SQL, documenti.
- Rendere leggibile una costruzione passo dopo passo con la concatenazione dei metodi.
- Creare varianti diverse con gli stessi passi di costruzione.
Quando non serve
- Oggetti con due o tre campi obbligatori: un costruttore normale o una dataclass è più semplice.
- Codice Python in cui gli argomenti con nome e valori predefiniti rendono già chiara la chiamata.
Codice di esempio
class ReportBuilder:
# Builder: assemble a complex value one optional part at a time.
def __init__(self):
self.parts = []
def add_title(self):
self.parts.append("title")
return self
def add_chart(self):
self.parts.append("chart")
return self
def build(self):
# Hide the final assembly behind one operation.
return "Report: " + ", ".join(self.parts)
report = ReportBuilder().add_title().add_chart().build()
print(report)
Risultato dell'esecuzione
Report: title, chart
Spiegazione del codice
Ogni metodo, come add_title(), aggiunge una parte al report e restituisce l'oggetto builder stesso (return self). Così le chiamate si possono concatenare sulla stessa riga. Alla fine, il metodo build() unisce le parti e restituisce il report completo, Report: title, chart.
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 return self
Senza return self, la concatenazione fallisce perché il metodo restituisce None.
def add_title(self):
self.parts.append("title")
def add_title(self):
self.parts.append("title")
return 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