Struts2配置文件

简介：

与Struts2相关的配置文件有好几个，常用的有 struts.properties , web.xml, struts.xml等。web.xml中配置Struts2的分发器Filter。struts.properties里配置Struts2的一些属性。struts.xml里配置了Struts2的Action。Struts2的下载地址：http://struts.apache.org/

struts.properties

struts.properties配置了Struts2的一些参数。每个可配的参数都有一个默认值。该文件不是必须的，如果无需改变任何参数值，可以不用添加该文件。

常用的需要在struts.properties里重新配置的属性有:

//指定默认编码集，对于请求参数带有中文的情况应该设置陈GBK或GB2312.默认值UTF-8

struts.i18n.encoding=GB2312

//是否每次HTTP请求到达时，都重新加载国际化资源文件。默认值false

struts.i18n.reload=true

//但struts.xml改动后，是否重新加载该文件。在开发阶段建议将此属性设置为“true”，提高开发效率。默认值false

struts.configuration.xml.reload=true

//是否使用Struts2的开发模式，可以获得更多报错信息，便于调试。在开发阶段设置为true。默认值false

struts.devMode = true

//设置浏览器是否缓存静态页面。开发阶段设置为false，以获得服务器的最新响应。默认值true

struts.serve.static.browserCache=true

//指定后缀为.action形式的请求可被Struts2处理。可配置多个请求后缀，比如.do、.struts2等，配置时多个后缀名用逗号隔开

struts.action.extension=action,do,struts2,

//配置服务器运行时的端口号。一般情况下该属性不修改，如果端口号占用则重新分配端口号。默认值80

struts.url.http.port = 8080

注：Struts2的默认属性位于struts2-core-2.0.11.1.jar包org/apache/struts2下面的default.properties里，用户可以在项目的WEB-INF/class下添加struts.properties覆盖默认的配置。

web.xml

任何MVC框架都需要与Web应用整合，这就不得不借助于web.xml文件，只有配置在web.xml文件中的Servlet才会被加载。通常所有MVC框架都需要Web应用加载一个核心控制器，对于Struts2框架而言，需要加载StrutsPrepareAndExecuteFiter,该Filter将会加载应用的Struts2框架。

除此之外，还可以在Web.xml中配置Struts2常量(struts.properties文件专门用于配置常量)。

