Czytaj książkę: «Строитель. Паттерн GoF на Python, C++23, Rust и Java»
Введение
Эта книга посвящена одному паттерну проектирования — Строитель (Builder). Он относится к каталогу «Банды четырёх» (Gang of Four, GoF). Здесь паттерн разобран сразу в четырёх реализациях: на Python, C++23, Rust и Java. Каждая реализация — отдельная часть книги: сначала задача и общая схема, затем код, модификации, гибридные варианты и самостоятельные работы.
Как читать
Основы каждого языка здесь не повторяются: они собраны в книгах серий по соответствующему языку. Разделы каждой части нумеруются заново, поэтому ссылка «раздел 1.2» указывает на раздел той же части, где она сделана.
Глава 2. Реализация на Python
2.1. Зачем нужен строитель
HTTP-запрос — это метод, адрес, заголовки, тело, тайм-аут, число повторов. Большая часть параметров необязательна. В Python эту задачу частично решают именованные аргументы и значения по умолчанию: Request(«GET», url, timeout=5) читается хорошо. Но у них есть пределы. Если объект собирается по шагам (сначала заголовки, потом тело, потом условия), если шаги зависят от условий, если результат нужно проверить целиком или получить в разных представлениях — нужен строитель.
Строитель отделяет процесс сборки от готового объекта. Вспомогательный объект накапливает параметры, а метод build() проверяет их и возвращает готовый, обычно неизменяемый результат. В стандартной библиотеке Python так устроены, например, argparse.ArgumentParser (по шагам добавляются аргументы, затем разбор), email.message.EmailMessage и построители SQL-запросов в популярных библиотеках.
2.2. Участники и схема

Builder — интерфейс шагов сборки.
ConcreteBuilder — реализация шагов для одного представления продукта.
Director — необязательный участник, знающий порядок шагов.
Product — готовый объект.
2.3. Когда применять и какие последствия
Строитель уместен, когда объект собирается по шагам, шаги зависят от условий, итог нужно проверить целиком, а готовый объект должен быть неизменяемым — или когда один процесс сборки даёт разные представления (HTML, Markdown, PDF).
Если параметров немного и все известны сразу, строитель не нужен: в Python для этого есть именованные аргументы и dataclass.
2.4. Классическая реализация: директор и два представления
Файл 01_director.py :

Листинг 2.1 — Классическая реализация: директор и два представления

Листинг 2.1 (продолжение) — Классическая реализация: директор и два представления
Разбор. Директор monthly_report описывает структуру отчёта один раз; строители превращают её в конкретный формат. Чтобы добавить формат PDF, нужен один новый строитель, а директор не меняется. Внутреннее состояние строителя — список _parts; подчёркивание в имени говорит, что это деталь реализации.
2.5. Текучий строитель с проверкой
Самая распространённая форма — «текучий» (fluent) строитель: каждый шаг возвращает self, поэтому вызовы складываются в цепочку, а build() проверяет данные и возвращает неизменяемый результат.
Файл 02_fluent.py :

Листинг 2.2 — Текучий строитель с проверкой

Листинг 2.2 (продолжение) — Текучий строитель с проверкой

Листинг 2.2 (продолжение) — Текучий строитель с проверкой
Разбор. Шаги возвращают self, и аннотация Self (Python 3.11+) говорит анализатору типов, что результат — тот же строитель, даже в подклассах. Цепочка в скобках позволяет переносить вызовы на новые строки без обратной косой черты.
build() проверяет условия, которые нельзя проверить отдельными шагами: например, что у GET нет тела. Готовый Request — неизменяемый dataclass, а заголовки обёрнуты в MappingProxyType — словарь только для чтения. Без этого frozen=True защищал бы лишь сам атрибут headers, но не содержимое словаря. Копия dict(self._headers) отвязывает результат от строителя: последующие вызовы header() на том же строителе не изменят уже собранный запрос.
2.6. Строитель или именованные аргументы
В Python часто лучше обойтись без строителя. Сравним.
Файл 03_kwargs.py :

