系统函数 sysLib.setError 将消息与页面处理程序中的项相关联,或者与整个页面处理程序相关联。该消息被放在 JSP 中的 JSF 消息或消息标记位置,并且是在相关 Web 页面显示时显示的。
如果验证函数调用 sysLib.setError,则当函数结束时将自动重新显示 Web 页面。
- itemInError
- 出错的页面处理程序项的名称。
- this
- 指的是从中发出 sysLib.setError 的页面处理程序。在这种情况下,消息不是特定于项的,而是与整个页面处理程序相关联。有关 this 的详细信息,请参阅对变量和常量的引用。
- msgKey
- 字符项或文字(具有 CHAR 或 MBCHAR 类型),它提供在运行时使用的消息资源束或属性文件的键。如果键是空白的,则表示该消息是消息插入的并置。
- itemInsert
- 作为输出消息插入而包括的字符项或文字。消息文本中的替换符号是用花括号括起来的整数,如以下示例所示:
文件名 {0} 无效
- msgText
- 当未指定其它自变量时可以指定的字符项或文字。此文本与整个页相关联。
可以将多个消息与一个项或页面处理程序相关联。当重新显示页时,EGL 运行时将显示消息。如果控制权被转发(明确地说,如果页面处理程序运行 forward 语句),则那些消息将丢失。