struts2配置-struts.xml

struts.xml配置文件

 

        Struts框架的核心配置文件就是struts.xml配置文件，该文件主要负责管理Struts 2框架的业务控制器Action。

 

        在默认情况下，Struts 2框架将自动加载放在WEB-INF/classes路径下的struts.xml文件。在大部分应用里，随着应用规模的增加，系统中Action数量也大量增加，导致struts.xml配置文件变得非常臃肿。

 

         为了避免struts.xml文件过于庞大、臃肿，提高struts.xml文件的可读性，我们可以将一个struts.xml配置文件分解成多个配置文件，然后在struts.xml文件中包含其他配置文件。

 

        下面的struts.xml文件中就通过include手动导入了一个配置文件：struts-part1.xml文件，通过这种方式，就可以将Struts 2的Action按模块配置在多个配置文件中。

   ----------------------------------------------------------------------------------------------------------------------------
   <?xml version="1.0" encoding="UTF-8" ?>
   <!-- 指定Struts 2配置文件的DTD信息 -->
   <!DOCTYPE struts PUBLIC
        "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
        "http://struts.apache.org/dtds/struts-2.0.dtd">
   <!-- 下面是Struts 2配置文件的根元素 -->
   <struts>
           <!-- 通过include元素导入其他配置文件 -->
           <include file="struts-part1.xml" />
             ...
   </struts>
   ----------------------------------------------------------------------------------------------------------------------------
   
   通过这种方式，Struts 2提供了一种模块化的方式来管理struts.xml配置文件。

 

   除此之外，Struts 2还提供了一种插件式的方式来管理配置文件。用WinRAR等解压缩软件打开struts2-core-2.0.6.jar文件，看到如图3.21所示的文件结构，在光标选中的一行，看到有一个struts-default.xml文件。

   
   
   图3.21  struts2-core-2.0.6.jar压缩文件的文件结构
 
   查看struts-default.xml文件，看到该文件代码片段如下：
   --------------------------------------------------------------------------------------
   <?xml version="1.0" encoding="UTF-8" ?>

   <!-- 指定Struts 2配置文件的DTD信息 -->

   <!DOCTYPE struts PUBLIC

            "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"

            "http://struts.apache.org/dtds/struts-2.0.dtd">

   <!-- Struts 2配置文件的根元素 -->

   <struts>

             <!-- 下面定义了Struts 2框架的一些基础Bean  -->

               <bean class="com.opensymphony.xwork2.ObjectFactory" name="xwork" />

               <bean type="com.opensymphony.xwork2.ObjectFactory" name="struts"

                      class="org.apache.struts2.impl.StrutsObjectFactory" />

                       ....

                <!-- 下面是一些静态注入Bean定义 -->

                <bean class="com.opensymphony.xwork2.util.OgnlValueStack" static="true" />

                <bean class="org.apache.struts2.dispatcher.Dispatcher" static="true" />

                ...

                <!-- 下面定义Struts 2的默认包空间 -->

                <package name="struts-default">

                <!-- 定义Struts 2内建支持的结果类型 -->

                   <result-types>

                         <!-- 定义Action链Result类型 -->

                         <result-type name="chain" class="com.opensymphony.xwork2. ActionChainResult"/>

                         <!-- 定义Dispatcher的Result类型，并设置default="true"，指定该结果Result是默认的Result类型 -->

                         <result-type name="dispatcher"  class="org.apache.struts2.dispatcher.Servlet DispatcherResult" default="true"/>

                         <!-- 定义FreeMarker的Result类型 -->

                         <result-type name="freemarker"class="org.apache.struts2.views.freemarker. FreemarkerResult"/>
                         ...

                    </result-types>

                    <!-- 定义Struts 2内建的拦截器 -->

                    <interceptors>

                    <interceptor name="alias" class="com.opensymphony.xwork2. interceptor.AliasInterceptor"/>

                    <interceptor name="autowiring" class="com.opensymphony.xwork2.spring.interceptor. ActionAutowiringInterceptor"/>

                     ...

                     <!-- 定义基本拦截器栈 -->

                                   <interceptor-stack name="basicStack">

                                   <interceptor-ref name="exception"/>

                                   <interceptor-ref name="servlet-config"/>

                                   <interceptor-ref name="prepare"/>

                                   <interceptor-ref name="checkbox"/>

                                   <interceptor-ref name="params"/>

                                   <interceptor-ref name="conversionError"/>

                                   </interceptor-stack>

                                        <!-- 还有系列拦截器栈 -->

                                        ... 

                                  </interceptors>

                   <!-- 定义默认的拦截器栈引用 -->

                  <default-interceptor-ref name="defaultStack"/>

                  </package>

    </struts>
    --------------------------------------------------------------------------------------

   上面的代码并未全部列出struts-default.xml文件，只是列出了每个元素的代表。上面配置文件中定义了一个名字为struts-default的包空间，该包空间里定义了Struts 2内建的Result类型，还定义了Struts 2内建的系列拦截器，以及由不同拦截器组成的拦截器栈，文件的最后还定义了默认的拦截器引用。

 

   这个struts-default.xml文件是Struts 2框架的默认配置文件，Struts 2框架每次都会自动加载该文件。查看我们前面使用的struts.xml文件，看到我们自己定义的package元素有如下代码片段：
   
   --------------------------------------------------------------------------------------
   <!-- 指定Struts 2配置文件的根元素 -->

   <struts>

            <!-- 配置名为lee的包空间，继承struts-default包空间 -->

            <package name="lee" extends="struts-default">

                                    ...

            </package>

   </struts>
   --------------------------------------------------------------------------------------
   
   在上面配置文件中，名为lee的包空间，继承了名为struts-default的包空间，struts-default包空间定义在struts-default.xml文件中。可见，Struts 2框架默认会加载struts-default.xml文件。

 

   不仅如此，Struts 2框架提供了一种类似Eclipse的扩展方式，它允许以一种“可插拔”的方式来安装插件，例如后面将要介绍的Spring插件、JSF插件等，它们都提供了一个类似struts2-Xxx-plugin.jar的文件——这个文件就是插件安装文件，只要将该文件放在Web应用的WEB-INF/lib路径下，Struts 2框架将自动加载该框架。

 

   使用WinRAR工具打开struts2-spring-plugin2.06.jar文件，找到一个struts-plugin.xml文件，打开该文件，该文件的代码如下：

   --------------------------------------------------------------------------------------
   <?xml version="1.0" encoding="UTF-8" ?>

   <!-- 指定Struts 2的DTD信息 -->

   <!DOCTYPE struts PUBLIC

       "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"

       "http://struts.apache.org/dtds/struts-2.0.dtd"> 

   <struts>

           <!-- 定义一个名字为spring的ObjectFactory -->

           <bean type="com.opensymphony.xwork2.ObjectFactory" name="spring" class="org.apache.struts2.spring.StrutsSpringObjectFactory" />

           <!-- 指定名字为sping的ObjectFactory是Struts 2的ObjectFactory -->

           <constant name="struts.objectFactory" value="spring" />

           <!-- 定义名为spring-default的包空间 -->

           <package name="spring-default">

                  <!-- 定义整合Spring框架所必需的拦截器列表 -->

                  <interceptors>

                             <interceptor name="autowiring" class="com.opensymphony.xwork2.spring.interceptor. ActionAutowiringInterceptor"/>

                             <interceptor name="sessionAutowiring" class="org.apache.struts2.spring.interceptor. SessionContextAutowiringInterceptor"/>

                  </interceptors>

           </package>

    </struts>

    在上面配置文件中，配置了Struts 2与Spring框架整合必需的常量、拦截器等——这也是Struts 2框架使用Spring插件必需的配置。只要将struts2-spring-plugin2.06.jar文件放在WEB-INF/lib路径下，Struts 2框架将自动加载该文件。

 

 struts.xml文件结构

 