Листинг 2.3 — Строитель или именованные аргументы
Разбор. kw_only=True запрещает позиционные аргументы — нельзя случайно перепутать ширину и высоту. Значения по умолчанию заменяют необязательные шаги строителя, __post_init__ — проверку в build(), а dataclasses.replace создаёт копию с изменёнными полями, как строитель, начатый от готового объекта.
Правило выбора: если все параметры известны в момент создания — именованные аргументы и dataclass. Если объект собирается постепенно, по условиям, из разных частей программы или в разных представлениях — строитель.
2.7. Модификации паттерна
Строитель составного объекта
Строитель удобен для деревьев: меню с подменю, документов с разделами. Вложенность хорошо выражается контекстными менеджерами.
Файл 04_nested.py :

Листинг 2.4 — Модификации паттерна

Листинг 2.4 (продолжение) — Модификации паттерна
Разбор. Строитель хранит стек открытых подменю. with m.submenu(…) кладёт новое подменю на стек, а при выходе из блока — снимает его, даже если внутри произошло исключение (finally). Вложенность кода совпадает с вложенностью меню. @contextmanager превращает генератор с одним yield в контекстный менеджер.
Строитель SQL-запроса
Файл 05_sql.py :

Листинг 2.5 — Модификации паттерна

Листинг 2.5 (продолжение) — Модификации паттерна
Разбор. Строитель показывает силу постепенной сборки: условия добавляются только если параметры заданы. Значения не вставляются в текст SQL, а возвращаются отдельно, чтобы драйвер базы подставил их безопасно, — так строитель защищает от SQL-инъекций. *cols принимает любое число колонок.
2.8. Гибриды и конкурентность
Строитель конфигурации пула потоков
Файл 06_pool.py :

Листинг 2.6 — Гибриды и конкурентность

Листинг 2.6 (продолжение) — Гибриды и конкурентность
Разбор. Строитель прячет за понятными шагами параметры ThreadPoolExecutor и добавляет свою проверку. Функция on_start выполняется в каждом новом потоке пула при его запуске — здесь она запоминает имя потока. Выход из блока with pool дожидается завершения всех задач.
2.9. Самостоятельные работы
Работа 1. Строитель пиццы
Задание. Размер обязателен, основа по умолчанию тонкая, добавок не больше пяти и без повторов. build() возвращает неизменяемую пиццу или выбрасывает понятное исключение. Цена: размер даёт основу, каждая добавка +50 ₽.
Полное решение — файл 07_pizza.py :

Листинг 2.7 — Самостоятельные работы

