Привязки к данным (Data Bindings)

Вся необходимя информация для привязки данных к компонентам на странице содержится в файле PageDef.

Для просмотра привязок достаточно открыть страницу на редактирование и переключиться на вкладку bindings.

Или можно выбрать страницу, нажать на ней правой кнопкой мыши и выбрать “Go To Page Definition”.

Типы привязок:

• Привязки атрибутов – используются для привязывания отдельного атрибута в наборе данных.
• Привязки таблиц – используются для определения содержимого таблиц. Связанных с наборами данных.
• Привязи действий – используются для определния привязки стандартных операций, таких как Commit.
• Привязки методов – подоны привязкам действий, за исключением того, что используются для пользовательских методов, а не для стандартных операций.
• Привязки списков – используются для определения содеримого списочных компонентов, связанных с данными, таких как группы кнопок-переключателей (radio group) или ниспадающие списки.
• Привязки навигационных списков – используются для манипулировании и идентификации теущей строки в наборе строк.
• Булевы привязки – используются для определения набора улевых опций. Такие привязки используюются на страницах JSF для флагов.
• Привязки деревьев – определяют набор данных типа “master-detail” для заполнения иерархических компонентов типа деревьев или табличных деревьев.

Привязка таблиц:

Привязка таблиц похожа на привязку атрибутов, за исключением того, что каждая отдельная привязка инкапсилирует в себе несколько атрибутов для отображения, а не один.

<table id="EmployeeUpdateable1"
          IterBinding="employeeUpdateable1Iterator">

    <AttrNames>
      <Item Value="EmplyeeId"/>
      <Item Value="FirstName"/>
      <Item Value="LastName"/>
      <Item Value="Email"/>
      <Item Value="PhoneNumber"/>
      <Item Value="HireDate"/>
      <Item Value="JobId"/>
      <Item Value="ManagerId"/>
      <Item Value="DepartmentId"/>

    </AttrNames>
</table>

Следующий фрагмент кода интерфейса пользователя показыает часть табличного копонента, основанного на наборе данных EmployeeUpdateable1.

Для обращения к атриутам используется псевдоним row, определяемый атрибом var тега таблицы, который по умолчанию означает текущую строку. Например, выражение #{row.FirstName}, используемое в контексе таблицы, ссылается на атрибут FirstName текущей строки таблицы.

<af:table value="#{bindings.EmployeeUpdateable1.collectionModel}">
          var="row"
          rows="#{bindings.EmployeeUpdateable.rangeStart}"
          emptyText="#{bindings.EmployeeUpdateable.viewable?, No row yet':'Accesss Dinied'}"
          selectionState="#{bindings.EmployeeUpdateable.collectionModel.selectedRow}"
          selectionListener="#{bindings.EmployeeUpdateable.collectionModel.makeCurrent}">

<af:column sortProperty="FirstName"
          headerText="#{bindings.EmployeeUpdateable.labels.FirstName}">

<af:inputText
    value="#{row.FirstName}"
    simple="true"
    required="#{bindings.EmployeeUpdateable.attrDefs.FirstName.mandatory}"
    columns="#{bindings.EmployeeUpdateable.attrHints.FirstName.displayWidth}"/>

</af:column>

Атрибуты привязки таблицы доступные в языке выражений

Привязка действий (Action):

Операции уровня data control

Операции уровня data control доступны для компонентов ADF BC или других компонентов, у который значение свойства “supportsTransactions” в файле DataControls.dcx равно “true”.

Пример привязки (в файле PageDef) действия уровня data control для операции Commit:

<action id="commit"
    InstanceName = "HRServiceDataControl"
    DataControl = "HRServiceDataControl"
    RequiresUpdateModel="true"
    Action="100" />

id - идентификатор. Используется при привязке операции к элементу интерфейса.
InstanceName - значение этого свойства должно совпадать с именем компонента data control.
DataControl - определяет компонент data control, к которому применяется данная операция.
RequiresUpdateModel - булево значение, указывает должны ли какие-лио изменения на странице применяться к уровню Model до выполнения операции.
Action - числовой код, указыающий, что делать. Каждая операция имеет уникальный код. 100 - Commit; 101 - Rollback.

