CM. Руководство разработчика
Дерево страниц
Skip to end of metadata
Go to start of metadata

Вы просматриваете старую версию данной страницы. Смотрите текущую версию.

Сравнить с текущим просмотр истории страницы

« Предыдущий Версия 6 Следующий »

Корневой элемент collection.  Пространство имен: configuration

Краткое описание

Представления, используемые AF5, называются коллекциями. В отличие от обычных представлений реляционной БД, коллекции AF5 не хранятся в самой БД, а хранятся в конфигурационных файлах AF5.

Структура XML 
<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.
Статус

В РАБОТЕ

Комментарий

Теги и атрибуты:

  • Нет меток