Листинг 2.7 (продолжение) — Самостоятельные работы
Разбор. Собственный класс исключения PizzaError наследует ValueError: вызывающий код может ловить и конкретную ошибку пиццы, и любую ошибку значения. frozenset в готовой пицце неизменяем — набор добавок нельзя поменять после сборки. Цена — свойство: она вычисляется из данных, а не хранится отдельно. Значения перечисления Size сразу служат базовой ценой.
2.10. Типичные ошибки
Строитель вместо именованных аргументов. Если все параметры известны сразу, dataclass с kw_only=True проще.
Изменяемый результат. Если build() возвращает объект, разделяющий список или словарь со строителем, последующие шаги изменят уже готовый объект. Копируйте данные.
Отсутствие проверки в build(). Строитель без проверки целостности теряет половину смысла.
Незакрытые вложенные шаги. Строитель дерева должен проверять, что все уровни закрыты; контекстные менеджеры делают это надёжно.
2.11. Вопросы для самопроверки
Когда в Python достаточно именованных аргументов, а когда нужен строитель?
Зачем шаги текучего строителя возвращают self и что даёт аннотация Self?
Почему frozen=True не защищает словарь заголовков и как это исправить?
Зачем build() копирует заголовки в новый словарь?
Что делает kw_only=True и чем он полезен?
Как dataclasses.replace заменяет строитель?
Как контекстный менеджер помогает строить вложенные структуры?
Почему строитель SQL возвращает значения отдельно от текста запроса?
2.12. Ответы
Именованных аргументов достаточно, когда все параметры известны в момент создания. Строитель нужен для постепенной, условной сборки, проверки целого и разных представлений.
Чтобы вызывать шаги цепочкой. Self сообщает анализатору типов, что возвращается тот же класс, в том числе в подклассах.
frozen=True запрещает переприсваивать атрибут, но не менять содержимое словаря. Помогает MappingProxyType — представление только для чтения.
Чтобы готовый запрос не зависел от строителя: последующие шаги не изменят уже собранный объект.
Запрещает позиционные аргументы, исключая путаницу между параметрами одного типа.
Создаёт копию готового объекта с изменёнными полями — как сборка от образца.
Вход в блок открывает уровень, выход закрывает его, в том числе при исключении.
Чтобы драйвер базы подставил значения безопасно и исключил SQL-инъекции.
Глава 2. Реализация на C++23
2.1. Зачем нужна абстрактная фабрика
В первой главе мы рассмотрели фабричный метод: общий алгоритм создателя получает продукт через переопределяемую операцию. Теперь представим другую задачу. Приложению нужно создать не один продукт, а несколько взаимосвязанных продуктов, которые должны работать вместе.
Например, пользователь выбирает светлую или тёмную тему. Для каждой темы нужны кнопка и флажок. Если разные части программы выбирают их независимо, можно случайно показать светлую кнопку рядом с тёмным флажком. Иногда смешение тем допустимо, но в этой задаче нам нужно единое оформление.
Абстрактная фабрика предоставляет интерфейс для создания целого семейства связанных продуктов. Конкретная фабрика знает, как создавать продукты выбранного семейства; клиент получает их через общие интерфейсы и не привязывается к конкретным классам кнопки и флажка.
Паттерн входит в группу порождающих паттернов GoF. Авторы GoF систематизировали способы выделять изменяющиеся решения из прикладной логики. Здесь изменяется семейство компонентов, а интерфейс работы с ними остаётся общим.
Программирование на уровне интерфейсов не означает отказ от конкретных классов: где-то приложение всё равно выбирает LightFactory или DarkFactory. Цель в том, чтобы этот выбор не повторялся в каждом клиентском алгоритме.
2.2. Проблема и контекст
Пусть требуется поддержать два вида продуктов: Button и Checkbox. Каждому нужны две реализации: для светлой и тёмной темы. Прямое создание LightButton в одном месте и DarkCheckbox в другом распространяет знание о теме по приложению.
Создадим UIFactory с двумя операциями: create_button() и create_checkbox(). LightFactory реализует обе операции для светлой темы, а DarkFactory — для тёмной. Клиент получает одну фабрику и создаёт компоненты через неё.
Совместимость обеспечивается контрактом реализации и способом использования, а не волшебным свойством имени паттерна. Если конкретная фабрика ошибочно вернёт кнопку одной темы и флажок другой либо клиент намеренно смешает продукты двух фабрик, обычные базовые интерфейсы C++ этого не запретят. Более сильную гарантию можно выразить типами, дополнительной проверкой или другими ограничениями проекта.
2.3. Участники и UML-диаграмма
AbstractFactory объявляет операции создания разных видов продуктов.
ConcreteFactory реализует эти операции для одного семейства.
AbstractProductA и AbstractProductB задают интерфейсы разных видов продуктов.
ConcreteProductA и ConcreteProductB реализуют продукт соответствующего семейства.
Клиент получает фабрику и работает с продуктами через их интерфейсы.

В полной модели LightButton и DarkButton реализуют Button, а LightCheckbox и DarkCheckbox — Checkbox. Конкретная фабрика связывает по одной реализации каждого вида в семейство.
2.4. Применимость и последствия
Абстрактная фабрика полезна, когда клиенту нужен комплект взаимосвязанных объектов, набор нужно целиком подменять, а прикладной алгоритм не должен зависеть от конкретного семейства. Например, это может быть набор компонентов оформления, тестовых сервисов или кроссплатформенных ресурсов.
Плюсы: общий выбор семейства находится в одном месте; легче подменять семейство при тестировании; клиент работает с интерфейсами; детали создания можно скрыть за фабрикой.
Минусы: появляется больше интерфейсов и реализаций; добавление нового вида продукта, например меню, обычно требует расширить интерфейс фабрики и обновить каждую конкретную фабрику; совместимость зависит от корректности конкретной фабрики; при небольшом фиксированном наборе объектов простой конструктор может оказаться понятнее.
Сравнение с Factory Method. Фабричный метод выделяет переопределяемую операцию создания продукта в создателе. Абстрактная фабрика предоставляет несколько операций создания согласованных продуктов. Для реализации каждой операции абстрактной фабрики при необходимости можно использовать фабричный метод.
Сравнение с Builder. Абстрактная фабрика отвечает на вопрос, какое семейство продуктов создать. Builder организует пошаговое построение сложного результата. Строитель может использовать фабрику при сборке.
2.5. Классический пример: светлая и тёмная темы
Программа ниже полностью самостоятельна. Каждый продукт имеет виртуальный деструктор, потому что уничтожается через std::unique_ptr на базовый интерфейс. Фабрика возвращает каждый продукт с явной передачей единоличного владения.

