Struts-config.xml配置文件讲解

Struts-config.xml配置文件讲解

Struts的核心是struts-config.xml配置文件，在这个文件里描述了所有的Struts组件。 在这里包括配置主要的组件及次要的组件，下面是struts-config.xml包含主要元素的内容： 一、    struts-config.xml的主要元素： <?xml version=”1.0” encoding=”ISO-8859-1”?> <!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 1.1//EN" "http://jakarta.apache.org/struts/dtds/struts-config_1_1.dtd"> <struts-config>        <data-sources>        <data-source>        </data-source>    </data-sources>    <form-beans>        <form-bean / >    </form-beans>    <global-forwards>        <forward / >    </global-forwards>    <action-mappings>        <action / >    </action-mappings>   <controller / >    <message-resources / >    <plug-in /> </struts-config>     注意：以上各元素的顺序是非常重要的，你的struts-config.xml配置文件必须按照这个顺序进行配置，否 则在你的容器启动的时候就会出错。 二、    struts-config.xml的子元素： 1．<icon / >子元素    它包含<small-icon / >及<large-icon / >，它的作用是图形化其父元素， <small-icon/>的内容是一个16x16的图像文件，而<large-icon/>的内容是一个32x32的图像文件。如下例子：    <icon>      <small-icon>          /images/smalllogo.gif      </small-icon>      <large-icon>         /images/largelogo.gif      </large-icon> </icon> 2．<display-name / >子元素    它提供对父元素的短文字（short textual）描述信息，如下：    <display-name>            short textual discription of its parent element    </display-name> 3．<description / >子元素    它提供对父元素的完全（full-length textual）的描述信息，如下：   <description>     full-length textual discription of its parent element   </description> 4．<set-property / >子元素        它用来设置它的父元素中设定的JavaBean的属性值，它一般用在指定的GenericDataSource 属性， 扩展的ActionMappings以及扩展的 global forwards。如下：        <set-property property="name of bean property" value="value of bean property" />          例如：         <set-property property="driverClass" value="org.gjt.mm.mysql.Driver" />         <set-property property="user" value="admin"/>         <set-property property="maxCount" value="4"/>         <set-property property="minCount" value="2"/>          <set-property property="password" value=""/>          <set-property property="url" value="jdbc:mysql://localhost:3306/struts"/> 三、    配置JDBC数据源 其配置形式如下： <data-sources> <data-source> <set-property property="driverClass" value="fully qualified path of JDBC driver"/> <set-property property="url" value="data source URL"/> <set-property property=”mincount” value="the minimum number of connections to open"/> <set-property property="password" value="the password used to create connections"/> <set-property property="user" value="the username used to create connections"/> </data-source> </data-sources> <data-source>的属性及其描述信息如下： 属  性              描 述 信 息 Key          绑定在ServletContext上的DataSource实例的索引键，              若不设定则缺省为Action.DATA_SOURCE_KEY，如果在应用程序中有多于一个的DataSource，              则必须设置Key的值。 DriverClass    所用的JDBC驱动类(必须的)如：com.microsoft.jdbc.sqlserver.SQLServerDriver url    所用的JDBC的URL(必须的)如：jdbc:microsoft:sqlserver://xg088:1433 MaxCount    同时打开的最大连结数，缺省值为2(可选的) MinCount    同时打开的最小连结数，缺省值为1(可选的) User    连结到数据库的用户名(必须的) Password    连结到数据库的密码(必须的) Description    关于DataSource的描述信息(可选的) ReadOnly    如果设为true，则表示该连结是只读的，缺省为false。(可选的) LoginTimeout    创建连结的最大允许时间，以秒为单位。(可选的) AutoCommit    如果为true，则每次execute之后会强制回滚。缺省为true。(可选的) 举例说明： <data-sources>     <data-source>         <set-property property=”key” value=” value="WILEY_DATA_SOURCE" /> <set-property property="driverClass" value="org.gjt.mm.mysql.Driver" /> <set-property property="url" value="jdbc:mysql://localhost/wileyusers" /> <set-property property="maxCount" value="5"/> <set-property property="minCount" value="1"/> <set-property property="user" value="sa"/> <set-property property="password" value="yourpassword"/> </data-source> </data-sources> 四、    配置FormBean <form-bean / >用来定义将要绑定到Action的FormBean的实例。语法如下：  <form-beans>     <form-bean name="name used to uniquely identify a FormBean"             type=”fully qualified class name of FormBean"/>  </form-beans> 例： <form-beans>     <form-bean name="lookupForm" type="wiley.LookupForm" /> </form-beans> 五、    配置全局转发    全局转发可以定义几个<forward/>子元素，struts首先会在<action-mappings>元素中找对应的<forward>， 若找不到，则到全局转发配置中找。语法如下： <global-forwards>   <forward name="unique target identifier" path="context-relative path to targetted resource "/> </global-forwards>    除了name及path属性之外，还有一个redirect属性，如果redirect设为true的时候，则用 HttpServletResponse.sendRedirect()方法，否则用RequestDispatcher.forward()方法，缺省为false。 注：如果为true，则用HttpServletResponse.sendRedirect()方法，此时存储在原来的HttpServletRequest中 的值将会丢失。 例子： <global-forwards> <forward name="success" path="/welcome.jsp"/> <forward name="failure" path="/index.jsp"/> </global-forwards> 六、    配置<action-mappings>    它可以定义几个<action / >子元素，它主要是定义Action实例到ActionServlet类中，语法如下： <action-mappings>  <action path="context-relative path mapping action to a request"    type="fully qualified class name of the Action class"    name="the name of the form bean bound to this Action">    <forward name="forwardname1" path="context-relative path"/>    <forward name="forwardname2" path="context-relative path"/>  </action> </action-mappings> <action/>属性及其描述信息如下： 属  性    描 述 信 息 Path    在浏览器的URL中输入的字符(必须的) Type    连结到本映射的Action的全称(可选的) Name    与本操作关联的Action Bean在<form-bean/>中定义name名(可选的) Scope    指定ActionForm Bean的作用域(session和request)，缺省为session。(可选的) Input    当Bean发生t误时返回的控制。(可选的) ClassName    指定一个调用这个Action类的ActionMapping类的全名。缺省用 org.apache.struts.action.ActionMapping，(可选的) Forward    指定处理相应请求所对应的JSP页面。(可选的) Include    如果没有forward的时候，它起forward的作用。(可选的) Validate    若为true，则会调用ActionForm的validate()方法，否则不调用，缺省为true。（可选的） 例子： <action-mappings> <action path="/lookupAction" type="wiley.LookupAction" name="LookupForm"   scope="request"   validate="true"   input="/index.jsp"> <forward name="success" path="/quote.jsp"/> <forward name="faliue" path="/index.jsp"/> </action> </action-mappings> 七、    配置RequestProcessor     在struts-config.xml文件中用<controller/>子元素来定义RequestProcessor，其语法格式如下： <controller processorClass="fully qualified class name" /> <controller />元素属性及其描述信息如下： 属  性    描  述 processorClass    指定自定义的RequestProcessor类的全名 BufferSize    指定用来下载所用的缓存大小。缺省是4096字节。 contentType    定义response文本类型，缺省是text/html Debug    定义当前系统的除错级别，缺省是0 Locale    如果是true，则在用户的session中存放Locale对象，缺省为true maxFileSize    指定下载文件最大的大小。缺省是250M multipartClass    指定去代替org.apache.struts.upload.DiskMultipartRequestHandler类的类的全名。 Nocache    如果是true，则会关闭每个response的缓存功能。缺省是false TempDir    指定上载文件所用的临时目录。缺省值由容器决定 例子： ① <controller processorClass="wiley.WileyRequestProcessor" /> ② <controller     contentType="text/html;charset=UTF-8"     debug="3"     locale="true"     nocache="true"     processorClass="org.apache.struts.action.RequestProcessor"/> 八、    配置Message Resources     在struts-config.xml文件中用<message-resources />元素来定义消息资源。其语法如下：        <message-resources  parameter="wiley.ApplicationResources"/> <message-resources />元素属性及其描述信息如下： 属  性    描  述 Parameter    给定资源文件全名 ClassName    定义处理消息资源的类名的全名，缺省是org.apache.struts.config.MessageResourcesConfig Factory    定义MessageResourcesFactory类的全名，缺省是 org.apache.struts.util.property.MessageResourcesFacotry Key    定义绑定在这个资源包中的ServletContext的属性主键，缺省值是Action.MESSAGES_KEY. Null    如果为true，则找不到消息key时，则返回null，缺省是true. 例子： ① <message-resources parameter="wiley.ApplicationResources"/> ② <message-resources     parameter="StorefrontMessageResources"     null="false"/> <message-resources     key="IMAGE_RESOURCE_KEY"     parameter="StorefrontImageResources"     null="false"/> 注意：设定key的目的如下： <html:img altKey="navbar.home.image.alt" bundle="IMAGE_RESOURCE_KEY"        pageKey="navbar.home.image" width="125" height="15" border="0"/> 这里说明要到StorefrontImageResources.properties资源文件中找主键值是”navbar.home.image”所对应的 值。 这里StorefrontImageResources.properties的内容如下： …… navbar.home.image=/images/home.gif navbar.home.image.alt=Home …… 此处navbar.home.image.alt说明的和<img alt=”Home”……/>一样。 九、    配置Plug-in 配置Plug-in如下： <plug-in className="wiley.WileyPlugin"/> 也可如下： <plug-in className="com.oreilly.struts.storefront.service.memory.StorefrontMemoryDatabasePlugIn">   <set-property property="pathname" value="/WEB-INF/database.xml"/> </plug-in>

