aibot88 Autumn (ОСень)
Фреймворк компонентных приложений для OneScript с Dependency Injection и Inversion of Control. Разрешает зависимости конструкторов автоматически: не нужно вручную создавать цепочки объектов и передавать параметры во все точки создания.
Принцип работы
Объект с конструктором, принимающим параметры (зависимости), регистрируется как компонент («желудь»). Вместо вызова Новый Класс(зависимость1, зависимость2) в коде используется Осень.НайтиЖелудь("ИмяКласса") — фреймворк сам создаёт зависимости и передаёт их в конструктор.
Точка входа
#Использовать autumn
#Использовать "Каталог/С/Классами/Команд" // путь к папке с классами-компонентами
Поделка = Новый Поделка();
Поделка.ЗапуститьПриложение();
Каталог с классами должен содержать классы, помеченные аннотациями Autumn (Желудь, Дуб и т.д.), чтобы они регистрировались в контексте приложения.
Получение компонента
Обновлятор1С = Осень.НайтиЖелудь("Обновлятор1С");
Идентификатор совпадает с именем класса или с параметром аннотации &Желудь("Идентификатор").
Ключевые аннотации
&Желудь("Идентификатор") — класс регистрируется как компонент (желудь). Без параметра используется имя класса. Параметры конструктора разрешаются как зависимости других желудей.
&Верховный — корневой компонент (например, описание приложения). Указывается вместе с &Желудь.
&Дуб — класс-фабрика: не сам является желудем, но в методе с &Завязь возвращает экземпляры других классов (желудей).
&Завязь — метод внутри &Дуб, возвращающий экземпляр класса; используется для регистрации команд/компонентов без аннотаций на целевом классе (например, миграция легаси-кода).
Пример желудя:
&Желудь("Обновлятор1С")
Процедура ПриСозданииОбъекта(ПроверяторВерсий, Настройки)
// ПроверяторВерсий и Настройки будут разрешены Autumn и переданы сюда
КонецПроцедуры
Пример дуба с завязью:
&Дуб
Процедура ПриСозданииОбъекта()
КонецПроцедуры
&Завязь
&КомандаПриложения(Имя = "legacy", Описание = "Легаси команда")
Функция МояЛегасиКоманда() Экспорт
Возврат Новый МояЛегасиКоманда();
КонецФункции
Рекомендации
- Один класс — одна ответственность; зависимости передавать через конструктор.
- Не создавать длинные цепочки вручную — регистрировать классы как желуди и получать их через
Осень.НайтиЖелудь(). - Настройки приложения можно вынести в
autumn-properties.jsonили в отдельный желудь с интерфейсом настроек.
Дополнительно
Расширенная справка по аннотациям и конфигурации — reference.md.
Документация: autumn-library.github.io.