70. 在XPages中展现集合数据.pdfVIP

SSttaarrrrooww的的专专栏栏 IInntteerreessttiinngg ssttuuffff aabboouutt LLoottuuss DDoommiinnoo,, XXPPaaggeess,, JJaavvaaSSccrriipptt,, WWeebb aanndd LLooggiicc 00.. 在在XXPPaaggeess中中展展现现集集合合数数据据 分类： Lotus Notes杂谈 Xpages 2013-12-05 1 :43 16人阅读 评论 (2) 收藏 举报 Lotus NotesXPages 数据绑定机制 本文说的集合简单指多个具有同样结构的数据实体的总和 ，比如视图的部分 所有文档 ，查询数据库得到的记录 集 ，一组模型 （model ）对象等等。在web应用程序里通常用表格来显示这样一个集合。作为基于组件的web框 架 ，XPages提供了几种标准控件来显示这样一个集合 ：Repeat、View和Data Table。View用于显示一个Notes视 图 ；Data Table以一个表格的形式显示一个集合 ；Repeat控件最灵活 ，可以自定义重复的数据显示的形式。深入地 看 ，三者在机制上有很多共同点。它们都是通过value属性绑定到一个数据对象 ，这个数据对象 是一个 DataModel对象 ， 可以被接合 （adapt ）成一个DataModel对象。DataModel则是JSF里支持对子组件逐行处理 的组件 （如UIData ）数据绑定的数据源的抽象类 【注1】。在JDK里 ，DataModel有六个直接子类 ： ArrayDataModel,CollectionDataModel, ListDataModel, ResultDataModel, ResultSetDataModel,ScalarDataModel ，也意味着有六类对象可以被接合为一个DataModel ： Array、Collection、List、j avax.servlet.j sp.j stl.sql.Result、j ava.sql.ResultSet和一个单独的Java对象。至此我们 就清楚地知道XPages自带的Repeat、View和Data Table三种控件可以展示怎样的集合。 我们知道用View控件显示一个Notes视图时 ，可以用value和data两个属性任意一个来绑定数据源。设置value属性 在后台对应ponent.xp.XspViewPanel （View控件的Java类 ） 【注2】继承自 ponent.UIDataEx的setValue(j ava.lang.Obj ect value)方法 ，它又是覆盖 j ponent.UIData的setValue方法。设置data属性对应 ponent.xp.XspViewPanel的setData(com.ibm.xsp.model.DataSource data)方法。无论是哪 一种 ，最后都绑定到Notes视图的包装类com.ibm.xsp.model.domino.DominoViewData 【注3】 Data Table控件的情况简单些 ，绑定数据时使用value属性 ，对应Java类 ponent.xp.XspDataTableEx同样继承自继承自ponent.UIDataEx。 Repeat控件的value属性直接来自Java类ponent.UIRepeat的setValue(j ava.lang.Obj ect value)方法。 各种数据源和一个实例 除了View控件是为Notes视图量身定做的 ，Data Table和Repeat控件适合展示各种类型的集合数据 ，在上面提到的 六种可接合成DataModel的对象中 ，j avax.servlet.j sp.j stl.sql.Result和j ava.sql.ResultSet宜用于显示关系型数据库 的记录 ，Array、Collection、List和单独的Java对象则可用于业务逻辑遇到的各种模型数据。下面就用一个实例来 演示Repeat控件绑定到一个数组数据源。 样例的派车应用程序介绍 ：公司在毗邻的几个城市设有办公室 ，部分员工需要往返各个办公室工作。公司提供若干 车辆负责接送员工。需乘车前往异地的员工提前确定行程。公司希望设计一个系统 ，让员工自行填写乘车申请 ，负 责派车的专员根据申请定时制定出每日的乘车安排 ，并通知给相关员工。 这个系统