struts-config.xml的配置详解

<struts-config>是struts的根元素，它主要有8个子元素，DTD定义如下：

 
<!DOCTYPE struts-config PUBLIC "-//Apache Software Foundation//DTDStruts Configuration 1.3//EN" "http://struts.apache.org/dtds/struts-config_1_3.dtd">

以上8个元素，下面一一描述：
1. date-sources元素
　　date-sources元素用来配置应用程序所需要的数据源。java语言提供了javax.sql.DateSource接口，

所有数据源必须实现该接口。如下配置：
<data-sources>
　　<data-sourcetype="org.apached.commons.dbcp.BasicDataSource">
　　　　………………
　　</data-source>
</data-sources>
在Action中访问方式如：
javax.sql.DataSource dataSource;
java.sql.Connection myConnection;
try
{
　　dataSource = getDataSource(request);
　　myConnection　＝　dataSource.getConnection();
}
…………
　　如果是多数据源，可用如下配置：
<data-sources>
　　<data-source key="a" type="org.apached.commons.dbcp.BasicDataSource">
　　　　………………
　　</data-source>
　　<data-source key="b"  type="org.apached.commons.dbcp.BasicDataSource">
　　　　……………… 
　　</data-source>
</data-sources>
访问方式：dataSource = getDataSource(request,"a");

 2. form-beans元素
