| Корневой элемент collection. Пространство имен: configuration |
Представления, используемые AF5, называются коллекциями. В отличие от обычных представлений реляционной БД, коллекции AF5 не хранятся в самой БД, а хранятся в конфигурационных файлах AF5. |
<collection name="{name}" idField="id" replace="runtime">
<prototype>
<![CDATA[...
::where-clause
]]>
</prototype>
<counting-prototype>
<![CDATA[...
::where-clause
]]>
</counting-prototype>
<filter name="{name}">
<criteria placeholder="where-clause"><![CDATA[...]]></criteria>
</filter>
</collection> |
attributes
| Параметры | Описание |
|---|---|
name | Имя коллекции. Обязательный атрибут, каждая коллекция в системе должна иметь уникальное значение. |
replace | Определяет возможность «горячего» замещения конфигурации коллекции при загрузке обновленной конфигурации коллекции. runtime – разрешена, иначе – запрещена. |
idField | Колонка результирующей выборки SQL-запроса, значения из которой будут использованы в качестве идентификаторов записей. |
useClone | Флаг, если true, при отсутствии открытой транзакции новой перед вызовом открываться не будет, а при ее наличии произойдет ошибка. |
transactionCache | Флаг, enabled/disabled, включает/выключает кэширование результирующей выборки на период открытой транзакции |
prototype
Заготовка основного SQL-запроса Коллекции. Содержит опорные заглушки для фильтров (должны начинаться с двойного двоеточия и могут содержать только буквы, цифры и дефисы).
counting-prototype
Заготовка SQL-запроса, возвращающего количество записей, возвращаемых основным запросом. Также содержит опорные заглушки для фильтров.
filter
Фильтр. Параметризируемый фрагмент SQL, который вливается в заготовку и модифицирует условие выборки. Множественный.
| Параметры | Описание |
|---|---|
name | Имя фильтра. Обязательный атрибут, каждый фильтр в коллекции должен иметь уникальное значение. |
reference
Содержит произвольный фрагмент sql, который может содержать заглушки для параметров запроса вида {натуральное число}
| Параметры | Описание |
|---|---|
placeholder | Идентификатор опорной заглушки, которая используется для определения места вставки фрагмента при применении фильтра. |
criteria
Содержит фрагмент sql, вычисляющий условие. Если используется, присоединяется к запросу с помощью ключевого слова AND. Может быть параметризирован аналогично reference.
| Параметры | Описание |
|---|---|
placeholder | Идентификатор опорной заглушки, которая используется для определения места вставки фрагмента при применении фильтра. |
generator
Содержит идентификатор класса процедурной генерации результирующей выборки для коллекции. Если указан одновременно с prototype/counting-prototype/filter, последние игнорируются AF5.
| Параметры | Описание |
|---|---|
class-name | Идентификатор класса-генератора. Должен совпадать со значением атрибута name аннотации server-component класса, реализующего интерфейс CollectionDataGenerator. |
|
Теги и атрибуты: |