Design pattern in Python

Il design pattern Builder in Python

In questa lezione userai il pattern Builder per costruire un oggetto complesso in passaggi chiari.

  • Avanzato
  • 3 min di lettura
  • 1 esempio eseguibile

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.

Dal banco dei panini al codice
ReportBuilder()🍞 Inizia un ordine vuoto
.add_title()🧀 Aggiungi un ingrediente
.add_chart()🍅 Aggiungine un altro: l'ordine conta
.build()🥪 Consegna il panino finito
Aggiungi le parti che ti servono, poi costruisci il risultato.
In una frase

Il 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

  1. self.parts raccoglie le parti aggiunte finora.
  2. add_title e add_chart aggiungono ciascuno una parte e fanno return self, così le chiamate si possono concatenare.
  3. ReportBuilder().add_title().add_chart().build() si legge come una lista di istruzioni.
  4. 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

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

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.

  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 return self

Senza return self, la concatenazione fallisce perché il metodo restituisce None.

Problema
def add_title(self):
    self.parts.append("title")
Correzione
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