　　该元素主要用来配置表单验证的类。它包含如下属性：
　　1. classname：一般用得少，指定和form-bean无素对应的配置类，默认为

org.apache.struts.config.FormBeanConfig，如果自定义，则必须扩展FormBeanConfig类。可有可无。
　　2. name：ActionForm Bean的惟一标识。必须。
　　3. type：ActionForm的完整类名。必须。
如下所示：
<form-beans>
　　<form-bean 
　　　　　　name="Loign"
　　　　　　type="com.ha.login">
　　</form-bean>
</form-beans>
　　如果是动态Action FormBean，还必须配置form-bean元素的form-property子元素。它包含四个属性

，上面三个，还有一个initial 元素：以字符串的形式设置表单字段的初始值，如果没有设置该属性，则

是基本类型为0，如果是对象则为null。可有可无。如下所示：
<form-beans>
　　<form-bean 
　　　　　　name="Loign"
　　　　　　type="com.ha.login">
　　　　　<form-property name="ok" type="java.lang.String"/>
　　　　　<form-property name="oks"  type="java.lang.String"/>
　　　　　<form-property name="okss" type="java.lang.Integer" initial="20"/>
　　</form-bean>
</form-beans>

 3. global-exceptions元素
　　该元素主要配置异常处理，它的exception子元素代表全局的异常配置。struts采取配置的方式来处

理异常。它用来设置java异常和异常处理类org.apache.struts.action.ExceptionHandler之间的映射。

它有七个属性，如下所示：
　　1. className：指定和exception元素对应的配置类，默认为：

org.apache.struts.config.ExceptionConfig。可有可无。
　　2. Handler：指定异常得理类，默认为：org.apache.struts.action.ExceptionHandler。可有可无
　　3. key：指定在Resource Bundle中描述该异常的消息key
　　4. path：指定当异常发生时的转发路径。
　　5. scope：指定ActionMessages实例的存放范围，可选值包括：request和session，默认为request

。可有可无。
　　6. type：指定所需处理异常类的名字，必须。
　　7. bundle：指定Resource Bundle
如下所示：
<global-exceptions>
　　<exception 
　　　　　　key="global.error.invalidlogin"
　　　　　　path="/error.jsp"
　　　　　　scope="request"
　　　　　　type="com.hn.tree"
　　/>
</global-exceptions>

 4. global-forwards元素
　　该元素主要用来声明全局的转发关系，它具有以下四个属性：
　　1. className：和forward元素对应的配置类，默认为：org.apache.struts.action.ActionForward

。可有可无。
　　2. contextRelative：此项为true时，表时path属性以＂/＂开头，相对于当前上下文的URL，默认为

false．可有可无。　
　　3. name：转发路径的逻辑名．必填。
　　4. path：转发或重定向的URL，当contextRelative=false时，URL路径相对于当前应用