Листинг 2.1 — Классический пример: светлая и тёмная темы

Листинг 2.1 (продолжение) — Классический пример: светлая и тёмная темы
Разбор. Button и Checkbox представляют два разных вида продуктов. Их виртуальные деструкторы позволяют безопасно уничтожать конкретные объекты через базовый тип. LightFactory создаёт светлую пару, а DarkFactory — тёмную. Метод draw_dialog получает фабрику по ссылке и не владеет ею; каждая возвращённая умная указательная переменная владеет своим продуктом.
std::make_unique создаёт конкретный продукт; преобразование при возврате передаёт владение в unique_ptr на соответствующий базовый интерфейс. Когда локальные указатели в draw_dialog уничтожаются, их продукты также уничтожаются. При исключении во время создания второго продукта первый уже находится в unique_ptr, поэтому его ресурс освобождается при раскрутке стека.
В main фабрики существуют дольше вызовов draw_dialog. Клиент получает весь комплект от одной фабрики. Программа демонстрирует архитектуру текстовым выводом и не создаёт настоящие окна операционной системы.
Вывод:

2.6. Модифицированные версии и связанные приёмы
Ниже сохранены восемь направлений из оглавления. Некоторые из них являются комбинациями паттернов или способами организации создания, а не отдельными каноническими вариантами GoF. Полные решения практических задач для каждого направления находятся в разделе 2.8.
1. Classic GoF Abstract Factory — классическая фабрика семейств
Базовая фабрика объявляет отдельный метод для каждого вида продукта. Конкретная фабрика обеспечивает согласованный набор реализаций. Пример UIFactory уже показан выше: кнопка и флажок создаются одной фабрикой.
Такой интерфейс хорошо выражает фиксированный набор продуктов и позволяет клиенту получать типизированные результаты. Добавить новую тему сравнительно просто: нужна новая конкретная фабрика и её продукты. Добавить новый вид продукта сложнее, потому что нужно изменить интерфейс и все реализации. Практическое задание 2 повторяет этот сценарий для светлой и тёмной тем.
2. Prototype-Based Abstract Factory / Kit — фабрика на прототипах
Фабрика хранит по образцу каждого вида продукта. Когда клиент просит дерево или здание, фабрика вызывает clone() нужного образца. Подменяя набор образцов при создании фабрики, можно менять семейство без отдельного подкласса самой фабрики для каждого набора.
Правила копирования определяются продуктом. Если у образца есть указатели, файл или граф объектов, необходимо отдельно решить, что копируется глубоко, что разделяется и как обрабатываются циклы. В работе 3 строки копируются значением, поэтому полученные объекты независимы.
3. Extensible / Parameterized Abstract Factory — параметризованная фабрика
Один метод принимает идентификатор вида продукта, например перечисление, и создаёт соответствующий результат. Это снижает число именованных методов в базовом интерфейсе. Неизвестный идентификатор должен приводить к определённому результату ошибки.
Гибкость оплачивается потерей точного типа в месте вызова, если все продукты возвращаются через один общий интерфейс, и дополнительным разбором идентификатора. Параметрическая простая фабрика сама по себе не всегда представляет семейство в смысле GoF: для этого ещё нужно определить, как её конфигурация связывает совместимые продукты. Работа 4 показывает выбор аудиообработчиков и это ограничение.
4. Type-Safe Heterogeneous Container Factory — типизированный гетерогенный реестр
Реестр может хранить фабрики разных возвращаемых типов под ключом std::type_index. При регистрации шаблонная функция формирует согласованную пару «тип продукта — функция создания». std::any хранит функции разных типов, а std::any_cast проверяет ожидаемый тип при извлечении.
Шаблонный интерфейс ограничивает типы и уменьшает число небезопасных приведений в клиентском коде. При этом сам std::any и наличие записи проверяются во время выполнения: нельзя утверждать, что вся система целиком статически проверена. Работа 5 демонстрирует реестр протоколов и сообщение об отсутствующей регистрации.
Darmowy fragment się skończył.