配置StrutsPrepareAndExecuteFiter的代码如下：

 <filter>

        <filter-name>struts2</filter-name>

         <filter-class>

                org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter

         </filter-class>

    </filter>

    <filter-mapping>

        <filter-name>struts2</filter-name>

        <url-pattern>/*</url-pattern>

    </filter-mapping>

注：以上代码段存在于struts2-blank\WEB-INF中的web.xml

struts.xml

struts.xml是Struts2的核心配置文件,里面配置Action, JSP, Exception, Intercepter等。另外，struts.properties里的配置也可以配置在struts.xml中。

一个较为完整的struts.xml配置实例如下：

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

<!DOCTYPE struts PUBLIC

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

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

<struts>

    <!-- 

      http://localhost:8081/hotelsys/test/demo.do

      1. StrutsPrepareAndExecuteFilter根据struts.xml配置文件的信息，确定凡是*.do结尾的请求，均归struts处理。

      2. 一旦发现.do结尾请求出现，直接拦截，做以下操作：

         a. http://localhost:8081/hotelsys/test/demo (去除识别标志)

         b. /test/demo  （获得真正访问资源地址信息)

         c. /test获得目录，去匹配对应的包的namespace

         d. demo 获得action的名字，去对应包中查找，如果找到，则创建该action的实例，调用其execute方法一次。

     -->

    <!-- 设置为开发模式，系统运行速度将降低，但是提供的出错提示更加直观，一般用于系统调试的时候使用 -->

    <constant name="struts.devMode" value="true" />

    <constant name="struts.action.extension" value="do"/>  <!--所有以*.do结尾的请求全部归struts处理  ，如果没有显式指定action识别后缀，默认就是action, 比如toInput.action-->

    <constant name="struts.ui.theme" value="simple"></constant> <!-- struts2将自动帮程序员生成网页，提供了多种生成模版 -->

    <constant name="struts.i18n.encoding" value="utf-8"></constant>

    <!--

        package是若干个拥有相关功能的action的群组

     -->

    <package name="demoPak" namespace="/test" extends="struts-default">

         <action name="demo" class="edu.fjnu.hotelsys.action.DemoAction">

         </action>

    </package>

    <package name="hotelsys-default" namespace="/" extends="struts-default">

        <interceptors>

         <interceptor name="authentication" class="edu.fjnu.hotelsys.interceptor.AuthenticationInterceptor"></interceptor>

         <!-- 普通需要权限的用户操作   普通的，需要身份验证才可以使用的action，将使用user拦截器stack-->

         <interceptor-stack name="user">

                <interceptor-ref name="authentication" />

                <interceptor-ref name="defaultStack" />

         </interceptor-stack>

         <!-- 普通需要权限的用户表单提交        需要身份验证才可以使用的action，同时该action中拥有表达提交操作，将使用user-submit拦截器              stack -->

         <interceptor-stack name="user-submit">

                <interceptor-ref name="user" />

         </interceptor-stack>

         <!-- 需要身份验证才可以使用的action，同时该action中拥有表达提交操作，同时该表单具备文件提交功能，将使用user-file-submit拦截器

stack -->

         <interceptor-stack name="user-file-submit">

              <interceptor-ref name="fileUpload">

                  <param name="allowedTypes">image/bmp,image/pjpeg,image/png</param>

                  <param name="maximumSize">200000</param>

              </interceptor-ref>

              <interceptor-ref name="user"/>

         </interceptor-stack>

         <!-- 非权限信息访问    没有任何身份需求，都可以访问的action,将使用guest拦截器stack-->

         <interceptor-stack name="guest">

                <interceptor-ref name="defaultStack" />

         </interceptor-stack>

       </interceptors>

       <!-- 没有特殊指明拦截器的action,默认使用user拦截器stack -->

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

       <global-results>

          <result name="gotoLoginAction" type="redirectAction">

                <param name="actionName">gotoLogin</param>

                <param name="namespace">/security</param>

          </result>

          <result name="error" type="redirect">/error.jsp</result>

       </global-results>

    </package>

    <include file="security-module.xml"/>

    <include file="room-module.xml"/>

    <include file="hotel-module.xml"/>

    <include file="user-module.xml"/> 

</struts>

注：struts.xml配置文件的默认位置在struts2-blank包下/WEB-INF/calsses/struts.xml。可以struts.xml放到MyEclipse项目的src文件夹下。并且，log4j2.xml也在此目录下。

Struts2常数的配置与搜索

配置Struts2常数有3中方式：

1.在struts.properties文件中配置常量。

2.在web.xml文件中配置核心Filter时通过初始化参数来配置常数。

3.在struts.xml文件中使用<constant.../>元素来配置常量。

通常，Struts2框架按如下搜索顺序来加载Struts2常量：

1.struts-default.xml: 该文件保存在 struts2-core-2.3.1.2.jar 文件中。

2.struts-plugin.xml: 该文件保存在 struts2-xxx-2.3.1.2.jar文件中。

3.struts.xml: 该文件是Web应用自己的struts2配置文件。

4.struts.properties: 该文件是Web应用默认的Struts2配置文件。

5.web.xml: 该文件是Web应用的配置文件。

注：上面指定了Struts2框架搜索Struts2常量的顺序，但是如果在多个文件中配置了同一个Struts2常量，则后面一个文件中配置的常量值会覆盖前面文件中配置的常量值。

struts最小依赖包

以struts-2.3.24.1版本为例，struts的最小依赖包的位于：struts-2.3.24.1\apps\struts2-blank\WEB-INF\lib