Паттерн проектирования Builder в Python
В этом уроке вы с помощью паттерна Builder построите сложный объект за несколько понятных шагов.
Введение
Какую задачу это решает
У некоторых объектов много необязательных частей: в отчёте может быть заголовок, график, таблица, подвал или любое их сочетание. Конструктор с десятью необязательными аргументами трудно читать и легко вызвать неправильно. Builder (строитель) добавляет части по одной, понятными шагами.
Пример из жизни
Builder похож на заказ сэндвича у стойки. Вы говорите «хлеб, потом сыр, потом помидор», и сэндвич растёт с каждой инструкцией. Когда вы говорите «готово», вам отдают законченный сэндвич.
ReportBuilder()🍞 Начать пустой заказ.add_title()🧀 Добавить один ингредиент.add_chart()🍅 Добавить ещё, порядок важен.build()🥪 Отдать готовый сэндвичШаблон Builder собирает сложный объект шаг за шагом с помощью отдельных методов, а готовый объект возвращает последний вызов build.
Главное
self.partsсобирает уже добавленные части.add_titleиadd_chartдобавляют по одной части и делаютreturn self, поэтому вызовы можно связывать в цепочку.ReportBuilder().add_title().add_chart().build()читается как список инструкций.build()превращает собранные части в готовый текст отчёта.
Когда это нужно?
- Объекты с множеством необязательных частей: отчёты, HTTP-запросы, SQL-запросы, документы.
- Понятное пошаговое создание объекта через цепочку методов.
- Создание разных вариантов одними и теми же шагами сборки.
Когда это не нужно
- Объекты с двумя-тремя обязательными полями: обычный конструктор или dataclass проще.
- Код на Python, где именованные аргументы со значениями по умолчанию уже делают вызов понятным.
Пример кода
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)
Результат выполнения
Report: title, chart
Разбор кода
Каждый метод, например add_title(), добавляет часть отчёта и возвращает сам объект builder (return self). Благодаря этому вызовы можно связывать в цепочку в одной строке. В конце метод build() собирает части и возвращает готовый отчёт Report: title, chart.
Измените значения и запустите программу в онлайн-компиляторе Python CodeUtility без локальной установки Python.
Упражнения для практики
Попробуйте изменить код по подсказкам ниже. Если менять код и смотреть на результат, урок запомнится гораздо лучше, чем при простом чтении.
- Замените предметную область примера, сохранив структуру паттерна.
- Сравните паттерн с более простой реализацией и объясните компромиссы.
- Напишите тесты для каждого участника перед добавлением новой реализации.
Частые ошибки
Забытый return self
Без return self цепочка ломается, потому что метод возвращает None.
def add_title(self):
self.parts.append("title")
def add_title(self):
self.parts.append("title")
return self
Закончили этот урок?
Отметьте его как изученный, чтобы следить за прогрессом.
Попрактикуйтесь на задаче
Примените материал этого урока к реальной задаче. Каждая задача запускается в браузере, с мгновенными тестами и разбором от ИИ.
Все задачи