<action-mappings>元素
<action>子元素的属性
| |
属 性
|
描 述
|
attribute | 设置和Action关联的FormBeans在request/session内的属性key,通过request/session的 getAttribute(attribute)方法返回该FormBean的实例 |
className | 和<action>元素对应的配置元素,默认为org.apache.struts.action.ActionMapping |
forward | 指定局部转发项 |
include | 指定包含的URL路径 |
input | 指定表单输入页面的URL路径,当表单验证失败时将请求转发到该URL |
name | 指定同该Action关联的FormBean的引用标识 |
path | 指定Action的访问路径,即该Action在引用中的标识名,以“/”开头 |
parameter | 指定Action的参数,在Action类的execute()方法中调用ActionMapping对象的 getParameter()方法来读取 |
roles | 指定允许调用该Action的安全角色。多个角色之间用逗号分隔 |
scope | 实例范围,request或session,默认为request |
type | 指定Action类的完整类路径和类名 |
unknown | 若该属性为 true,则可以处理用户发出的无效Action URL,默认为 false |
validate | 指定是否调用FormBeans的validate()方法,默认为 false |
form-beans元素
<form-bean>子元素的主要属性
| |
属 性
|
描 述
|
className | 指定和<form-bean>元素对应的配置类,默认值为 org.apache.struts.config.FormBeanConfig,自定义的配置类必须扩展该类 |
name | 指定该ActionForm的唯一标识名,struts框架用该标识来引用这个Bean,必须指定 |
type | 指定ActionForm的完整类路径和类名,必须指定 |
如果配置动态ActionForm则还必须配置<form-bean>元素的<form-property>子元素,用来指定表单字段.
子元素 <form-property> 元素的主要属性
| |
属 性
|
描 述
|
className | 指定和<form-property>元素对应的配置类,默认值为org.apache.struts.config.FormPropertyConfig |
initial | 设置表单属性的初始值,必须指定 |
name | 指定该字段的名字,必须指定 |
type | 指定该字段的类型,对于JAVA类必须指定完整类路径,必须指定 |
<global-exceptions>元素用于定义全局异常
例: <global-exceptions> <exception key="error.invalidlogin" path="/login.jsp" scope="request" type="java.lang.Exception"/> </global-exceptions> |
<exception>子元素的属性
| |
属 性
|
描 述
|
className | 指定和<exception>元素对应的配置类,默认为: org.apache.struts.config.ExceptionConfig |
handler | 指定异常处理类,默认为: org.apache.struts.action.ExceptionHandle |
key | 该异常的Key |
path | 当异常发生时的转发路径 |
scope | 实例范围,request或session,默认为request |
type | 指定所需处理的异常类的名了,必须指定 |
bundle | 指定Resource Bundle |
<global-forwards>元素
全局转发用来在创建整个应用范围内可以见的转发映射。在<global-forwards>中可以定义多个
<forward>子元素项。
例: <global-forwards> <forward name="global" path="/welcome.jsp"/> </global-forwards> |
<forward>子元素的属性
| |
属 性
|
描 述
|
className | 指定和<forward>元素对应的配置类,默认值为: org.apache.struts.action.ActionForward |
contextRelative | 当该属性为 true 时,表示 path 属性相对于当前上下文,当该属性为 false 时, 表示 path 属性相对于应用。默认为false |
name | 引用标识,必须指定 |
path | 转发路径URL |
redirect | 当该属性为 true 时,表示执行重定向操作,当该属性为 false 时, 表示执行请求转发操作。默认为false |
<message-resources>元素
用于配置Resource Bundle,每个Resource Bundle指定了对应的消息资源文件,用于在应用中输出本地化消息文本。
用于配置Resource Bundle,每个Resource Bundle指定了对应的消息资源文件,用于在应用中输出本地化消息文本。
例: <message-resources key="myResources" parameter="login.myResources"/> 在页面中使用bean标记 <bean:message key="msgKey" bundle="myResources"/> 输出myResources.properties这个资源文件中msgKey定义的消息文本。 |
<message-resources>元素的属性
| |
属 性
|
描 述
|
className | 指定和<form-bean>元素对应的配置类,默认为 org.apache.struts.config.MessageResourcesConfig |
factory | 指定消息资源的工厂类,默认为 org.apache.struts.util.PropertyMessageResourcesFactory |
key | 指定Resource Bundle存放在ServletContext对象中时使用的属性key,默认值为 Globals.MESSAGE_KEY定义的字符串常量。只允许一个Resource Bundle采用默认属性key |
null | 指定MessageResources对未知消息的处理方式。为true将返回空字符串,若为false 则返回类似"???global.label.missing???"的字符串,默认为true |
parameter | 指定对应该Resource Bundle的消息资源文件。如若设置为package1.myResources 则对应的资源文件为WEB-INF/classes/package1/myResources.properties |