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

要使用 Web 页面上的动态数据,需要定义数据源。可使用的一个动态数据源是关系记录列表。借助关系记录列表,可以显示关系数据库表中的多个记录。
当在页面上定义关系记录列表时,就会使它的数据可用于 Web 页面。以下是将关系记录列表添加至 Faces JSP 页面的几种方法:
注: 如果您想要将关系记录或关系记录列表添加至 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 页面上显示动态信息。此教程教您如何设计动态 Web 站点以便用作报纸的分类信息广告部分。此 Web 站点是一个使用 JavaServer Faces(JSF)组件和服务数据对象(SDO)组件的完整 J2EE Web 应用程序。此 Web 应用程序使用 JSF 技术来创建动态 Web 页面以链接至存储分类信息广告数据的数据库。教程:使用 JavaServer Faces 在 Web 页面上显示动态信息。此教程教您如何设计动态 Web 站点以便用作报纸的分类信息广告部分。此 Web 站点是一个使用 JavaServer Faces(JSF)组件和服务数据对象(SDO)组件的完整 J2EE Web 应用程序。此 Web 应用程序使用 JSF 技术来创建动态 Web 页面以链接至存储分类信息广告数据的数据库。

相关概念
在 Faces 应用程序中使用数据
相关任务
创建与关系数据库的连接
将关系记录数据添加至 Faces JSP 页面
将 Java Bean 添加至 Faces JSP 文件
将 Domino Notes 和视图添加至 Faces JSP 文件
在 JSP 文件之间传递参数

反馈