Appearance
Проекции: общий словарь
Значение поля может жить в другом объекте. Копировать значение к себе приводит к сложеностям: владелец меняется, копия устаревает, её приходится догонять ватчерами и массовыми переписями.
Вместо копии мы говорим полю: ты теперь проекция. В объекте хранится только ссылка на владельца (id состояния, id записи реестра), а значение читается у владельца, когда оно нужно: открылся редактор — прочитали и подставили, собирается запрос на контроллер — прочитали и подставили.
Проекция — правило этого чтения: функция, вычисляющая значение у владельца, и — если значение должно обновляться не только при инициализации — список полей, при смене которых перечитывать. Функцию к полю прикладывает декларация в коде формы команды.
Как по ссылке найти владельца, словарь не диктует — это логика домена: у экшенов свой резолвер объектов-целей, у драйвер-линков — поиск записи в реестре.
Словарь
ts
/** Вычисление значения проекции: объект-владелец + values полей редактора. */
export type TProjectionResolver<TSource> = (
source: TSource,
values: Record<string, unknown>,
) => unknown;
/**
* Поле может не хранить значение, а вычислять его у владельца: так работают
* опции дропдауна состояний, предзаполнение «изменить на» или адрес в запросе
* на контроллер. FieldProjection — правило этого вычисления. TSource — тип
* объекта-владельца; его привязывает потребитель правила (логика экшенов
* передаёт объект-цель команды).
*/
export type FieldProjection<TSource> = {
/**
* Вычисление: получает объект-владельца (TSource) и текущие значения полей
* редактора; где внутри владельца искать и в каком виде отдать — дело самой
* функции.
*/
resolver: TProjectionResolver<TSource>;
/**
* При инициализации значение читается один раз и дальше само не меняется.
* Если оно должно обновляться и после — перечисляем поля команды, при смене
* которых перечитывать. Смены остальных полей пересчёт не запускают:
* в частности, ввод руками в само проекционное поле не затирается.
*
* @example
* Команда «изменение поля» PID: [Параметр ▾] [Значение]. Правило «Значения»:
* { resolver: parameterValue, dependsOn: ["field"] }, где parameterValue
* читает у цели settings[выбранный параметр]. Открыли команду — подставилось
* текущее значение выбранного параметра. Переключили «Параметр» —
* подставилось значение нового. Вписали число руками — живёт, ничем
* не затирается.
*/
dependsOn?: string[];
};Разворот ссылки в значение
Инструмент адаптеров каталога: читает поле внутри объекта-источника точечным путём. Источник типизирован — путь проверяет компилятор по алфавиту NestedKeys (массив — с маркером «[]», при чтении маркер срезается). Источник сырой (unknown) — путь обычная строка. Пути нет — undefined.
Mentioned In
None yet.