将关系记录列表添加至 Faces JSP 文件

演示
要使用 Web 页面上的动态数据,需要定义数据源。可使用的一个动态数据源是关系记录列表。借助关系记录列表,可以显示关系数据库表中的多个记录。

当在页面上定义关系记录列表时,就会使它的数据可用于 Web 页面。以下是将关系记录列表添加至 Faces JSP 页的几种方法:

要通过使用“数据”抽屉将关系记录列表添加至 Web 页面:

  1. 打开选用板上的“数据”抽屉。
  2. 将关系记录列表组件从选用板拖至想要显示数据的 Faces JSP 页。将打开“添加关系记录列表”向导。
    注: 如果打开“目标服务器”对话框,则从列表选择“WebSphere® Application Server V5.1”或“WebSphere Application Server V6.0”,然后单击确定
  3. 指定记录列表名称以在页面中使用。
  4. 如果已经在项目中别的地方定义了关系记录列表并且想要使用该列表中的数据,则选择重用现有记录或记录列表中的元数据定义并单击浏览以选择输入文件。
  5. 要自动创建具有数据字段的数据表,选择添加数据控件。否则,记录列表会被添加至“页数据”视图并可用于页面,但不会生成此列表的控件。以后,可将此记录列表从“页数据”视图拖至页面以使用数据表显示它。
  6. 单击下一步
  7. 在“记录列表属性”面板上,指定连接名称(或单击新建以创建新连接)。
    1. 如果单击新建,则将打开“新建连接”面板。
    2. 单击创建新的数据库连接。将打开“新建数据库连接”向导。有关使用此向导创建新的数据库连接的信息,请参阅主题“使用向导连接至数据库”。
  8. 一旦建立了连接,就选择一个表并单击下一步
  9. 在“选择列和其它的任务”面板上:
    1. 选择要包括在关系记录列表中的字段。
    2. 要进一步优化记录列表,可以单击下列其中一个任务或高级任务:
      • 修改主键:将打开“编辑主键”对话框并列示可用的列和主键列。使用箭头来更改主键列。注意:这只定义了此记录列表定义的主键,并未改变实际数据库的主键。
      • 排序结果:将打开“排序”对话框并列示可用的列。选择要排序的列并选择如何组织它们(升序或降序)。
      • 过滤器结果:将打开“过滤器”对话框。单击“添加(+)”按钮以打开“条件”对话框。这样,就可以过滤记录以便只显示那些满足特定条件的记录。
      • 通过关系添加另一个数据库表:将打开“创建关系”向导,可以从当前数据库创建现有关系或创建新关系。
      • 自动生成键:将打开“生成键”对话框。选择使用自动生成键,然后选择想要用于自动生成键的表和两个列。
      • 设置并发性控制:将打开“并发性”对话框。并发性控制使其它事务不可使用数据源的时间减至最短。例如,您可能具有会长时间占用数据源的运行时间很长的事务,而您想要使数据源被占用时间减至最短。也可以提供列级别的并发性控制。这允许您测试自从下拉原始数据以来,另一个事务是否更新了底层数据源。将通过 UPDATE 语句中的 WHERE 子句显式添加标记为要更新的列及其原始值,以便在更改了底层列值的情况下语句失败。这样就提供了列级别的并发性控制。如果自从初次检索数据以来没有更新底层列,则会落实暂挂更新并释放锁定。如果自从当前事务开始以来不能获取锁定或其它事务更新了列,则会回滚此事务。
    3. 单击下一步
  10. 在“配置数据控件”面板上:
    1. 如果先前选择了添加数据控件,则选择下列其中一种要创建的数据控件:
      • 多列数据表(每个数据条目为一个表行)
      • 单列数据表(每个条目为多个表行)
      • 单列数据表中的“无格式控件”
    2. 选择想要显示的列,输入列的标签,并选择每个列的控件类型。控件类型可包括“输出字段”、“输出格式化文本”、“组合框”、“输入字段”、“输入文本区域”以及其它内容。使用向上箭头和向下箭头来更改列的顺序。
    3. 单击选项以设置其它选项。具有以下选项卡的“选项”对话框将打开:
      • 标签 - 包含记录或数据表中的访问标签的选项。可以对齐标签以使得每个标签居中对齐、向左对齐或向右对齐。还可选择在每个标签后面添加冒号以及使每个标签的首字母大写。
      • 高级 - 在深度旁边输入深度级别。深度级别设置显示在“页数据”视图中的数据层数。如果选择深度为 3,则“页数据”视图以三层数据的形式显示关系记录列表(或其它数据源)。例如,如果第一层包括 Europe,第二层包括 Italy,第三层包括 Milan,则其它任何层(如 Milan 中的地点)都不会显示。另外,Milan 以下的层也不会出现在向导上并且不会生成任何控件。选择用作缺省深度以更改用户的缺省深度级别。选择只创建数据控件以便只在页面上创建数据控件。如果不选择此选项,则会创建数据控件和其它相关控件。例如,如果要创建“输入文本”组件并且选择了只创建数据控件,则将只在页面上创建该组件。然而,如果不选择此选项,则会创建“输入文本”组件以及“显示错误”组件和“标签”组件,还可能会创建提交按钮。选择在源代码中包括 <label> 标记以创建 <label> 标记,该标记可增强标签可访问性。
      • 按钮 - 如果正在更新记录,则会显示此选项卡。可选择添加提交删除按钮来帮助用户更新记录。
  11. 单击完成 这就为此页面定义了数据源并且该数据源显示在“页数据”视图中。如果选择了添加数据控件,则会生成这些控件。否则,必须从“页数据”视图拖动这些控件。
一旦页面上有了数据表,就可以设置该数据表和该数据表包含的任何其它组件的属性了。注意,已填写“数据表”的信息。
除了添加关系记录列表之外,还可以将“关系记录”添加至 Web 页面。

要了解有关数据表和关系记录列表、过滤关系记录列表、自动键生成的更多信息,学习以下教程:

使用 JavaServer Faces 在 Web 页面上显示动态信息

相关概念
Faces 组件
Faces 组件的数据访问
数据表组件

相关任务
创建 Faces 应用程序 - 概述
创建与关系数据库的连接
使用向导连接至数据库
将关系记录添加至 Faces JSP 文件
将 JavaBean 添加至 Faces JSP 文件
在 Faces JSP 文件中创建 Web Service
添加数据表
教程:使用 JavaServer Faces 在 Web 页面中显示动态信息

相关参考
Faces 组件参考
Faces 属性参考

使用条款 | 反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.