Skip to main content

Динамика

N2O разделяет шаблон и данные. Это хорошо сказывается на производительности, но может вызвать проблемы с реализацией интерфейсов, у которых шаблон зависит от данных. Для реализации таких динамических интерфейсов в N2O существует ряд приёмов.

Динамические свойства

Вычисляемые значения атрибутов

Некоторые атрибуты в компонентах можно задавать через ссылки или javaScript выражения:

Иконка в таблице по данным строки
<column label="Тип">
<!-- "{iconClass}" ссылка на поле выборки -->
<icon class="{iconClass}"/>
</column>
Заголовок поля по значению другого поля
<radio-group id="contactType"
label="Тип контакта">
<options>
<option id="1" name="Мобильный телефон"/>
<option id="2" name="Электронная почта"/>
</options>
</radio-group>

<input-text id="contactValue"
label="{contactType.name}"/>
<!-- Заголовок поменяется при выборе типа контакта -->
Доступность чекбокса по условию
<column label="Активность">
<!-- "{status == 'open'}" выражение над строкой таблицы -->
<checkbox enabled="`status == 'open'`"/>
</column>

Форматирование значений

Ссылки на значения можно объединять с текстом:

Форматирование значений
<fields>
<alert id="success" text="Привет, {name}!" color="success"/>
<input-text id="name" default-value="Мир"/>
</fields>

Переключатели вложенных метаданных

Некоторые вложенные метаданные можно переключать в зависимости от данных с помощью элемента switch:

Переключатель ячейки столбца таблицы
<column>
<switch value-field-id="type">
<case value="type1">
<!-- Значок, если type == type1 -->
<badge.../>
</case>
<case value="type2">
<!-- Иконка, если type == type2 -->
<icon.../>
</case>
...
<default>
<!-- Текст, в остальных случаях -->
<text/>
</default>
</switch>
</column>

Динамические ссылки на метаданные

В некоторых местах можно ссылаться на разные метаданные в зависимости от данных:

Динамическая ссылка на страницу
<button>
<!-- {tableName} ссылка на поле в текущей модели данных -->
<open-page page-id="{tableName}"/>
</button>

Параметризованные метаданные

В N2O можно загружать разные метаданные по одному и тому же источнику (например, xml файлу), используя параметры. Параметры задаются в идентификаторе метаданной после знака "вопрос":

id?param1=value1&param2=value2
important

Параметры не могут содержать зарезервированные символы URI, такие как &?/#; и другие. Либо такие символы должны быть закодированы (UriEncode).

Параметры могут быть константными:

Пример параметризации с константными значениями
<fields>
<select label="Организация" query-id="refbook?table=organization"/>
<select label="Подразделение" query-id="refbook?table=department"/>
</fields>

Чтобы использовать параметр необходимо вставить его код в знак $ и фигурные скобки ${param}, аналогично настройкам:

refbook.query.xml
<query>
<list>
<sql>select * from ${table}</sql>
</list>
...
</query>

Генерация метаданных

В N2O метаданные можно сгенерировать в момент их первой загрузки с помощью провайдеров на языке java. Для этого необходимо создать реализацию интерфейса DynamicMetadataProvider, и зарегистрировать её в качестве Spring Bean.

Реализация провайдера метаданных на Java
@Service
public class MyTableProvider implements DynamicMetadataProvider {
/**
* @return Код провайдера
*/
@Override
public String getCode() {
return "myTableProvider";
}

/**
* @param params Параметры провайдера
* @return Список сгенерированных метаданных
*/
@Override
public List<? extends N2oMetadata> provide(String params) {
...
}
/**
* @return Типы генерируемых метаданных
*/
public Collection<Class<? extends N2oMetadata>> getMetadataClasses() {
return Arrays.asList(N2oTable.class);
}

}

Чтобы сослаться на такую метаданную, необходимо в качестве идентификатора метаданной указать код провайдера, а параметры передать после знака ?:

Ссылка на провайдер
<table ref-id="myTableProvider?param=123"/>