Skip to content

Проекции: общий словарь

Значение поля может жить в другом объекте. Копировать значение к себе приводит к сложеностям: владелец меняется, копия устаревает, её приходится догонять ватчерами и массовыми переписями.

Вместо копии мы говорим полю: ты теперь проекция. В объекте хранится только ссылка на владельца (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.