Вкладка Datasources позволяет управлять источниками данных для экранных компонентов, связанных с данными.
Для того чтобы добавить новый источник данных верхнего уровня, нажмите New.
Для того чтобы добавить вложенный источник данных, сначала выберите существующий источник данных верхнего уровня, а затем нажмите New nested.
Для источника данных можно установить следующие свойства:
- Type - тип источника данных
- Id - идентификатор истоника данных (должен быть уникальным внутри данного экрана)
- Entity - класс сущности, содержащейся в источнике данных. Для вложенных источников данных это свойство недоступно, потому что класс сущности неявно определяется атрибутом Property.
- View - представление для загрузки сущности из базы данных. Для вложенных источников данных это свойство недоступно, потому что класс сущности неявно определяется атрибутом Property.
- Datasource class - опциональный атрибут, задающий собственный класс реализации источника данных.
- Max results - если флажок установлен, источник данных типа "коллекция" будет ограничивать количество загружаемых экземпляров сущности. Данный атрибут не требуется, если совместно с источником данных используется компонент Filter, так как фильтр устанавливает данное значение динамически.
- Do not refresh - если флажок установлен, источник данных типа "коллекция" не будет загружать данные из среднего слоя. Флажок соответствует атрибуту
refreshMode="NEVER"
в XML.
- Load dynamic attributes - если флажок установлен, для всех содержащихся с источнике данных экземпляров сущности будут загружены динамические атрибуты.
- Allow commit - если выключен, изменения в сущностях, содержащихся в источнике данных, игнорируются. По умолчанию изменения отслеживаются и могут быть сохранены.
- Query - JPQL запрос, который возращает коллекцию экземпляров сущности. Это поле доступно только для источников данных типа
collectionDatasource
верхнего уровня. Нажмите Ctrl+Space
для вывода подсказки, которая отображает:
- после пробела - список имен сущностей;
- после точки (.) - список атрибутов сущности;
- после двоеточия (:) - список доступных префиксов параметров;
- после
:ds$
- список источников данных;
- после
:session$
- список предопределенных атрибутов сессии.
- Property - имя атрибута мастер-сущности, который содержит сущность данного вложенного источника данных.