可以在 EGL 文件中声明 pageHandler 部件,EGL 项目、包和文件对该部件作了描述。此部件是可生成部件,这意味着它必须位于文件的顶层,并且必须与文件同名。
以下是 pageHandler 部件的一个示例:
// Page designer requires that all pageHandlers
// be in a package named "pagehandlers".
package pagehandlers ;
PageHandler ListCustomers
{onPageLoadFunction="onPageLoad"}
// Library for customer table access
use CustomerLib3;
// List of customers
customerList Customer[] {maxSize=100};
Function onPageLoad()
// Starting key to retrieve customers
startkey CustomerId;
// Result from library call
status int;
// Retrieve up to 100 customer records
startKey = 0;
CustomerLib3.getCustomersByCustomerId(startKey, customerList, status);
if ( status != 0 && status != 100 )
setError("Retrieval of Customers Failed.");
end
end
Function returnToIntroductionClicked()
forward to "Introduction";
end
End
- PageHandler pageHandlerPartName ... end
- 将部件标识为 PageHandler 并指定部件名。有关命名规则,请参阅命名约定。
- pageHandlerProperty
- PageHandler 部件属性,如 PageHandler 部件属性中所示。
- use dataTablePartName, use libraryPartName
- 使用声明,它简化对数据表或库的访问。有关详细信息,请参阅使用声明。
- private
- 指示变量、常量或函数对于显示 Web 页面的 JSP 来说不可用。如果省略术语 private,则可以将变量、常量或函数与 Web 页面上的控件绑定。
- dataItemName
- 数据项(变量)的名称。有关规则,请参阅命名约定。
- primitiveType
- 对数据项指定的基本类型。
- length
- 结构项的长度,它是一个整数。基于结构项的内存区的值包括指定的字符或数字的数量。
- decimals
- 对于数字类型(BIN、DECIMAL、NUM、NUMC 或 PACF),可以指定 decimals,它是用来表示小数点后的位数的整数。最大小数位数是以下两个数字中较小的那一个:18 或声明为 length 的位数。小数点不与数据存储在一起。
- dataItemPartName
- dataItem 部件的名称,该部件是数据项的格式模型,如 typeDef 所述。dataItem 部件必须对 pageHandler 部件可见,如对部件的引用中所述。
- itemProperty
- 项属性。有关详细信息,请参阅页项属性。
- recordName
- 记录(变量)的名称。有关规则,请参阅命名约定。
- recordPartName
- 记录部件的名称,该部件是记录的格式模型,如 typeDef 所述。记录部件必须对 pageHandler 部件可见,如对部件的引用中所述。
- recordProperty
- 记录属性覆盖。有关记录属性的详细信息,根据 recordPartName 中的记录类型的不同,请参阅下列其中一项描述:
- itemName
- 您打算覆盖其属性的记录项的名称。
- itemProperty
- 项属性覆盖。有关详细信息,请参阅 EGL 属性与覆盖概述。
- constantName literal
- 常量的名称和值。有关规则,请参阅命名约定。
- arrayName
- 记录或数据项的动态或静态数组的名称。如果使用此选项,则右边的其它符号(dataItemPartName 和 primitiveType 等等)是指数组的每个元素。
- functionPart
- 嵌入的函数。有关语法的详细信息,请参阅 EGL 源格式的函数部件。