EGL 的 Page Designer 支持

在 EGL Web 项目中创建 JSP 文件时,EGL 会自动创建页面处理程序,并且该页面处理程序将包括要定制的 EGL 框架代码。然后在 Page Designer 中执行下列任务:
  1. 将组件从选用板中拖到 JSP 中
  2. 使用“属性”视图设置颜色之类特定于组件的特征并设置绑定,绑定是组件与数据或逻辑之间的关系
可执行特定于 EGL 的工作:

在 Page Designer 中使用源代码选项卡时,可手工将 JSP 文件(具体地说,JavaServer Faces 文件)中的组件绑定至页面处理程序中的数据区和函数。尽管 EGL 是不区分大小写的,但 JSP 文件中引用的 EGL 名称的大小写必须与 EGL 变量或函数声明的大小写相同;如果未能保持完全匹配,将发生 JavaServer Faces 错误。建议在将该变量或函数绑定至 JSP 字段后不要更改 EGL 变量或函数的大小写。

有关命名问题的详细信息,请参阅对 JSP 文件中的 EGL 标识和生成的 Java™ bean 的更改

将组件绑定至页面处理程序中的数据区

JSP 上的大多数组件都与数据具有一对一的相关性。例如,文本框显示与该文本框绑定的 EGL 项的内容。如果用户更改了数据,则输入文本框还将更新该 EGL 项。

当指定复选框组、列表框、单选按钮组或组合框时,情况更为复杂。在那些情况下,需要两种不同类型的绑定:
  • 一种类型是将组件绑定至要显示给用户的文本。列表框中的项的文本是一个示例。
  • 另一种类型是将组件绑定至页面处理程序数据区,该数据区接收值以指示用户的选择。例如,您可以创建数据项以接收用户选择的列表框项的数字索引。
在“属性”视图中,可以执行下列两个过程中的任何一个过程来将组件绑定至用户见到的文本:
  • 可以使用添加选项来指示组件与单个字符串相关联,可以显式地指定该字符串,也可以通过标识页面处理程序项来指定该字符串
  • 可以使用添加选项集合来指示组件与字符串列表相关联,可以显式地指定字符串列表,也可以通过标识页面处理程序区域(如数据表或一组字符项)来指定字符串列表

另外,可以通过将一组字符项从“页数据”视图拖至该组件以将单选组件(组合框、单选列表框或单选按钮组)绑定至该组字符项。

要将组件绑定至数据区(该数据区将接收指示用户的选择的值),可以使用“页数据”视图或“属性”视图来进行。该过程与绑定任何组件(甚至是简单的文本框)时的过程相同。

如果值只能是两个备用项中的一个,则可以将该组件绑定至 EGL 项,该项的项属性布尔值设置为 yes。该组件用下列其中一个值来填充该项:
  • 对于字符项,该值是 Y(表示 yes)或 N(表示 no)
  • 对于数字项,该值是 1(表示 yes)或 0(表示 no)

当复选框显示时,状态(是否已选中)视绑定项中的值而定。

有关可以应用于页面处理程序中的数据项的属性的详细信息,请参阅页项属性

将组件绑定至函数

在将命令按钮或命令超链接拖放到页面上之后,可以将该组件绑定至现有 EGL 函数或 Page Designer 创建的事件处理程序:
  • 可以通过下列任何一种方式来将组件绑定至现有事件处理程序:
    • 通过将 EGL 函数从“页数据”视图中的“操作”节点拖至组件(按照建议)
    • 通过在“快速编辑”视图中打开组件
    • 通过右键单击组件并选择编辑 Faces 命令事件
  • 当在“快速编辑”视图中打开组件或者右键单击组件并选择编辑 Faces 命令事件时,可以让 Page Designer 创建新的事件处理程序

如果 Page Designer 在页面处理程序中创建了事件处理程序并允许您访问该页面处理程序函数,则函数名就是工具指定的按钮标识加上字符串“Action”。如果该名称对页面处理程序而言不是唯一的,则 Page Designer 将对函数名追加一个数字。

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