Python-Entwurfsmuster

Das Entwurfsmuster Builder in Python

In dieser Lektion baust du mit dem Builder-Muster ein komplexes Objekt in klaren Schritten zusammen.

  • Profi
  • 3 Min. Lesezeit
  • 1 ausführbares Beispiel

Einführung

Das Problem

Manche Objekte haben viele optionale Teile: Ein Bericht kann einen Titel, ein Diagramm, eine Tabelle, eine Fußzeile oder jede Mischung davon haben. Ein Konstruktor mit zehn optionalen Argumenten ist schwer zu lesen und leicht falsch aufzurufen. Ein Builder fügt die Teile in klaren Einzelschritten hinzu.

Stell es dir so vor

Ein Builder ist wie eine Sandwichbestellung an der Theke. Du sagst „Brot, dann Käse, dann Tomate“, und das Sandwich wächst mit jeder Anweisung. Wenn du „fertig“ sagst, bekommst du das fertige Sandwich.

Von der Sandwichtheke zum Code
ReportBuilder()🍞 Eine leere Bestellung beginnen
.add_title()🧀 Eine Zutat hinzufügen
.add_chart()🍅 Noch eine, die Reihenfolge zählt
.build()🥪 Das fertige Sandwich übergeben
Füg die Teile hinzu, die du brauchst, und bau dann das Ergebnis.
In einem Satz

Das Builder-Muster baut ein komplexes Objekt Schritt für Schritt über einzelne Methoden auf und gibt das fertige Objekt mit einem abschließenden Aufruf von build zurück.

Das Wichtigste

  1. self.parts sammelt die bisher hinzugefügten Teile.
  2. add_title und add_chart fügen je einen Teil hinzu und machen return self, sodass sich Aufrufe verketten lassen.
  3. ReportBuilder().add_title().add_chart().build() liest sich wie eine Liste von Anweisungen.
  4. build() macht aus den gesammelten Teilen den fertigen Berichtstext.

Wann verwendet man das?

  • Objekte mit vielen optionalen Teilen: Berichte, HTTP-Requests, SQL-Abfragen, Dokumente.
  • Schrittweises Erzeugen mit Methodenverkettung lesbar machen.
  • Verschiedene Varianten mit denselben Bauschritten erzeugen.

Wann du es nicht brauchst

  • Objekte mit zwei oder drei Pflichtfeldern: Ein normaler Konstruktor oder eine Dataclass ist einfacher.
  • Python-Code, in dem Keyword-Argumente mit Standardwerten den Aufruf schon klar machen.

Beispielcode

Code ausführen →
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)
Run-Button für dieses Beispiel erstellen

Ergebnis der Ausführung

Report: title, chart

Erklärung des Codes

Jede Methode wie add_title() fügt dem Bericht einen Bestandteil hinzu und gibt das Builder-Objekt selbst zurück (return self). Dadurch lassen sich die Aufrufe in einer Zeile verketten. Zum Schluss setzt die Methode build() die Bestandteile zusammen und gibt den fertigen Bericht Report: title, chart zurück.

Ändere die Werte und führe das Programm im CodeUtility Python Online-Compiler aus, ohne Python lokal zu installieren.

Übungen zur Vertiefung

Ändere den Code anhand der folgenden Vorschläge. Wenn du selbst etwas änderst und das Ergebnis beobachtest, verstehst du viel mehr, als wenn du den Code nur liest.

  1. Ersetze die Beispieldomäne, ohne die Struktur des Patterns zu verändern.
  2. Vergleiche das Pattern mit einer einfacheren Implementierung und erläutere die Abwägungen.
  3. Schreibe Tests für jeden Beteiligten, bevor du eine weitere Implementierung hinzufügst.
Im Python-Compiler ausführen →

Häufige Fehler

return self vergessen

Ohne return self scheitert die Verkettung, weil die Methode None zurückgibt.

Problem
def add_title(self):
    self.parts.append("title")
Lösung
def add_title(self):
    self.parts.append("title")
    return self

Lektion fertig?

Markiere sie als gelernt, um deinen Fortschritt zu verfolgen.

Mit einer Challenge üben

Nutze den Inhalt dieser Lektion, um ein echtes Problem zu lösen. Jede Challenge läuft im Browser, mit sofortigen Tests und einem KI-Review.

Alle Challenges