PageHandler 部件属性

PageHandler 的属性是可选的,如下所示(特定于 PageHandler 字段的属性除外):
alias = "alias"
一个字符串,它包含在生成的输出的名称中。如果未指定别名,则改为使用 PageHandler 部件名。
allowUnqualifiedItemReferences = no, allowUnqualifiedItemReferences = yes
指定是否允许代码引用结构项但却不包括容器的名称,该容器是存放结构项的数据表、记录或表单。例如,请参照以下记录部件:
  Record aRecordPart type basicRecord
    10 myItem01 CHAR(5);
    10 myItem02 CHAR(5);
  end
    
以下变量基于该部件:
  myRecord aRecordPart;
如果接受 allowUnqualifiedItemReferences 的缺省值(no),则在引用 myItem01 时必须指定记录名,如以下赋值所示:
  myValue = myRecord.myItem01;
然而,如果将属性 allowUnqualifiedItemReferences 设置为 yes,则无需指定记录名:
  myValue = myItem01;

建议您接受缺省值,这样有助于实现最佳实践。通过指定容器名,可以减少对阅读代码的人以及对 EGL 造成的歧义。

EGL 使用一组规则来确定变量名或项名所引用的内存区。有关详细信息,请参阅对变量和常量的引用

handleHardIOErrors = yes, handleHardIOErrors = no
设置系统变量 VGVar.handleHardIOErrors 的缺省值。该变量控制在 try 块中的 I/O 操作发生硬错误后程序是否继续运行。该属性的缺省值为 yes,它将该变量设置为 1。

有关其它详细信息,请参阅 VGVar.handleHardIOErrors异常处理

includeReferencedFunctions = no, includeReferencedFunctions = yes
指示 PageHandler bean 是否包含既不在 PageHandler 中也不在 PageHandler 访问的库中的每个函数的副本。缺省值为 no,这表示如果在开发时按照建议遵守以下惯例,则可以忽略此属性:
  • 将共享函数放在库中
  • 将非共享函数放在 PageHandler 中

如果正在使用不在库中的共享函数,则仅当将属性 includeReferencedFunctions 设置为 yes 时才有可能进行生成。

localSQLScope = no, localSQLScope = yes
指示 SQL 结果集和预编译语句的标识对于 pageHandler 是不是局部的(在缺省情况下是局部的)。如果接受值 yes,则表示从 pageHandler 调用的不同程序可独立使用相同的标识。

如果指定 no,则标识在整个运行单元中共享。在当前代码中创建的标识在其它地方也是可用的,尽管其它代码可使用 localSQLScope = yes 来阻止访问这些标识。而且,当前代码可以引用在其它位置创建的标识,但仅当其它代码已经运行并且没有阻止访问时才会如此。

共享 SQL 标识的影响如下所示:
  • 可以在一个 pageHandler 或被调用程序中打开某个结果集并从另一个代码中获取该结果集中的行
  • 可以在一个代码中预编译某个 SQL 语句并且在另一个代码中运行该语句
msgResource = "logicalName"
标识显示错误消息时要使用的 Java™ 资源束或属性文件。资源束或属性文件的内容由一组键和相关的值组成。

当程序对 EGL 系统函数 sysLib.setError 的调用使用了特定值的键时,作为对该调用的响应,将显示该值。

onPageLoadFunction = "functionName"
PageHandler 函数的名称,当相关 JSP 最初显示 Web 页面时,该 PageHandler 函数接收控制权。此函数可用来设置页中显示的数据的初始值。此属性以前是 onPageLoad 属性。

传递至函数的自变量在引用时必须是兼容的,如 EGL 中的引用兼容性中所述。

scope = session, scope = request
指定在将 pageHandler 数据发送至 Web 页面后会发生的操作:
  • 如果作用域设置为 session(这是缺省值),pageHandler 变量值将保留在整个用户会话中,并且用户以后在访问同一 pageHandler 时不会重复调用 OnPageLoad 函数
  • 如果作用域设置为 request,pageHandler 变量值将丢失,并且用户在访问同一 PageHandler 时将重新调用 OnPageLoad 函数

建议显式设置此属性以表示您的决定,这会极大地影响 Web 应用程序的设计和操作。

throwNrfEofExceptions = no, throwNrfEofExceptions = yes

指定软错误是否导致抛出异常。缺省值为 no。有关背景知识信息,请参阅异常处理

title = "literal"
title 属性是一个绑定属性,它表示当您在 Page Designer 中工作时,该属性的赋值将被用作缺省值。该属性指定页面的标题。

literal 是加引号的字符串。

validationBypassFunctions = ["functionNames"]
标识一个或多个事件处理程序,它们是与 JSP 中的按钮控件相关联的 PageHandler 函数。用逗号将每个函数名与下一个函数名隔开。

如果在此上下文中指定事件处理程序,则当用户单击属于事件处理程序或与事件处理程序相关的按钮或超文本链接时,EGL 运行时将跳过输入字段和页验证。此属性对于保留用于结束当前 PageHandler 处理并将控制权立即转移至另一个 Web 资源的用户操作而言很有用。

validatorFunction = "functionName"
标识 PageHandler 验证器函数,在调用了所有项验证器之后,将调用这个 PageHandler 验证器函数,如使用 EGL 构建的 Web 应用程序中的验证中所述。 此属性以前是 validator 属性。
view = "JSPFileName"
标识与 PageHandler 绑定的 Java Server Pages(JSP)的名称和子目录路径。JSPFileName 是加引号的字符串。

缺省值是 PageHandler 的名称,并且文件扩展名为 .jsp。如果指定此属性,则包括文件扩展名(如果有的话)。

当保存或生成 PageHandler 时,EGL 会将一个 JSP 文件添加到项目中以便以后进行定制,除非在适当的文件夹(WebContent\WEB-INF 文件夹)中已存在同名的 JSP 文件(名称是在 view 属性中指定的)。EGL 决不会覆盖 JSP。

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