数据组件

数据组件是界面的不可见元素,提供加载数据、绑定数据到数据感知可视化组件以及将数据保存至数据存储的功能。有以下类型数据组件:

通常,数据组件在界面 XML 描述的 <data> 元素定义:

<data readOnly="true">
    <collection id="departmentsDc"
                class="ui.ex1.entity.Department">
        <fetchPlan extends="_base">
            <property name="employee" fetchPlan="_base"/>
        </fetchPlan>
        <loader id="departmentsDl">
            <query>
                <![CDATA[select e from uiex1_Department e]]>
                <condition>
                    <c:jpql>
                        <c:where>e.name like :name</c:where>
                    </c:jpql>
                </condition>
            </query>

        </loader>
        <collection id="employeesDc" property="employee"/>
    </collection>
</data>

数据组件可以与可视化组件以相同的方式注入到控制器中:

@Autowired
private CollectionLoader<Department> departmentsDl;

private String departmentName;

@Subscribe
public void onBeforeShow(BeforeShowEvent event) {
    departmentsDl.setParameter("name", departmentName);
    departmentsDl.load();
}

特定界面的数据组件注册在 ScreenData 对象中,这个对象跟控制器关联,可以通过控制器的 getScreenData() 方法获取。这个对象在需要加载界面所有的数据的时候很有用,示例:

@Subscribe
public void onAfterShow(AfterShowEvent event) {
    getScreenData().loadAll();
}
使用 DataLoadCoordinator facet 以声明式的方式将数据加载器和数据容器、可视化组件、界面事件进行关联。除非在需要设置一些加载参数的时候,才使用编程的方法,如 下面 例子所示。