From 8b62daeca21039a3f47b6d7ba4a6d058d5fef863 Mon Sep 17 00:00:00 2001 From: sfaqer Date: Wed, 30 Oct 2024 14:49:43 +1000 Subject: [PATCH] =?UTF-8?q?=D0=97=D0=B0=D0=B3=D0=BE=D0=BB=D0=BE=D0=B2?= =?UTF-8?q?=D0=BA=D0=B8=20=D1=81=D1=82=D1=80=D0=B0=D0=BD=D0=B8=D1=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/framework-elements/additional-processing.md | 4 ++++ docs/framework-elements/aliases-grouping.md | 4 ++++ docs/framework-elements/aliases.md | 4 ++++ docs/framework-elements/annotation-inheritance.md | 4 ++++ docs/framework-elements/annotations-processing.md | 4 ++++ docs/framework-elements/app-context.md | 4 ++++ docs/framework-elements/app-settings-injection.md | 4 ++++ docs/framework-elements/component-declaration.md | 4 ++++ docs/framework-elements/component-instance.md | 4 ++++ docs/framework-elements/component-overriding.md | 4 ++++ docs/framework-elements/component-post-initialization.md | 4 ++++ docs/framework-elements/component-uniqueness.md | 4 ++++ docs/framework-elements/components-binding.md | 3 +++ docs/framework-elements/components-factory.md | 4 ++++ docs/framework-elements/components-prioritization.md | 4 ++++ docs/framework-elements/components-sorting.md | 4 ++++ docs/framework-elements/conditional-registration.md | 4 ++++ docs/framework-elements/custom-annotations.md | 4 ++++ docs/framework-elements/custom-arguments.md | 4 ++++ docs/framework-elements/dependency-injection.md | 4 ++++ docs/framework-elements/instance-generator.md | 4 ++++ docs/framework-elements/launch-control-inversion.md | 4 ++++ 22 files changed, 87 insertions(+) diff --git a/docs/framework-elements/additional-processing.md b/docs/framework-elements/additional-processing.md index 5f94d20..c8ae22b 100644 --- a/docs/framework-elements/additional-processing.md +++ b/docs/framework-elements/additional-processing.md @@ -1,3 +1,7 @@ +--- +title: Дополнительная обработка компонента +--- + # Дополнительная обработка компонента Предположим, вы хотите сделать лошадку из желудей. Что для этого нужно? Для начала надо взять несколько желудей. Они будут немного отличаться друг от друга: тот, что покрупнее, пойдет на тело лошадки, тонкие желуди пойдут ноги, а вот этот смешной желудь в виде конуса будет мордой нашей лошадки. Конечно же, обмажем все пластилином, чтобы оно держалось вместе. diff --git a/docs/framework-elements/aliases-grouping.md b/docs/framework-elements/aliases-grouping.md index f5d4468..bb0af6d 100644 --- a/docs/framework-elements/aliases-grouping.md +++ b/docs/framework-elements/aliases-grouping.md @@ -1,3 +1,7 @@ +--- +title: Группировка компонентов по алиасу +--- + # Группировка компонентов по алиасу Представьте себе компанию панков. Каждый из них уникален, каждый - личность. Но при этом у них есть и что-то общее - все они панки. К каждому можно обратиться как: "Эй, ты, панк!", и он не только отзовется громогласным "Хой!", но возможно даже предложит Вам пива. diff --git a/docs/framework-elements/aliases.md b/docs/framework-elements/aliases.md index 9505b5d..601d4df 100644 --- a/docs/framework-elements/aliases.md +++ b/docs/framework-elements/aliases.md @@ -1,3 +1,7 @@ +--- +title: Алиасы компонентов +--- + # Алиасы компонентов У желудей все как у людей. Есть свои увлечения, субкультуры и даже может быть `&Прозвище`. Желудь `Василий` в силу своего темного прошлого "у своих" зовется не иначе как `Васян`. Как это отразить в ОСени? diff --git a/docs/framework-elements/annotation-inheritance.md b/docs/framework-elements/annotation-inheritance.md index e8c23a2..e3ce1ff 100644 --- a/docs/framework-elements/annotation-inheritance.md +++ b/docs/framework-elements/annotation-inheritance.md @@ -1,3 +1,7 @@ +--- +title: Наследование аннотаций +--- + # Наследование аннотаций Представьте себе ситуацию, когда над несколькими компонентами системы нужно развесить несколько аннотаций по одному и тому же принципу. Например, объявить много компанейских `&Желудей` с одинаковыми `&Прозвищами`. Чтобы упростить себе жизнь, можно создать новую аннотацию, в которой скомбинировать несколько других. Например: diff --git a/docs/framework-elements/annotations-processing.md b/docs/framework-elements/annotations-processing.md index 1fef793..12e02a4 100644 --- a/docs/framework-elements/annotations-processing.md +++ b/docs/framework-elements/annotations-processing.md @@ -1,3 +1,7 @@ +--- +title: Обработка аннотаций +--- + # Обработка аннотаций Если Вы уже попробовали делать свои `&Напильники`, то скорее всего ознакомились с классом `ОпределениеЖелудя`. Помимо хранения метаинформации о собственно желуде, методы `Свойства()` и `Методы()` возвращают информацию об аннотациях над свойствами и методами уже в "развернутом" и плоском виде. diff --git a/docs/framework-elements/app-context.md b/docs/framework-elements/app-context.md index 3e0f6d7..5a1ca4f 100644 --- a/docs/framework-elements/app-context.md +++ b/docs/framework-elements/app-context.md @@ -1,3 +1,7 @@ +--- +title: Использование контекста приложения +--- + # Использование контекста приложения `Поделка` является входной точкой для работы вашего приложения. Через него вы собираете информацию о ваших желудях, инициализируете их. Приятной особенностью "поделки" является то, что он сам по себе тоже является желудем! Все есть желудь, помните же? diff --git a/docs/framework-elements/app-settings-injection.md b/docs/framework-elements/app-settings-injection.md index 45e61e5..9bd975a 100644 --- a/docs/framework-elements/app-settings-injection.md +++ b/docs/framework-elements/app-settings-injection.md @@ -1,3 +1,7 @@ +--- +title: Внедрение настроек приложения +--- + # Внедрение настроек приложения Хорошая поделка состоит не только из желудей и пластилина, но и обвешана маленькими приятными глазу детальками. Причем разные поделки, собранные по одному и тому же чертежу, могут только этими детальками и отличаться. diff --git a/docs/framework-elements/component-declaration.md b/docs/framework-elements/component-declaration.md index dc3433a..840ac2d 100644 --- a/docs/framework-elements/component-declaration.md +++ b/docs/framework-elements/component-declaration.md @@ -1,3 +1,7 @@ +--- +title: Объявление компонента +--- + # Объявление компонента Как вы, наверное, догадались по словосочетанию "компонентное приложение", основой вашего приложения становится `Желудь`. Жёлудь - это всё, и всё есть жёлудь. `ОбновляторВерсии1С`? Жёлудь. `ПроверяторУстановленныхВерсий`? Тоже Жёлудь. И даже логин с паролем - это тоже в некотором роде жёлуди. diff --git a/docs/framework-elements/component-instance.md b/docs/framework-elements/component-instance.md index d923279..f582804 100644 --- a/docs/framework-elements/component-instance.md +++ b/docs/framework-elements/component-instance.md @@ -1,3 +1,7 @@ +--- +title: Получение экземпляра компонента +--- + # Получение экземпляра компонента Мы определили желудь, настало время его создать! diff --git a/docs/framework-elements/component-overriding.md b/docs/framework-elements/component-overriding.md index a51bf81..0671d54 100644 --- a/docs/framework-elements/component-overriding.md +++ b/docs/framework-elements/component-overriding.md @@ -1,3 +1,7 @@ +--- +title: Переопределение компонента по имени +--- + # Переопределение компонента по имени Сила Верховного желудя настолько велика, что он может вытеснить данные о более слабом желуде из Поделки. diff --git a/docs/framework-elements/component-post-initialization.md b/docs/framework-elements/component-post-initialization.md index 1e45426..20c56f1 100644 --- a/docs/framework-elements/component-post-initialization.md +++ b/docs/framework-elements/component-post-initialization.md @@ -1,3 +1,7 @@ +--- +title: Пост-инициализация компонента +--- + # Пост-инициализация компонента Если вы все еще внимательно следите за нитью документации, у вас мог возникнуть вопрос вида ~~"Что за херня тут происходит"~~ "В каком порядке внедряются зависимости желудя?". И это очень хороший вопрос. diff --git a/docs/framework-elements/component-uniqueness.md b/docs/framework-elements/component-uniqueness.md index e3be2f7..9ca2495 100644 --- a/docs/framework-elements/component-uniqueness.md +++ b/docs/framework-elements/component-uniqueness.md @@ -1,3 +1,7 @@ +--- +title: Уникальность экземпляров компонентов +--- + # Уникальность экземпляров компонентов Желуди почти как люди. У каждого есть свой `&Характер`. Кто-то показывает его явно, а кто-то ведет себя "как все". diff --git a/docs/framework-elements/components-binding.md b/docs/framework-elements/components-binding.md index 42d91a7..e954dac 100644 --- a/docs/framework-elements/components-binding.md +++ b/docs/framework-elements/components-binding.md @@ -1,3 +1,6 @@ +--- +title: Связывание компонентов между собой +--- # Связывание компонентов между собой diff --git a/docs/framework-elements/components-factory.md b/docs/framework-elements/components-factory.md index ccc93c1..24ff861 100644 --- a/docs/framework-elements/components-factory.md +++ b/docs/framework-elements/components-factory.md @@ -1,3 +1,7 @@ +--- +title: Фабрика компонентов +--- + # Фабрика компонентов Не все желуди обязаны являться полноценными классами с точки зрения системы типов 1Script. Согласитесь, странно заводить целый класс для хранения логина от ИТС, просто потому что кто-то пережарил желудей. diff --git a/docs/framework-elements/components-prioritization.md b/docs/framework-elements/components-prioritization.md index a738894..68a5528 100644 --- a/docs/framework-elements/components-prioritization.md +++ b/docs/framework-elements/components-prioritization.md @@ -1,3 +1,7 @@ +--- +title: Приоритизация компонентов с общим алиасом +--- + # Приоритизация компонентов с общим алиасом Но давайте будем честны. Когда мы говорим про Sex Pistols, то в первую очередь вспоминаем Сида Вишеса, и только потом уже Джонни Роттена и остальных. А какой у него получился алко-my-way, ух! Аннотация `&Верховный` подскажет "ОСени", кого вы считаете панком "по умолчанию": diff --git a/docs/framework-elements/components-sorting.md b/docs/framework-elements/components-sorting.md index 2143825..1d16d2a 100644 --- a/docs/framework-elements/components-sorting.md +++ b/docs/framework-elements/components-sorting.md @@ -1,3 +1,7 @@ +--- +title: Упорядочивание компонентов при получении в виде сортированных коллекций +--- + # Упорядочивание компонентов при получении в виде сортированных коллекций Если вы прилепляете себе несколько желудей с общим прозвищем в виде массива или таблицы значений, вам может понадобиться расставить их по некоторому порядку. Не будем вдаваться в подробности, кто в SexPistols третий панк, а кто второй, но точно можно предположить, что сессионные музыканты должны быть в самом конце массива панков. В этом нам поможет аннотация `&Порядок`, принимающая числовое значение порядка. diff --git a/docs/framework-elements/conditional-registration.md b/docs/framework-elements/conditional-registration.md index d104768..06260c6 100644 --- a/docs/framework-elements/conditional-registration.md +++ b/docs/framework-elements/conditional-registration.md @@ -1,3 +1,7 @@ +--- +title: Условная регистрация компонентов в контексте приложения +--- + # Условная регистрация компонентов в контексте приложения Иногда вам может потребоваться выбирать, какие именно классы вы хотите добавлять в свою поделку. Например, вы хотите загружать определенный класс только при выполнении какого-нибудь условия (из-за конфликта имен, к примеру). На помощь придёт объект `&Заготовка`, который можно расценивать как готовый набор желудей, добавляемый в поделку. diff --git a/docs/framework-elements/custom-annotations.md b/docs/framework-elements/custom-annotations.md index 63dbf55..c3b08a5 100644 --- a/docs/framework-elements/custom-annotations.md +++ b/docs/framework-elements/custom-annotations.md @@ -1,3 +1,7 @@ +--- +title: Собственные аннотации +--- + # Собственные аннотации OneScript могуч. В отличие от материнской платформы, над любым методом может быть любое количество произвольных аннотаций, у них могут быть именованные и неименованные параметры. Аннотации даже могут быть над `Перем`енными модуля и параметрами методов! Как тебе такое, УанЭс Энтерпрайз? diff --git a/docs/framework-elements/custom-arguments.md b/docs/framework-elements/custom-arguments.md index c43e969..42f2c6a 100644 --- a/docs/framework-elements/custom-arguments.md +++ b/docs/framework-elements/custom-arguments.md @@ -1,3 +1,7 @@ +--- +title: Произвольные аргументы конструктора +--- + # Произвольные аргументы конструктора Иногда понимание того, что же еще добавить в поделку, приходит в самый последний момент. Буквально после запуска приложения, кодом, на основании какой-то хитрой логики. Да, можно сделать хитрый `&Дуб`, передать в него в виде желудя расчетчик этой самой бизнес-логики, который выдаст нужную циферку, но порой хочется просто передать `42` в конструктор желудя. diff --git a/docs/framework-elements/dependency-injection.md b/docs/framework-elements/dependency-injection.md index 07e16dc..e7fb7e1 100644 --- a/docs/framework-elements/dependency-injection.md +++ b/docs/framework-elements/dependency-injection.md @@ -1,3 +1,7 @@ +--- +title: Внедрение зависимостей в поля и функции-сеттеры +--- + # Внедрение зависимостей в поля и функции-сеттеры Не всегда бывает удобно пихать желуди прямо в конструктор. Например, желуди могут так сильно зависеть друг от друга, что образуют циклическую зависимость. Как Заяц-Волк, только Желудь-Желудь. В таком случае внедрить зависимости через конструктор не получится. На помощь нам придут внедрение желудей через поля и функции, принимающие значения. diff --git a/docs/framework-elements/instance-generator.md b/docs/framework-elements/instance-generator.md index cca19d5..35219b1 100644 --- a/docs/framework-elements/instance-generator.md +++ b/docs/framework-elements/instance-generator.md @@ -1,3 +1,7 @@ +--- +title: Генератор экземпляров компонентов +--- + # Генератор экземпляров компонентов Иногда возникает необходимость получить желудь-зависимость отложено. Например, по какому-то условию или с передачей произвольных параметров. Эту задачу можно решить через внедрение в желудь `Поделки` целиком, но умные книжки учат нас, что зависеть от глобального контекста приложения - это вообще-то фу-фу-фу и не надо так. Для уменьшения связывания полезного кода с инфраструктурным в ОСени есть дополнительная аннотация `&Табакерка`. Если ее навесить над полем или параметром метода, над которым уже висит `&Пластилин`, `&Деталька` или `&Блестяшка`, то вместо внедрения в поле или параметр непосредственно нужного значения будет внедрен специальный объект типа `Табакерка`, который позволяет достать желудь/детальку/блестяшку по требованию. diff --git a/docs/framework-elements/launch-control-inversion.md b/docs/framework-elements/launch-control-inversion.md index 294c851..186efa9 100644 --- a/docs/framework-elements/launch-control-inversion.md +++ b/docs/framework-elements/launch-control-inversion.md @@ -1,3 +1,7 @@ +--- +title: Инверсия управления запуском приложения +--- + # Инверсия управления запуском приложения Одной из конечных точкой использования фреймворка для внедрения зависимостей является отказ от какой-либо логики при запуске приложения. В конце концов мы же жёлуди в поделку добавляем не просто так, а чтобы они могли `Сообщить("Привет, мир!")`.