Czytaj książkę: «Фабричный метод. Паттерн GoF на Python, C++23, Rust и Java»
Введение
Эта книга посвящена одному паттерну проектирования — Фабричный метод (Factory Method). Он относится к каталогу «Банды четырёх» (Gang of Four, GoF). Здесь паттерн разобран сразу в четырёх реализациях: на Python, C++23, Rust и Java. Каждая реализация — отдельная часть книги: сначала задача и общая схема, затем код, модификации, гибридные варианты и самостоятельные работы.
Как читать
Основы каждого языка здесь не повторяются: они собраны в книгах серий по соответствующему языку. Разделы каждой части нумеруются заново, поэтому ссылка «раздел 1.2» указывает на раздел той же части, где она сделана.
Глава 3. Реализация на Python
3.1. Зачем нужен фабричный метод
Служба доставки сначала возит грузы только грузовиками, и общий алгоритм — принять заказ, подготовить транспорт, доставить, выписать счёт — прямо внутри создаёт Truck(). Потом появляется морская доставка. Если алгоритм сам создаёт конкретный транспорт, его придётся менять: добавлять ветвления и флаги.
Фабричный метод выделяет место создания в отдельную операцию. Общий алгоритм работает с абстрактным «транспортом» и в нужный момент вызывает метод create_transport(). Какой транспорт будет создан, решает подкласс. Сам алгоритм остаётся общим.
Суть паттерна — в связке: общий алгоритм + переопределяемый шаг создания, которым этот алгоритм пользуется. Любая функция с create в имени ещё не фабричный метод.
3.2. Участники и схема

Product — интерфейс продукта.
ConcreteProduct — конкретные продукты.
Creator — класс с фабричным методом и общим алгоритмом.
ConcreteCreator — переопределяет фабричный метод.
В Python у паттерна есть короткие альтернативы: передать класс продукта как параметр (классы — объекты), использовать classmethod как именованный конструктор или словарь-реестр. Все они разобраны ниже.
3.3. Когда применять и какие последствия
Паттерн уместен, когда общий алгоритм должен работать с продуктами, тип которых заранее неизвестен, а расширять систему нужно новыми подклассами, не трогая общий код. Особенно он полезен в библиотеках и каркасах: каркас вызывает фабричный метод, а пользователь подставляет свои продукты.
Минус — на каждый продукт часто нужен свой создатель. Если продукт выбирается по значению из конфигурации, удобнее простая фабрика или реестр.
3.4. Классическая реализация: логистика
Файл 01_classic.py :

Листинг 3.1 — Классическая реализация: логистика

Листинг 3.1 (продолжение) — Классическая реализация: логистика
Разбор. plan_delivery написан один раз в базовом классе. Подклассы переопределяют только create_transport. Абстрактное свойство cost_per_km подклассы реализуют простым атрибутом класса — Python считает это реализацией, потому что имя определено.
3.5. Класс как параметр
В Python класс — обычный объект, который можно передать в функцию или сохранить в атрибуте. Часто это заменяет иерархию создателей.
Файл 02_class_param.py :

Листинг 3.2 — Класс как параметр
Разбор. Атрибут класса transport_class играет роль фабричного метода: подклассу достаточно переопределить одну строку. Так устроены многие библиотеки: например, в стандартном socketserver класс обработчика запросов передаётся параметром, а в json.loads можно передать cls — класс декодера. Функция deliver_with идёт ещё дальше: класс и параметры конструктора передаются прямо в вызов.
3.6. Разновидности и связанные приёмы
Именованные конструкторы через classmethod
Файл 03_classmethod.py :

Листинг 3.3 — Разновидности и связанные приёмы
Разбор. classmethod получает класс первым аргументом (cls) и создаёт экземпляр через cls(…). Это важно для наследования: если от Complex унаследовать класс, Подкласс.from_polar(…) вернёт экземпляр подкласса. Так устроены dict.fromkeys, datetime.fromisoformat, int.from_bytes. Округление в from_polar убирает погрешность вроде 1.2e-16 вместо нуля.
Реестр создателей через декоратор
Файл 04_registry.py :

Листинг 3.4 — Разновидности и связанные приёмы

