struts-config.xml配置文件详解

常用配置：

１．<struts-config>元素：struts配置文件的根元素。（和它对应的配置类为org.apache.struts.config.MouleConfig类）
8个子元素：（先后顺序不能变）
<data-sources>，
<form-beans>，
<global-exceptions>，
<global-forwards>，
<action-mappings>，
<controller / >，
<message-resources / >，
<plug-in />。
２．<data-sources>元素：用来配置应用所需要的数据源。
包含0，1或者多个<data-source>元素，该元素用于配置特定的数据源。<data-source>元素包含多个<set-property>元素，<set-property>元素用于设置数据源的各种属性。
Example：
<data-sources>
<data-source type=”org.apache.commons.dbcp.BasicDataSource”>
<set-property property=”autoCommit” value=”true”/>
<set-property property=”description” value=”MYSQL Data Source”/>
<set-property property=”driverClass” value=”com.mysql.jdbc.Driver”/>
<set-property property=”maxCount” value=”10”/>
<set-property property=”minCount” value=”2”/>
<set-property property=”user” value=”root”/>
<set-property property=”password” value=””/>
<set-property property=”url” value=”jdbc:mysql://localhost:3306/数据库名称”/>
</data-source>
</data-sources>
配置了数据源后，就可在Action类中访问数据源了
Javax.sql.DataSource dataSource = getDataSource(request);
Javax.sql.Connection myConnection = dataSource.getConnection();
配置多个数据源：
<data-source key=”A” type=”org.apache.commons.dbcp.BasicDataSource”>
…property as before…
</data-source>
<data-source key=”B” type=”org.apache.commons.dbcp.BasicDataSource”>
…property as before…
</data-source>
在Action中去得数据源：
dataSourceA = getDataSource(request,”A”);
dataSourceB = getDataSource(request,”B”);
３．<form-beans>元素：用来配置多个ActionForm Bean。
包含<form-bean>元素，该元素的属性有：
1.className:指定和<form-bean>元素对应的配置类，默认值为org.apache.struts.config.FormBeanConfig。如果在这里设置自定义类，则该类必须扩展FormBeanConfig类。
2.name:指定该ActionForm的唯一标识符，整个struts框架利用该标识符来引用这个bean。（必需的）
3.type:指定ActionForm类的完整实现类名（包括路径）。（必需的）
Example1:
<form-bean name="UserLoginForm"
type="com.free.web.struts.form.UserLoginForm">
</form-bean>
Example2（动态ActionForm）:
<!-- sample form bean descriptor for a DynaActionForm
<form-bean
name="logonForm"
type="org.apache.struts.action.DynaActionForm">
<form-property
name="username"
type="java.lang.String"/>
<form-property
name="password"
type="java.lang.String"/>
</form-bean>
4.<global-exceptions>元素：用于配置异常处理类。
包含多个<exception>元素:用来设置java异常和异常处理类org.apache.struts.action.ExceptionHandler之间的映射。
属性：className:指定和<exception>元素对应的配置类。默认值为org.apache.struts.config.ExceptionConfig。
Handler:指定异常处理类。默认值为org.apache.struts.action.ExceptionHandler。
Key:指定在Resource Bundle中描述该异常的消息key。
Path:指定当一场发生时的转发路径。
Scope:指定ActionMessages实例的存放范围，可选值包括request和session。默认值为request。
Type:指定所需处理的异常类的名称。（必需的）
Bundle:指定Resources Bundle。
Example:
<global-exceptions>
<exception
key="expired.password"
type="app.ExpiredPasswordException"
path="/changePassword.jsp"/>
</global-exceptions>
5.<global-forwards>元素：用来声明全局的转发关系。
包含多个<forward>元素，<forward>元素用于把一个逻辑名映射到特定的URL。
属性：className:指定和<forward>元素对应的配置类。默认值为org.apache.struts.action.ActionForward。
contextRelative:如果此项为true,表示当path属性以”/”开头时，给出的是相对于当前上下文的URL。默认值为false。
Name:转发路径的逻辑名。（必需的）
Path:指定转发或重定向的URL。（必需的）而且必须以”/”开头。contextRelative为true时，表示URL路径相对于当前上下文（context-ralative）; contextRelative为false时，表示URL路径相对于当前应用（application-ralative）;
Redirect:此项为true,执行重定向操作；为false,执行请求转发操作。
Example：
<global-forwards>
<!-- Default forward to "Welcome" action -->
<!-- Demonstrates using index.jsp to forward -->
<forward
name="welcome"
path="/Welcome.do"/>
</global-forwards>
如果.jsp文件把请求转发给Action,可以使用一下代码：
<html:link forward=”forward1”>
如果Action把请求转发给.jsp文件,可以使用一下代码：
Return （mapping.findForward(“forward2”)）;
6.<action-mappings>元素：包含<action>元素，描述了从特定的请求路径到相应的Action类的映射。
在<action>元素中可以包含多个<exception>和<forward>元素，它们分别配置局部的异常
处理及请求转发仅被当前的Action所访问。
属性：
（1） attribute： 设置和Action关联的ActionForm Bean在request或session范围内的属性key。例如，假定Form Bean存在于request范围内，并且此项设置为”myBean”，那么request.getAttribute(“myBean”)就可以返回该Bean的实例。
（2） className：和<Action>元素对应的配置元素。默认值为org.apache.struts.action.ActionMapping。
（3） forward：指定转发的URL路径。
（4） includes：指定包含的URL路径。
（5） input：指定包含输入表单的URL路径。当表单验证失败时，将把请求转发到该URL。
（6） name：指定和该Action关联的ActionForm Bean的名字。该名字必须在<form-bean>元素中一定过。
（7） path：指定访问Action的路径，它以”/”开头，没有扩展名。
（8） parameter：指定Action的配置参数。在Action类的execute（）方法中，可以调用ActionMapping对象的getParamter（）方法来读取该配置参数。
（9） roles:指定允许调用该Action的安全角色。多个角色之间以逗号隔开。在处理请求时，RequestProcessor会根据该配置项来决定用户是否有调用Action的权限。
（10） scope：指定ActionForm的存在范围。可选值为request和session。默认为session
（11） type：指定实现该Action类的真实类的路径和名称。（完整类名）
（12） unknown：如果此项为true，表示可以处理用户发出的所有无效的ActionURL。默认值为false。
（13） validate：指定是否要先调用ActionForm Bean的validate（）方法。默认为true
<Action>元素的forward，includes，type属性相互排斥（即只能设置其中一项）。
Example：
<Action path=”/search”
type=”addressbook.actions.SearchAction”
name=”searchForm”
scope=”request”
validate=”true”
input=”/search.jsp”>
<forward name=”success” path=”/display.jsp”/>
</action>
注意：局部<forward>元素和<exception>元素的优先级大于全局的。
7.<controller>元素：用于配置ActionServlet。
属性：
（1） bufferSize：指定上载文件的输入缓冲的大小。默认值：4096
（2） calssName：指定和<controller>元素对应的配置类。默认值为org.apache.struts.config.ControllerConfig。
（3） contentType：指定响应结果的内容类型和字符编码。默认值为text/html。如果在Action或jsp网页中也设置了内容类型和字符编码，将会覆盖该设置。
（4） locale：指定是否把Locale对象保存到当前用户的session中。默认值false
（5） processorClass：指定负责处理请求的Java类的完整类名。默认值为org.apache.struts.action.RequestProcessor。或者扩展了该类的自定义类。
（6） tempDir：指定处理文件上载的临时文件目录。如果没有设置此项，将采用Servlet容器为Web应用分配的临时工作目录。
（7） nochache：如果为true，在响应结果中将加入特定的头参数：pragma，cache-control和Expires，防止页面被存储在客户浏览器的缓存中。默认值为false。
Example：
<controller
contentType=”text/html;charset=UTF-8”
locale=”true”
processorClass=”CustomRequestProcessor”/>
8.<message-resources>元素：用来配置resource bundle，resource bundle用于存放本地化消息文本。
属性：
（1） className：和.<message-resources>元素对应的配置类。默认值为org.apache.struts.config.MessageResourcesConfig
（2） factory：指定消息资源的工厂类。默认值为org.apache.struts.util.property.MessageResourcesFacotry
（3） key：绑定在这个资源包中的ServletContext的属性主键，缺省值是Action.MESSAGES_KEY.
（4） Null：指定MessageResources类如何处理未知的消息key。如果此项为true，将返回空字符串。如果为false，将返回类似”???global.label.missing???”的字符串，默认值为true
（5） Parameter：指定recourse bundle的消息资源文件名。该路径相对于WEB-INF/classes而言。
Example:
<message-resources parameter="MessageResources" />
9.<plug-in>元素：用于配置struts插件。
属性：className：指定struts插件类。该插件类必须实现org.apache.struts.action.PlugIn接口。
Example：
（1）<plug-in className="org.apache.struts.tiles.TilesPlugin" >
<!-- Path to XML definition file -->
<set-property property="definitions-config"
value="/WEB-INF/tiles-defs.xml" />
<!-- Set Module-awareness to true -->
<set-property property="moduleAware" value="true" />
</plug-in>

（2）<plug-in className="org.apache.struts.validator.ValidatorPlugIn">
<set-property
property="pathnames"
value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml"/>
</plug-in>