Операции с наборами данных

Большинство операций связано с наборами данных или, строго гоовря, с итераторами.

<action id="First"
    RequiresUpdateModel="true"
    Action="12"
    IterBinding="EmployeesUpdateableIterator" />

Привязка действий в интерфейсе пользователя.

<af:commandButton actionListener="#{bindings.First.execute}"
    text="First"
    disabled="#{bindings.First.enabled}"

actionListener - код, который выполянется до основного действия, заданного в атрибуте action элемента commandItem.

<af:commandButton actionListener="#{bindings.Commit.execute}"
    action="Home"
    text="Save and return" />

Сначала выполняется операция commit, затем осуществляется навигационное действие action.

Операции с параметрами (execute with params)

Некоторые операции, наиболее важная из которых - ExecuteWithParams, принимают аргументы. Операции ExecuteWithParams принимают столько аргументов, сколько определено переменных связывания в SQL-запросе соответствующего объекта представления.

Создание формы с параметрами на странице создает привязку к операции в файле PageDef, при этом на странице также создается по полю ввода для каждого аргумента операции и кнопка для выполеннеия этой операции.

Для приимера возьмем операцию ExecuteWithParams для набора даных DepartmentList1. Объект представления имеет единственную переменную связыания :location. JSF- тери выглядят следующим образом.

<af:inputText value="#{bindings.location.inputValue}"
    value="#{bindings.location.label}"
    required="#{bindings.location.mandatory}"
    columns="#{bindings.location.displayWidth}">

<af:validator binding="#{bindings.location.validator}" />
<f:convertNumber groupingUsed="false"
    pattern="#{bindings.location.format}" />

</af:inputText>


<af:commandButton actionListener="#{bindings.ExecuteWithParams.execute}"
    text="ExecuteWithParams"
    disabled="#{!bindings.ExecuteWithParams.enabled}" />

Определение привязки в файле PageDef тега af:commandButton выглядит следующим образом:

<action id="ExecuteWithParams"
   IterBinding="DepartmentList1Iterator"
   InstanceName="HRServiceDataControl.DepartmentList1"
   DataControl="HRServiceDataControl"
   RequiresUpdateModel="true"
   Action="95">

   <NamedData NDName="location"
              NDType="oracle.jbo.domain.number"
              NDValue="${bindings.DepartmentList1_location}" />

</action>

Вы видите, что операция ExecuteWithParams имеет код операции 95, и что она привязана к итератору DepartmentList1Iterator. Кроме того, вы видите дочерний элемент тега action - элемент NamedData.

NamedData используется для определения аргументов, которые система framework должна передать операциям и методам, имеющим параметры. У этого элемента есть следующие атрибуты:

• NDName - этот атрибут означает имя аргумента. Присвоение имени важно в случае, если вы соираетесь программно задать значение аргумента до вызова связанного метода.
• NDType - этот атрибут определяет тип данных аргумента.
• NDValue - это занчение, которое надо передать параметру. Оно может ыть задано литералом или, как в данном примере, выражением.

Выражение ${bindings.DepartmentList1_location} привязывает значенине локальной переенной DepartmentList1_location к аргументу вызываемой операции. Таким образом мы видим связь между полем ввода в форме параметров и вызовом операции. Поле ввода устанавливает значение локальной переменной, а операция передает это значение на ровень модели.

Привязка методов:

Привязка методов почти идентична привязке действий, используемой для доступа к операциям. Единственное отличие между пользовательскими методами и операциями - методы могут возвращать результат. Этот результат может быть затем привязан к странице и обработан так же как оычный атрибут.

Пример XML кода в файле PageDef для привязки методов:

<methodAction id="searchByLocationId"
    InstanceName="HRServiceDataControl.DepartmentList1"
    DataControl="HRServiceDataControl"
    MethodName="searchByLocationId"
    RequiresUpdateModel="true"
    Action="999"
    IsViewObjectMethod="true"
    IterBinding="DepartmentsList1Iterator">

  <NamedData NDName="locationId"
      NDValue="10"
      NDType="oracle.jbo.domain.number" />
</methodAction>