struts-config.xml配置文件详解-CSDN博客

struts-config.xml配置文件详解

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-sourcetype=”org.apache.commons.dbcp.BasicDataSource”>

<set-property property=”autoCommit”value=”true”/>

<set-property property=”description” value=”MYSQLData 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>元素：用来配置多个ActionFormBean。

包含<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 fora 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>

<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关联的ActionFormBean在request或session范围内的属性key。例如，假定FormBean存在于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关联的ActionFormBean的名字。该名字必须在<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：指定是否要先调用ActionFormBean的validate（）方法。默认为true

<Action>元素的forward，includes，type属性相互排斥（即只能设置其中一项）。

Example：

<Action path=”/search”

type=”addressbook.actions.SearchAction”

name=”searchForm”

scope=”request”

validate=”true”

input=”/search.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>元素：用来配置resourcebundle，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-inclassName="org.apache.struts.tiles.TilesPlugin">

<set-property property="definitions-config"

value="/WEB-INF/tiles-defs.xml" />

<set-property property="moduleAware" value="true"/>

</plug-in>

（2）<plug-inclassName="org.apache.struts.validator.ValidatorPlugIn">

<set-property

property="pathnames"

value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml"/>

</plug-in>