Struct2-配置文件:



整个配置我们可以分为两大块,一个是在web.xml文件中的配置,另一块是Struts2框架中的配置。框架中的配置又有执行环境的配置和Struts2组件配置。 




web.xml配置 


框架执行环境配置(全局配置选项):struts.properties文件 


组件配置文件:struts-default. xml, struts-plugin.xml, strtus.xml 




1.web.xml配置: 


FilterDispatcher是一个过滤器。注意,在Struts2.0.X的时候,使用的是 


org.apache.struts2.dispatcher.FilterDispatcher作为核心控制器,而Struts2.1 中改成了org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter。它是整个web应用的配置项,需要在web.xml中进行配置. 

[html] 
   view plain
   copy 
   
 
   
 
 
1.    
2. <filter>  
3. <filter-name>struts2</filter-name>  
4. <filter-class>  
5. org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter  
6. </filter-class>  
7. </filter>  
8. <filter-mapping>  
9. <filter-name>struts2</filter-name>  
10. <url-pattern>/*</url-pattern>  
11. </filter-mapping>  
12.



如果是一个基本的web应用,这样就足够了,剩下的就是配置web应用的一些执行环境配置(全局配置)和web应用中使用到的组件的配置,如action配置,拦截器的配置。 


web应用的执行环境主要是通过struts.properties来完成。应用中的组件配置主要是通过strtus.xml来完成。 



2. struts.properties 文件 


这个文件提供了一种更改框架默认行为方式的机制。在一般情况下,如果不是打算让调试更加方便的话,我们没有必要更改这个文件。哪么这些默认的属性在哪里存放呢? 


在项目的src目录中可以自己编写一个名称为struts.properties文件,编译以后就放到了/WEB-INF/classes中,Struts2框架在启动的时候,会自动读取这个文件,但是在读取这个文件之前,会先到struts2-core-xxx.jar包中加载名为default.properties文件,这个文件中定义了默认的配置,所以我们可以在strtus.properties中定义一些配置覆盖default.properties中的配置,如果没有struts.properties文件,则采用默认配置。 


打开default.properties文件我们会看到如下部分类容: 


打开该文件,可以看到一些全局的配置选项,在这些选项中,我们发现了有一些这样的配置,其中struts.action.extension 配置的就是Struts默认的请求后缀名。关于更多的配置的含义,后面用到了再讲解,现在暂时不必理会这些配置的含义. 

[html] 
   view plain
   copy 
   
 
   
 
 
1. ### Used by the DefaultActionMapper   
2. ### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do   
3. ### The blank extension allows you to match directory listings as well as pure action names   
4. ### without interfering with static resources.   
5. struts.action.extension=action,,   
6. ### This can be used to set your default locale and encoding scheme   
7. # struts.locale=en_US   
8. struts.i18n.encoding=UTF-8  
 


更改默认设置: 

 
    [html] 
    view plain
    copy 
    
 
    
 
  
1. ### Used by the DefaultActionMapper   
2. ### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do   
3. ### The blank extension allows you to match directory listings as well as pure action names   
4. ### without interfering with static resources.   
5. struts.action.extension=action,,   
6. ### This can be used to set your default locale and encoding scheme   
7. # struts.locale=en_US   
8. struts.i18n.encoding=UTF-8   
 
 
   [xml] 
   view plain
   copy 
   
 
   
 
 
1. ### Used by the DefaultActionMapper   
2. ### You may provide a comma separated list, e.g. struts.action.extension=action,jnlp,do   
3. ### The blank extension allows you to match directory listings as well as pure action names   
4. ### without interfering with static resources.   
5. struts.action.extension=action,,   
6. ### This can be used to set your default locale and encoding scheme   
7. # struts.locale=en_US   
8. struts.i18n.encoding=UTF-8



因为default.properties文件是存放在jar包中的,struts2启动的时候自动会寻找到。我们不能直接修改这个文件,但是我们可以使用struts.properties文件来覆盖default.properties文件中的内容。 


在web项目的src的根目录中新建一个struts.properties,然后将想要修改的属性添加到该文件中,就可以覆盖掉原来的配置.注意:这个文件存放在src的根目录中(编译之后放到了/WEB-INF/classes根目录中): 


[html] 
    view plain
    copy 
    
 
    
 
  
1. ##激活重新载入国际化文件的功能   
2. struts.i18n.reload=true   
3. ##修改请求后缀为action或者do   
4. struts.action.extension=action,do   
5. ##打开开发者模式,打开之后,我们修改配置文件之后不用重新启动服务器   
6. struts.devMode =true  
 
 
   [xml] 
   view plain
   copy 
   
 
   
 
 
1. ##激活重新载入国际化文件的功能   
2. struts.i18n.reload=true   
3. ##修改请求后缀为action或者do   
4. struts.action.extension=action,do   
5. ##打开开发者模式,打开之后,我们修改配置文件之后不用重新启动服务器   
6. struts.devMode =true


3. struts-default.xml 


这个文件用来加载默认启动的组件。它存放在struts2-core-xxx.jar包的根目录下,系统启动的时候会加载这个文件。这个文件中配置的组件有类型转换组件,拦截器组件还有结果类型组件等等,关于这些组件的概念后面将会讲到,这里只需要了解。 


4. struts-plugin.xml 


可以在struts2中使用插件,Struts2在启动的时候,会自动搜索classpath中的jar包中的struts-plugin.xml文件来加载插件。关于插件的应用,将会在后面讲到。 


5. struts.xml 


struts.xml文件中包含的是我们开发的Action的配置。如前面登录例子中的配置: 


[html] 
      view plain
      copy 
      
 
      
 
    
1. <?xml version="1.0" encoding="UTF-8"?>   
2. <!DOCTYPE struts PUBLIC   
3. "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"   
4. "http://struts.apache.org/dtds/struts-2.0.dtd" >   
5. <struts>   
6. <!-- 配置常量,覆盖default.properties中的配置 -->   
7. <constant name="struts.action.extension" value="do" />  
8. <!-- struts2的Action必须放在指定的包空间下 -->   
9. <package name="com.wq" extends="struts-default">   
10. <!-- 定义action -->   
11. <action name="login" class="com.wq.web.action.LoginAction">   
12. <!-- 定义处理结果和资源之间的映射关系 -->   
13. <result name="success">/welcome.jsp</result>   
14. <result name="error">/error.jsp</result>   
15. </action>   
16. </package>  
17. </structs>  
 
   

 
 
   [xml] 
   view plain
   copy 
   
 
   
 
 
1. <?xml version="1.0" encoding="UTF-8"?>   
2. <!DOCTYPE struts PUBLIC   
3. "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"   
4. "http://struts.apache.org/dtds/struts-2.0.dtd" >   
5. <struts>   
6. <!-- 配置常量,覆盖default.properties中的配置 -->   
7. <constant name="struts.action.extension" value="do" />  
8. <!-- struts2的Action必须放在指定的包空间下 -->   
9. <package name="com.wq" extends="struts-default">   
10. <!-- 定义action -->   
11. <action name="login" class="com.wq.web.action.LoginAction">   
12. <!-- 定义处理结果和资源之间的映射关系 -->   
13. <result name="success">/welcome.jsp</result>   
14. <result name="error">/error.jsp</result>   
15. </action>   
16. </package>  
17. </structs>


5.1在struts.xml中覆盖default.properties中的全局配置 


我们修改全局配置的时候,使用struts.properties文件来覆盖default.properties文件中的内容。实际上我们可以不用创建struts.properties文件也可以做到覆盖default.properties文件中的配置,就是直接在strtuts.xml文件中使用<constant>配置:见上面的例子中 



5.2将struts.xml拆分成多个配置文件 


可以想象,在web应用中还会不断的有action需要定义,这样struts.xml的配置会越来越多,文件会越来越大。 


为了避免struts.xml文件过于庞大,臃肿,提高strtus.xml文件的可读性,我们可以将一个struts.xml文件分解成多个配置文件,然后在strtus.xml文件中包含其它配置文件.这样struts2就可以使用模块化的方式来管理struts.xml配置文件了。 


我们可以在配置中使用<include> 来包含另外一个配置文件.下面我们新建一个struts-hello.xml文件,然后在struts.xml文件中包含该文件 



在structs2中配置文件中 

Structs标签中:<include file="struts-hello.xml" />   来引入structs-hello.xml文件实现模块化管理。 




6. 配置文件加载顺序 


配置文件的加载顺序从上到下依次是:我们可以打开struts的源代码,设置断点来跟踪启动顺序。通过分析源代码,得到如下结论: 


1.default.properties: 


该文件存放在strtus2-core-XXX.jar中的org.apache.struts2包中,默认全局配置 


2.struts-default.xml 


该文件存放在strtus2-core-XXX.jar中的根目录下,加载默认的组件,这些组件包括一系列的拦截器和转换器等 


3.struts-plugin.xml 


如果为应用配置了插件,则插件的jar文件中会存在这个文件,它会被自动加载 


4.struts.xml 


自己创建的配置文件,不能改名,用于存放自定义的组件如Action或者拦截器等。这个文件中也可以覆盖default.properties文件中的默认配置 


5.struts.properties 


自己创建的配置文件,不能改名,用于修改全局配置,一般我们将要修改的全局配置放到了struts.xml文件中,所以不需要配置这个文件.如果在struts.xml和struts.properteis中同时配置,则以strtus.properties中的为准 



7. struts.xml—包配置: 


在strtuts2中,核心组件就是Action,拦截器等,struts2 框架使用包来管理Action和拦截器等。每个包就是多个Action,多个拦截器等的集合.package中有下面几个属性: 


? name:这是一个必填属性,该属性指定该包的名字,该名字是该包被其它包引用的key 


? extends:可选属性。指定该包继承其它包。继承其它包,可以继承其它包中的Action定义。 


? abstract:可选属性。指定该包是不是一个抽象包。抽象包中不能包含Action定义。 



在前面的配置中:继承了stuts2的默认包struts-default,那么这个默认包在哪里定义的呢?我们可以查看struts2-core-XXX.jar包中有一个struts-default.xml文件 



这个文件中配置了很多的<bean> 标签和一个<package>标签,<package>标签的name就是struts-default.这个默认的包空间中定义了struts2内建的Result类型,拦截器等。Struts2 框架每次都会自动加载该文件。我们在strtus.xml文件中继承了默认的包空间,所以struts-default.xml文件一定比strtus.xml文件先加载. 


只有继承了正确的父Package,才能用到所需的预先配置好的特性。在大多数情况下,我们都应该继承“struts-default.xml”配置文件中的“strust-default”Package 



8.struts.xml—Action配置: 


Action只是一个控制器,它并不直接对请求者生成任何响应。因此,Action处理完用户请求后,Action需要将指定的视图资源呈现给用户。因此,配置Action的时候,应该配置逻辑视图和物理视图资源之间的映射。 


配置逻辑视图和物理视图之间的映射关系是通过<result>来定义的,每个<result> 元素定义逻辑视图和物理视图之间的一次映射,如下面的配置: 


[html]  view plain copy



  1. <struts>   
  2. <constant name="struts.action.extension" value="do"></constant>   
  3. <package name="com.wq" extends="struts-default">   
  4. <action name="login" class="com.wq.web.action.LoginAction">   
  5. <result name="success">/welcome.jsp</result>   
  6. <result name="error">/error.jsp</result>   
  7. </action>   
  8. </package>   
  9. </struts>  





[xml] 
   view plain
   copy 
   
 
   
 
 
1. <struts>   
2. <constant name="struts.action.extension" value="do"></constant>   
3. <package name="com.wq" extends="struts-default">   
4. <action name="login" class="com.wq.web.action.LoginAction">   
5. <result name="success">/welcome.jsp</result>   
6. <result name="error">/error.jsp</result>   
7. </action>   
8. </package>   
9. </struts>


下面是Action配置中属性的说明: 


name:提供了执行Action所对应的URL地址,上面是“login.do” (我们已经将请求路径的后缀改成了*.do) ,默认是 login.action。 


class: Action类的完整的类名 



下面我们再看看<result>标记: 


我们可以看到在result节点中多了“name”属性,实际上这个属性是一直都存在的,如果开发人员没有显式指定它的值,那么它的默认值就是“success”,所以上面的配置可以改成: 


使用通配符匹配Action: 

[html] 
      view plain
      copy 
      
 
      
 
    
1. <action name="login" class="com.wq.web.action.LoginAction">   
2. <result >/welcome.jsp</result>   
3. <result name="error">/error.jsp</result>   
4. </action>   
5. </package>   
6. </struts>  
 
   

 
 
   [xml] 
   view plain
   copy 
   
 
   
 
 
1. <action name="login" class="com.wq.web.action.LoginAction">   
2. <result >/welcome.jsp</result>   
3. <result name="error">/error.jsp</result>   
4. </action>   
5. </package>   
6. </struts>


先看一个domo:


[html] 
      view plain
      copy 
      
 
      
 
    
1. <?xml version="1.0"?>  
2. <!DOCTYPE struts PUBLIC  
3.     "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN"  
4. >  
5. <struts>  
6. <constant name="s" value=""></constant>  
7. <!-- 设置开发模式 -->    
8. <constant name="struts.devMode" value="true" />  
9. <constant name="struts.action.extension" value="action,do" />  
10. <!-- 此三行为了解决不换行问题而加上的 -->  
11. <constant name="struts.ui.theme" value="simple" />  
12. <constant name="struts.ui.templateDir" value="template" />  
13. <constant name="struts.ui.templateSuffix" value="ftl" />  
14.       
15.       
16. <package name="cn.ouuo.action" extends="struts-default" >  
17.       
18. <action name="SearchUser_*" class="searchAction" method="{1}">  
19. <result name="listResult">/listResult.jsp</result>  
20. <result name="listData">/more.jsp</result>  
21.               
22. <result name="wordPre">/officePre.jsp</result>  
23. <result name="manager">/manager.jsp</result>  
24. <result name="success">/success.jsp</result>  
25. </action>  
26.             
27. </package>  
28. </struts>  
 
   

 
 
   [xml] 
   view plain
   copy 
   
 
   
 
 
1. <?xml version="1.0"?>  
2. <!DOCTYPE struts PUBLIC  
3.     "-//Apache Software Foundation//DTD Struts Configuration 2.1.7//EN"  
4. >  
5. <struts>  
6. <constant name="s" value=""></constant>  
7. <!-- 设置开发模式 -->    
8. <constant name="struts.devMode" value="true" />  
9. <constant name="struts.action.extension" value="action,do" />  
10. <!-- 此三行为了解决不换行问题而加上的 -->  
11. <constant name="struts.ui.theme" value="simple" />  
12. <constant name="struts.ui.templateDir" value="template" />  
13. <constant name="struts.ui.templateSuffix" value="ftl" />  
14.       
15.       
16. <package name="cn.ouuo.action" extends="struts-default" >  
17.       
18. <action name="SearchUser_*" class="searchAction" method="{1}">  
19. <result name="listResult">/listResult.jsp</result>  
20. <result name="listData">/more.jsp</result>  
21.               
22. <result name="wordPre">/officePre.jsp</result>  
23. <result name="manager">/manager.jsp</result>  
24. <result name="success">/success.jsp</result>  
25. </action>  
26.             
27. </package>  
28. </struts>


在这里我主要是想说一下自己以前比较迷惑的地方,主要就是在action配置的几个参数,其实name属性就是要访问的Url地址,method中的1就是与 name里的* 进行匹配的,方法就是你在action中定义的各个方法,result里的name属性就是你action里返回的字符串,根据这个属性来确定跳转页面 


比如要访问:http:localhost:8080/ouuo/SearchUser_Manager.action