Листинг 3.4 (продолжение) — Разновидности и связанные приёмы
Разбор. Два способа регистрации без центрального if/elif. __init_subclass__ вызывается автоматически при объявлении каждого подкласса и получает именованный аргумент kind из строки class Circle(Shape, kind="circle»). Новая фигура регистрируется самим фактом своего объявления. Декоратор с параметром @parser(«csv») регистрирует функцию в словаре и возвращает её без изменений. Оба приёма позволяют модулям-плагинам добавлять продукты, не трогая фабрику.
3.7. Гибриды и конкурентность
Кэширующая фабрика с weakref
Фабрика может не создавать объект заново, если он уже есть, — и при этом не держать его в памяти, когда он никому не нужен.
Файл 05_cache.py :

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

Листинг 3.5 (продолжение) — Гибриды и конкурентность
Разбор. WeakValueDictionary хранит слабые ссылки на значения: пока текстура кому-то нужна, она в кэше; когда последняя обычная ссылка исчезает, запись удаляется автоматически. После del textures в CPython объекты освобождаются сразу (подсчёт ссылок), и кэш пустеет. Проверка и вставка выполняются под одной блокировкой, поэтому шестьдесят запросов из шести потоков дали ровно три загрузки.
Внутри get текстура сохраняется в локальной переменной до возврата. Это важно: если бы мы написали self._cache[name] = Texture(name) и потом return self._cache[name], объект мог бы исчезнуть между строками, потому что на него не было бы сильной ссылки.
Фабрика обработчиков для рабочих потоков
Файл 06_worker_factory.py :

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

Листинг 3.6 (продолжение) — Гибриды и конкурентность
Разбор. Каркас run_pipeline — общий алгоритм, а фабрика make_handler передана параметром: это может быть класс (PrimeHandler) или любая функция, возвращающая обработчик. Каждый поток получает собственный обработчик со своим счётчиком, поэтому блокировки не нужны. Оператор:= («морж») присваивает результат handle и сразу проверяет его в условии генератора списка.
3.8. Самостоятельные работы
Работа 1. Экспорт документа
Задание. Общий алгоритм сохранения документа: создать экспортёр, записать заголовок, тело, подпись. Сделайте документы, сохраняемые в TXT и HTML, не меняя алгоритма.
Полное решение — файл 07_exporter.py :

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

Листинг 3.7 (продолжение) — Самостоятельные работы
Разбор. Алгоритм save записан один раз, документы отвечают только за выбор экспортёра. В Python длина строки len(title) считается в символах, поэтому подчёркивание под кириллическим заголовком совпадает по длине.
3.9. Типичные ошибки
Иерархия создателей там, где хватает параметра. Если создатель отличается только классом продукта, передайте класс параметром или атрибутом.
Прямой вызов конструктора в classmethod. Пишите cls(…), а не Complex(…): иначе подклассы получат экземпляр базового класса.
Кэш со слабыми ссылками без сильной ссылки при возврате. Сохраняйте созданный объект в локальной переменной, пока не вернули его.
Гонка в кэширующей фабрике. Проверка и вставка — под одной блокировкой.
3.10. Вопросы для самопроверки
Что отличает фабричный метод от любой функции, создающей объект?
Как в Python заменить иерархию создателей одним параметром?
Почему в classmethod создают объект через cls(…)?
Как __init_subclass__ помогает регистрировать продукты?
Как работает WeakValueDictionary и зачем она кэширующей фабрике?
Почему созданная текстура сохраняется в локальной переменной перед возвратом?
Почему обработчикам из примера с потоками не нужна блокировка?
Что делает оператор:=?
3.11. Ответы
Это переопределяемый шаг создания внутри общего алгоритма, который пользуется продуктом.
Передать класс продукта как аргумент или атрибут класса: классы в Python — объекты.
Чтобы подклассы получали экземпляры своего класса, а не базового.
Он вызывается при объявлении каждого подкласса и может записать его в реестр по параметру из строки объявления.
Хранит значения по слабым ссылкам и удаляет записи, когда объекты больше никому не нужны; кэш не продлевает им жизнь.
Иначе на новый объект не было бы сильной ссылки, и он мог бы исчезнуть из словаря до возврата.
Каждый поток создаёт свой обработчик и пользуется им один.
Присваивает значение переменной внутри выражения и возвращает его — например, в условии генератора.
Глава 3. Реализация на C++23
3.1. Задача построения сложного объекта
Представьте конфигурацию сервера: адрес, порт, число рабочих потоков, режим TLS и таймауты. Если передать все параметры длинному конструктору, легко перепутать соседние аргументы одного типа. Когда необязательных параметров становится больше, появляются многочисленные перегрузки — так называемый телескопический конструктор.
Другая проблема — сложная последовательность создания. Например, отчёт нужно начать с заголовка, затем добавить строки и только после проверки получить итоговый HTML или Markdown. Клиенту может понадобиться один порядок действий, но несколько разных представлений результата.
Builder выделяет поэтапное построение объекта в отдельную сущность. Клиент или специальный распорядитель вызывает шаги, а строитель накапливает состояние и формирует результат. В классическом GoF варианте один алгоритм сборки может работать с разными реализациями строителя и получать разные представления.
Не каждый объект с методами настройки автоматически нуждается в полноценном Director. Если порядок прост, клиент может сам вызвать методы строителя. Для небольшой структуры с публичными полями бывает достаточно агрегатной или обозначенной инициализации C++20/23; если нужны проверки и скрытые инварианты, отдельный строитель может быть оправдан.
3.2. Участники и схема
Builder — интерфейс шагов построения.
ConcreteBuilder — конкретная реализация шагов и способа получения результата.
Director — необязательный распорядитель, задающий последовательность вызовов.
Product — создаваемый объект или представление.
Клиент — выбирает строитель, запускает сборку и получает результат.

Порядок и обязательность шагов должны быть определены договором. В одних реализациях ошибку обнаруживают при build(), в других часть неправильных последовательностей исключается типами во время компиляции. Проверка типов не заменяет проверку содержимого: например, переданная строка URL всё ещё может быть пустой.
3.3. Когда применять
Builder полезен при сложных инвариантах, нескольких необязательных настройках, поэтапной сборке или разных представлениях, создаваемых по общей последовательности. Он помогает дать параметрам имена и не отдавать клиенту промежуточный некорректный продукт.
Цена решения — дополнительный класс, возможное дублирование полей продукта и необходимость явно описать повторное использование. Важно решить, возвращает ли build() копию, переносит ресурсы, очищает строитель и разрешает ли повторный вызов. Изменяемый строитель не становится потокобезопасным автоматически.
Сравнение с Abstract Factory. Абстрактная фабрика отвечает за согласованное семейство продуктов; Builder организует шаги создания результата. Фабрика может возвращать строитель или использовать его внутри себя.
Сравнение с designated initializers. В C++20 и C++23 агрегат можно инициализировать именованными полями. Это лаконично для простой открытой структуры. Builder становится полезнее, если поля нужно скрыть, проверить комбинации и задать порядок сложной подготовки. Обозначенная инициализация имеет собственные правила применимости к агрегатам и не заменяет произвольную валидацию.
3.4. Классический пример: параметризованный SQL-запрос
В примере Director задаёт рецепт выборки пользователей по городу. SqlBuilder накапливает выбранные шаги и возвращает PreparedQuery через std::expected. Ошибку отсутствующих данных можно проверить, прежде чем использовать результат.
Имя таблицы и колонок в примере фиксировано в программе. Город хранится отдельно от SQL-строки, где стоит заполнитель?. Это модель подготовленного выражения: чтобы получить защиту при реальном выполнении, значения необходимо передать через механизм привязки параметров конкретного драйвера. Синтаксис заполнителей зависит от СУБД.

Листинг 3.1 — Классический пример: параметризованный SQL-запрос

Листинг 3.1 (продолжение) — Классический пример: параметризованный SQL-запрос
Разбор. PreparedQuery владеет SQL-строкой и вектором значений. Абстрактный QueryBuilder объявляет отдельные шаги, SqlBuilder хранит накопленное состояние и проверяет его в build. Director задаёт порядок: сброс, выбор полей, выбор таблицы и фильтр.
В main строитель и распорядитель имеют автоматическое время жизни. Значения строки и вектора освобождаются их деструкторами без ручного управления памятью. Возврат через expected описывает ошибки проверки; исключения выделения памяти при этом по-прежнему возможны. Программа не выполняет запрос и не подключается к базе.
Вывод:

3.5. Одиннадцать разновидностей и связанных приёмов
Названия сохранены по оглавлению. Некоторые варианты являются комбинациями или подходами к построению, а не отдельными каноническими паттернами GoF. Для каждой темы в разделе 3.7 есть полное решение самостоятельной задачи.
1. Classic GoF Builder with Director
Абстрактный интерфейс задаёт шаги, конкретные строители выполняют их по-разному, Director определяет порядок. Один и тот же рецепт может сформировать HTML или PDF. Цена — дополнительный интерфейс, оправданный, если представления или алгоритмы сборки действительно меняются. Работа 2 содержит такой Director.
2. Fluent Builder / Joshua Bloch's Builder
Методы возвращают ссылку на строитель и позволяют вызывать настройки цепочкой с понятными именами. build() проверяет параметры и возвращает продукт или ошибку. Важно не сохранять ссылку на временный строитель дольше полного выражения. Работа 3 создаёт конфигурацию подключения.
3. Telescoping / Step Builder / Wizard Builder
Разные типы представляют разные этапы: например, после выбора счёта отправителя становится доступен выбор получателя, затем — суммы. Это делает некоторые неправильные последовательности невыразимыми через публичный интерфейс. Данные на каждом шаге всё равно нужно проверять. Работа 4 использует отдельные типы шагов.
4. Type-State Builder
Состояние кодируется параметром шаблона. Метод build() доступен только при подходящем состоянии, например после указания URL. Состояние типа подтверждает факт вызова метода, но не делает пустую строку валидным URL. Работа 5 совмещает compile-time ограничение и runtime-проверку.
5. Composite / Faceted Builder
Сложные настройки делятся на группы: персональные данные, адрес и безопасность. Главный строитель выдаёт фасеты с узким интерфейсом. Если фасет хранит ссылку на главный строитель, время жизни главного объекта должно покрывать работу с фасетом. Работа 6 демонстрирует такую организацию.
6. Hierarchical / Curiously Recurring Generic Builder
При наследовании текучих строителей важно возвращать ссылку на фактический тип наследника, иначе после вызова базового метода дочерние методы пропадут из цепочки. Для этого применяют CRTP или явный параметр объекта this из C++23. Работа 7 использует deducing this; поддержка этой возможности зависит от компилятора.
7. Lambda / Nested DSL Builder
Функция или лямбда получает подстроитель, наполняет его, затем управление возвращается внешнему строителю. Такой синтаксис подходит для вложенных структур, например HTML-страницы с телом и абзацами. В работе 8 текст экранируется при выводе в HTML; это маленький специализированный генератор, не полноценная HTML-библиотека.
8. Functional Options Pattern
Опции можно передавать как вызываемые объекты, изменяющие конфигурацию. Это делает набор параметров расширяемым, но требует явно определить порядок применения, поведение повторных опций и проверку итогового состояния. В C++23 std::move_only_function допускает хранение лямбд с некопируемыми захватами. Работа 9 только формирует настройки сжатия и шифрования; сами алгоритмы она не реализует.
9. Immutable / Copy-on-Write Builder
При неизменяемом интерфейсе каждый метод настройки возвращает новый строитель, оставляя исходный без изменений. Это удобно для создания нескольких вариантов из одной основы. Работа 10 физически копирует данные, а не реализует Copy-on-Write; для больших матриц это может быть дорого. В настоящем COW общие данные копируются при записи с корректной синхронизацией и правилами владения.
10. Director-Preset / Mother-Builder
Тестовый строитель может начинаться с валидного набора значений, после чего тест изменяет только важные для него поля. Именованные пресеты помогают понять смысл данных и снижают дублирование. Работа 11 создаёт типовой заказ и позволяет добавить товары.
11. Progressive / Lazy Evaluation Builder
Строитель сначала накапливает описание шагов, а формирует запрос или выполняет вычисление только при терминальном вызове. Это позволяет отдельно проверить настройки и управлять моментом работы. Работа 12 составляет SQL с заполнителями и отдельно сохраняет значения; вызов СУБД в ней не выполняется.
Darmowy fragment się skończył.