Struts bean 标记的属性

本文档描述在 Struts bean 标记库中定义的元素的属性。缺省情况下,这些元素中每个元素的名称都有 bean: 前缀。

每个 Struts 元素都有一定数目的属性,可使用元素的“属性”视图来设置这些属性。在使用元素的“属性”视图时,使用此“属性”的表来查找想要了解其更多详细信息的属性。某些属性具有相同名称,但在不同元素中有不同的用法。属性是按字母顺序列示的。

属性 所属元素 描述
arg0 message 指定第一个参数替换值(如果有的话)。
arg1 message 指定第二个参数替换值(如果有的话)。
arg2 message 指定第三个参数替换值(如果有的话)。
arg3 message 指定第四个参数替换值(如果有的话)。
arg4 message 指定第五个参数替换值(如果有的话)。
bundle message 和 write 指定存储包含消息的 MessageResources 对象的应用程序范围 bean 的名称。缺省名称是 Globals.MESSAGES_KEY。
filter write 如果设置为 false,则对于 HTML 中的敏感字符,将不过滤呈示的属性值。缺省情况下,这样的值被转换为其实体等价值。
format write 指定要用来将 bean 或属性值转换为 String 对象的格式字符串。缺省情况下,将根据键在消息资源中搜索 value 数据类型的格式字符串。
formatKey write 指定用来在应用程序资源中搜索格式字符串的键。
id define 指定将与指定属性的值一起提供的脚本变量(及相关联页范围属性)的名称。[必填]
ignore write 如果设置为 true 且由 name 属性和 scope 属性指定的 bean 不存在,则将返回而不写任何内容。如果设置为 false 且该 bean 不存在,则会抛出运行时异常。
key message 指定已请求消息的消息键,该消息键在消息资源中必须具有相应的值。缺省情况下,该键是从 nameproperty 属性获取的。
locale message 和 write 指定存储当前选择的语言环境对象的会话范围 bean 的名称。缺省名称是 Globals.LOCALE_KEY。
name define 指定访问其属性以定义新页范围属性的 bean 的属性名称(如果还同时指定了 property)或与此标记创建的新引用重复的 bean 的属性名称(如果未同时指定 property)。除非指定 value 属性或嵌套主体内容,否则此属性是必需的。
name message 指定访问其属性以检索由 property(如果指定了的话)所指定值的 bean 的属性名称。如果省略 property,则此 bean 本身的值将被用作消息资源键。
property define 指定要在由 name 指定的 bean 上访问的属性的名称。此值可以是简单、索引或嵌套属性引用表达式。 缺省情况下,将向由 name 标识的 bean 提供一个由 id 标识的新引用。
property message 指定要在由 name 指定的 bean 上访问的属性的名称。此值可以是简单、索引或嵌套属性引用表达式。缺省情况下,由 name 标识的 bean 的值本身将被用作消息资源键。
property write 指定要在由 name 指定的 bean 上访问的属性的名称。此值可以是简单、索引或嵌套属性引用表达式。缺省情况下,将呈示由 name 标识的 bean 本身。如果指定的属性返回空值,则不会呈示输出。
scope define、message 和 write 指定要搜索的变量范围以检索由 name 指定的 bean。缺省情况下,将应用 PageContext.findAttribute() 应用的缺省规则。
toScope define 指定将在其中创建新定义 bean 的变量范围。缺省情况下,在 page 范围内创建 bean。
type define 指定要作为 id 属性出现的值的标准类名。如果指定了 value 属性,则缺省名称为 java.lang.String,否则缺省名称为 java.lang.Object
value define 指定应对出现的 bean 应设置的 java.lang.String 值。除非指定 name 属性或嵌套主体内容,否则此属性是必需的。
相关任务
将 Struts 标记添加至 JSP 文件
相关参考
Struts 平铺标记的属性
Struts HTML 标记的属性
Struts 逻辑标记的属性
Struts 嵌套标记的属性
Struts 标记的属性
反馈
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.