struts.xml文件是整个Struts 2框架的核心，下面提供了一个最完整的struts.xml文件，这个文件没有任何实际意义，仅仅是一个struts.xml文件示范。
    ---------------------------------------------------------------------------------------------------------------------------

    <?xml version="1.0" encoding="GBK"?>

    <!-- 下面指定Struts 2配置文件的DTD信息 -->

    <!DOCTYPE struts PUBLIC

        "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"

        "http://struts.apache.org/dtds/struts-2.0.dtd">

    <!-- struts是Struts 2配置文件的根元素 -->

    <struts>

              <!-- 下面元素可以出现0次，也可以无限多次 -->

              <constant name="" value="" />

              <!-- 下面元素可以出现0次，也可以无限多次 -->

              <bean type="" name="" class="" scope="" static="" optional="" />

              <!-- 下面元素可以出现0次，也可以无限多次 -->

              <include file="" />

              <!-- package元素是Struts配置文件的核心，该元素可以出现0次，或者无限多次 -->

              <package name="必填的包名" extends="" namespace="" abstract="" externalReferenceResolver>

                       <!-- 该元素可以出现，也可以不出现，最多出现一次 -->

                       <result-types>

                                     <!-- 该元素必须出现，可以出现无限多次-->

                                     <result-type name="" class="" default="true|false">

                                     <!-- 下面元素可以出现0次，也可以无限多次 -->

                                            <param name="参数名">参数值</param>*

                                     </result-type>

                       </result-types>

                       <!-- 该元素可以出现，也可以不出现，最多出现一次 -->

                       <interceptors>

                                     <!-- 该元素的interceptor元素和interceptor-stack至少出现其中之一，也可以二者都出现 -->

                                     <!-- 下面元素可以出现0次，也可以无限多次 -->

                                     <interceptor name="" class="">

                                            <!-- 下面元素可以出现0次，也可以无限多次 -->

                                            <param name="参数名">参数值</param>*

                                     </interceptor>

                                     <!-- 下面元素可以出现0次，也可以无限多次 -->

                                     <interceptor-stack name="">

                                            <!-- 该元素必须出现，可以出现无限多次-->

                                            <interceptor-ref name="">

                                                <!-- 下面元素可以出现0次，也可以无限多次 -->

                                                <param name="参数名">参数值</param>*

                                            </interceptor-ref>

                                     </interceptor-stack>

                     </interceptors>

                     <!-- 下面元素可以出现0次，也可以无限多次 -->

                     <default-interceptor-ref name="">

                            <!-- 下面元素可以出现0次，也可以无限多次 -->

                            <param name="参数名">参数值</param>

                      </default-interceptor-ref>

                      <!-- 下面元素可以出现0次，也可以无限多次 -->

                      <default-action-ref name="">

                             <!-- 下面元素可以出现0次，也可以无限多次 -->

                              <param name="参数名">参数值</param>*

                        </default-action-ref>?

                        <!-- 下面元素可以出现0次，也可以无限多次 -->

                         <global-results>

                               <!-- 该元素必须出现，可以出现无限多次-->

                               <result name="" type="">

                                <!-- 该字符串内容可以出现0次或多次 -->

                                            映射资源

                                <!-- 下面元素可以出现0次，也可以无限多次 -->

                                      <param name="参数名">参数值</param>*

                                </result>

                          </global-results>

                          <!-- 下面元素可以出现0次，也可以无限多次 -->

                           <global-exception-mappings>

                                 <!-- 该元素必须出现，可以出现无限多次-->

                                 <exception-mapping name="" exception="" result="">

                                            异常处理资源

                                            <!-- 下面元素可以出现0次，也可以无限多次 -->

                                            <param name="参数名">参数值</param>*

                                 </exception-mapping>

                           </global-exception-mappings>

                           <action name="" class="" method="" converter="">

                                        <!-- 下面元素可以出现0次，也可以无限多次 -->

                                        <param name="参数名">参数值</param>*

                                        <!-- 下面元素可以出现0次，也可以无限多次 -->

                                        <result name="" type="">

                                            映射资源

                                            <!-- 下面元素可以出现0次，也可以无限多次 -->

                                            <param name="参数名">参数值</param>*

                                        </result>

                                        <!-- 下面元素可以出现0次，也可以无限多次 -->

                                        <interceptor-ref name="">

                                            <!-- 下面元素可以出现0次，也可以无限多次 -->

                                            <param name="参数名">参数值</param>*

                                        </interceptor-ref>

                                        <!-- 下面元素可以出现0次，也可以无限多次 -->

                                        <exception-mapping name="" exception="" result="">

                                            异常处理资源

                                            <!-- 下面元素可以出现0次，也可以无限多次 -->

                                            <param name="参数名">参数值</param>*

                                        </exception-mapping>

                          </action>

             </package>*

    <struts>

    ---------------------------------------------------------------------------------------------------------------------------
    
    

    上面的struts.xml配置文件是一个非常全面的配置文件，包含了Struts 2的全部配置元素。上面配置文件主要用于帮助对XML DTD不太熟悉的读者。

 

    通过上面给出的struts.xml配置文件范例，我们已经可以全面掌握Struts 2配置文件的文件结构了，但struts.xml文件各配置元素的意义、各属性的相关含义依然不能深入了解。

分享到：

struts2配置-struts.pro | Struts2的基本配置-web.xml

• 2008-06-21 16:17
• 浏览 4287
• 评论(3)
• 查看更多

评论

3 楼 king130520 2010-07-30  

2 楼 fenglingyesiyu 2010-07-26  

如果再加上配置元素的意义、各属性的相关含义就更好了

1 楼 fenglingyesiyu 2010-07-26  

那么详细，非常有用