（application），当为ture时，表示URL路径相对于当前上下文（context）。
　　5.  redirect：当此项为ture时，表示执行重定向操作。当此项为false时表示转向操作。默认为

false。
如下所示：
<global-forwards>
　　<forward  name="forms1"  path="/a.do"/>
　　<forward  name="forms2" path="/nb.jsp"/>
<global-forwards>

 5. action-mappings元素
　　描述从特定的请求路径到相应的Action类的映射。它具有以下几个属性：
　　1. attribute：设置和Action关联的ActionForm Bean在request和session范围内的key。如：Form

Bean存在于request范围内，此项设为“myBenas”，则在request.getAttribute("myBenas")就可以返回

该Bean的实例。
　　2. classsName：和action元素对应的配置元素，默认为：

org.apache.struts.action.ActionMapping.
　　3. forward：转发的URL路径。
　　4. include：指定包含的URL路径。
　　5. input：输入表单的URL路径，当表单验证失败时，将把请求转发到该URL。
　　6. name：指定和Action关联的Action FormBean的名字，该名字必须在Form-Bean定义过。
　　7. path：指定访问Action的路径，以“/”开头，无扩展名。
　　8. parameter：指定Actgion的配置参数，在Action类的execute()方法中，可以调用ActionMapping

对象的getParameter()方法来读取该配置参数。
　　9. roles：指定允许调用该Action的安全角色，多个角色之间用，隔开，在处理请求时，

RequestProcessor会根据该配置项来决定用户是否有权限调用Action权限。
　　10. scope：指定ActionForm Bean的存在范围，可选取为request和session，默认为session。
　　11. type：指定Action类的完整类名。
　　12. unknown：如果此项为true，表示可以处理用户发出的所有无效的ActionURL，默认为false；
　　13. validate：指定是否要调用Action FormBean的validate方法，默认值为ture.
注：forward、include、type属性只能选中其中一项。
如下：
<action path="/search"
　　　　type="zxj.okBean"
　　　　name="a1"
　　　　scope="request"
　　　　validate="true"
　　　　input="/b.jsp">
　　<forward name="tig" path="/aa.jsp"/>
</action>
注：此中的forward是指局部的转发路径。global-forwards表示全局的转发路径。

 6. controller元素
　　该元素用于配置ActionServlet。它具有以下属性。
　　1. bufferSize：指定上载文件的输入缓冲大小，可选，默认为4096
　　2. className：指定和controller元素对应的配置类，默认为

org.apache.struts.config.ControllerConfig
　　3. conentType：字符编码，如果在Action和JSP网页中设置了，则覆盖该设置。
　　4. locale：指定是否把Locale对象保存到当前用户的session中，默认值为false.
　　5. processorClass：指定负责请求的java类完整路径。
　　6. tempDir：指定处理文件的临时工作目录，如果此项没有设置，将采用Servlet容器为web应用分配

的临时工作目录。
　　7. nochache：如果为true：在响应结果中将加入特定的头参数：Pragma,Cache-Control和Expise，

防止页面被保存在客户端的浏览器中，默认为false
如下：
<controller
　　contentType="text/html;charset="UTF-8""
　　locale="true"
　　processorClass="con.ok"/>

 7. message-resources元素
　　主要配置本地化消息文本，它具有以下属性。
　　1. className：和message-resources元素对应的配置类，默认为

org.apache.struts.config.MessageResourcesConfig。
　　2. factory：指定消息资源的工厂类，默认为：

org.apache.struts.util.PropertyMessageResourcesFactory类
　　3. key：指定Resource Bundle存放的ServletContext对象中时采用的属性Key，默认由

Globals.MESSAGES_KEY定义的字符串常量，只允许一个Resource Bundle采用默认的属性Key。
　　4. null：指定MessageSources类如何处理未知消息的key，如果为true，则返回空字符串，如果为

false，则返回相关字串，默认为false
　　5. prameter：指定MessageSources的资源文件名，如果为：a.b.ApplicationResources，则实际对

应的文件路径为：WEB-INF/classes/a/b/ApplicationResources.properties.
如：
<message-resources null="false"parameter="defaultResource"/>
<message-resources key="num1" null="false"parameter="test"/>
访问为：
<bean:message  key="zxj"/>
<bean:message  key="zxj"  bundle="num1"/>
其中，zxj表法，messagesource资源文件中的一个字符串。

 8. plugin-in元素
　　配置Struts的插件，属性如下：
　　1. className：指定的Struts插件类，必须实现org.apache.struts.action.PlugiIn接口。如：
<plug-in
　　className="a.b.c.">
　　<set-property property="xxx"value="/WEB-INF/aa.xml"  />
</plug-in>

 后记，多模块的配置，可以供多个应用应用不同的struts-config.xml