struts.xml详解

一。常量配置

 

1. 在struts2中配置常量的方式有三种：

       X 在struts.xml文件中配置
       X 在web.xml文件中配置 
       X 在sturts.propreties文件中配置

     注意： 1.之所以使用struts.propreties文件配置，是因为为了保持与WebWork的向后兼容

            2.在实际开发中，在web.xml中配置常量相比其他两种，需要更多的代码量，会降低了web.xml的可读性

            3.通常推荐在struts.xml文件中配置struts2的常量，而且便于集中管理 

2. 在sturt2中搜索加载常量的顺序是：

     struts-default.xml      (在struts2-core-2.0.6.jar文件中)
     struts-plugin.xml      （在struts2-Xxx-2.0.6.jar等Struts2插件JAR文件中）
     struts.xml             （Web应用默认的Struts2的配置文件）
     sturts.propreties       （Web应用默认的Struts2的配置文件）
     web.xml                 （Web应用下的配置文件）

    注意：1.若在不同的配置文件中同时配置了相同的Struts2常量，则后一个配置文件的常量值覆盖前一个配置的常量值

3. 配置文件的属性：name和value

         name:指定属性的常量名
　　　value：指定属性的值

   注意：1.在不同的配置文件中配置常量，虽然方式各异，但是都必须指定name、value这两个属性

4. 各种方式示例： 

   1.struts.xml:通过constant元素配置struts2的属性
     

 < struts >
     < constant   name = "struts.custom.il8n.resources"   value = "mess"   />
     ....
 </ struts >

 

       

        例1：指定国际化资源文件的baseName为mess


    2.sturts.propreties：<K-V>形式，K-name V-value

        struts.devMode=ture

        例2：名为struts.devMode的常量值为ture   

    3.web.xml:通过<filter>元素的<init-param>子元素指定的
       

 <!-指定struts2的SilterDispatcher的Filter-! >
 < filter >
   <!-指定Struts2的核心Filter-!>

     < filter-name > strurs2 </ filter-name >
     < filter-class > org.apache.struts2.dispatcher.FilterDispaycher
     </ filter-class >

     <!-通过init-param元素配置struts2常量-!>

     < init-param >
         < param-name > struts.custom.il8n.resources </ param-name >
         < param-value > mess </ param-value >
     </ init-param >

 </ filter >

 

       例3：指定国际化资源文件的baseName为mess

 

 

   常量详解

 

 <? xml   version = "1.0"   encoding = "UTF-8"   ?>
 <!DOCTYPE struts PUBLIC
     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
     "http://struts.apache.org/dtds/struts-2.0.dtd">

 < struts >
     <!-- 指定Web应用的默认编码集,相当于调用HttpServletRequest的setCharacterEncoding方法 -->
     < constant   name = "struts.i18n.encoding"   value = "UTF-8"   />

     <!--
         该属性指定需要Struts 2处理的请求后缀，该属性的默认值是action，即所有匹配*.action的请求都由Struts2处理。
         如果用户需要指定多个请求后缀，则多个后缀之间以英文逗号（,）隔开。
     -->
     < constant   name = "struts.action.extension"   value = "do"   />

     <!-- 设置浏览器是否缓存静态内容,默认值为true(生产环境下使用),开发阶段最好关闭 -->
     < constant   name = "struts.serve.static.browserCache"   value = "false"   />

     <!-- 当struts的配置文件修改后,系统是否自动重新加载该文件,默认值为false(生产环境下使用),开发阶段最好打开 -->
     < constant   name = "struts.configuration.xml.reload"   value = "true"   />

     <!-- 开发模式下使用,这样可以打印出更详细的错误信息 -->
     < constant   name = "struts.devMode"   value = "true"   />

     <!-- 默认的视图主题 -->
     < constant   name = "struts.ui.theme"   value = "simple"   />

     <!-- spring 托管 -->
     < constant   name = "struts.objectFactory"   value = "spring"   />

     <!--
         指定加载struts2配置文件管理器，默认为org.apache.struts2.config.DefaultConfiguration
         开发者可以自定义配置文件管理器，该类要实现Configuration接口，可以自动加载struts2配置文件。
     -->
     < constant   name = "struts.configuration"
         value = "org.apache.struts2.config.DefaultConfiguration"   />

     <!-- 设置默认的locale和字符编码 -->
     < constant   name = "struts.locale"   value = "zh_CN"   />
     < constant   name = "struts.i18n.encoding"   value = "GBK"   />

     <!-- 指定Struts的工厂类 -->
     < constant   name = "struts.objectFactory"   value = "spring" > </ constant >

     <!--
         指定spring框架的装配模式，装配方式有: name, type, auto, and constructor (name
         是默认装配模式)
     -->
     < constant   name = "struts.objectFactory.spring.autoWire"   value = "name"   />

     <!-- 该属性指定整合spring时，是否对bean进行缓存，值为true or false,默认为true -->
     < cosntant   name = "struts.objectFactory.spring.useClassCache"   />

     <!-- 指定类型检查,包含tiger和notiger -->
     < cosntant   name = "struts.objectTypeDeterminer"   value = "tiger"   />

     <!-- 该属性指定处理 MIME-type multipart/form-data，文件上传 -->
     < constant   name = "struts.multipart.parser"   value = "cos"   />
     < constant   name = "struts.multipart.parser"   value = "pell"   />
     < constant   name = "struts.multipart.parser"   value = "jakarta"   />

     <!-- 指定上传文件时的临时目录，默认使用 javax.servlet.context.tempdir -->
     < constant   name = "struts.multipart.saveDir"   value = "/tmpuploadfiles"   />

     <!-- 该属性指定Struts 2文件上传中整个请求内容允许的最大字节数 -->
     < constant   name = "struts.multipart.maxSize"   value = "2097152"   />

     <!--
         该属性指定Struts2应用加载用户自定义的属性文件，该自定义属性文件指定的属性不会覆盖
         struts.properties文件中指定的属性。如果需要加载多个自定义属性文件，多个自定义属性文
         件的文件名以英文逗号（,）隔开。(也就是说不要改写struts.properties!)
     -->
     < constant   name = "struts.custom.properties"
         value = "application,org/apache/struts2/extension/custom"   />

     <!--
         指定请求url与action映射器，默认为org.apache.struts2.dispatcher.mapper.DefaultActionMapper
     -->
     < constant   name = "struts.mapper.class"
         value = "org.apache.struts2.dispatcher.mapper.DefaultActionMapper"   />

     <!-- 指定action的后缀，默认为action -->
     < constant   name = "struts.action.extension"   value = "do"   />

     <!-- 被 FilterDispatcher使用指定浏览器是否缓存静态内容，测试阶段设置为false，发布阶段设置为true. -->
     < constant   name = "struts.serve.static.browserCache"   value = "true"   />

     <!-- 设置是否支持动态方法调用，true为支持，false不支持. -->
     < constant   name = "struts.enable.DynamicMethodInvocation"   value = "true"   />

     <!-- 设置是否可以在action中使用斜线，默认为false不可以，想使用需设置为true. -->
     < constant   name = "struts.enable.SlashesInActionNames"   value = "true"   />

     <!-- 是否允许使用表达式语法，默认为true. -->
     < constant   name = "struts.tag.altSyntax"   value = "true"   />

     <!-- 设置当struts.xml文件改动时，是否重新加载 -->
     < cosntant   name = "struts.configuration.xml.reload"   value = "true"   />

     <!-- 设置struts是否为开发模式，默认为false,测试阶段一般设为true. -->
     < cosntant   name = "struts.devMode"   value = "true"   />

     <!-- 设置是否每次请求，都重新加载资源文件，默认值为false. -->
     < cosntant   name = "struts.i18n.reload"   value = "false"   />

     <!-- 标准的UI主题，默认的UI主题为xhtml,可以为simple,xhtml或ajax -->
     < cosntant   name = "struts.ui.theme"   value = "xhtml"   />

     <!-- 模板目录 -->
     < cosntant   name = "struts.ui.templateDir"   value = "template"   />

     <!-- 设置模板类型. 可以为 ftl, vm, or jsp -->
     < cosntant   name = "struts.ui.templateSuffix"   value = "ftl"   />

     <!-- 定位velocity.properties 文件. 默认velocity.properties -->
     < cosntant   name = "struts.velocity.configfile"   value = "velocity.properties"   />

     <!-- 设置velocity的context. -->
     < cosntant   name = "struts.velocity.contexts"   value = "...."   />

     <!-- 定位toolbox -->
     < cosntant   name = "struts.velocity.toolboxlocation"   value = "...."   />

     <!-- 指定web应用的端口 -->
     < cosntant   name = "struts.url.http.port"   value = "80"   />

     <!-- 指定加密端口 -->
     < cosntant   name = "struts.url.https.port"   value = "443"   />

     <!-- 设置生成url时，是否包含参数.值可以为: none,get or all -->
     < cosntant   name = "struts.url.includeParams"   value = "get"   />

     <!-- 设置要加载的国际化资源文件，以逗号分隔. -->
     < cosntant   name = "struts.custom.i18n.resources"   value = "application"   />

     <!--
         对于一些web应用服务器不能处理HttpServletRequest.getParameterMap(), 像
         WebLogic,Orion, and OC4J等，须设置成true,默认为false.
     -->
     < cosntant   name = "struts.dispatcher.parametersWorkaround"   value = "false"   />

     <!-- 指定freemarker管理器 -->
     < cosntant   name = "struts.freemarker.manager.classname"
         value = "org.apache.struts2.views.freemarker.FreemarkerManager"   />

     <!-- 设置是否对freemarker的模板设置缓存,效果相当于把template拷贝到 WEB_APP/templates. -->
     < cosntant   name = "struts.freemarker.templatesCache"   value = "false"   />

     <!-- 通常不需要修改此属性. -->
     < cosntant   name = "struts.freemarker.wrapper.altMap"   value = "true"   />

     <!-- 指定xslt result是否使用样式表缓存.开发阶段设为true,发布阶段设为false. -->
     < cosntant   name = "struts.xslt.nocache"   value = "false"   />

     <!-- 设置struts自动加载的文件列表. -->
     < cosntant   name = "struts.configuration.files"
         value = "struts-default.xml,struts-plugin.xml,struts.xml"   />

     <!-- 设定是否一直在最后一个slash之前的任何位置选定namespace. -->
     < cosntant   name = "struts.mapper.alwaysSelectFullNamespace"
         value = "false"   />
 </ struts >

 

 

二。包配置

1. 图片解释：

     1.struts2框架的核心组件是 Action和拦截器等，struts2框架使用包来管理Action和拦截器等的

     2.每个包就是多个Action、多个拦截器、多个拦截器引用的集合

2. 抽象包：除了正常的包之外，struts2还提供了抽象包

         定义：不包含action定义的包

         区分：该包的package元素增加abstract="true"

3. 包配置：

      在struts.xml中，使用package元素配置包的信息，每个package元素定义一个包的配置

      package元素可以定义的属性：

         name:必填属性，指定该包的名字，是引用该包的key

         extends:可选属性，指定该包是否可以继承其他的包：可以继承一个或多个父包的中Action定义、烂机器定义、拦截器栈等配置

         namespace:可选属性，定义该包的命名空间

         abstract:可选属性，指定该包是个抽象包，包中不能有Action的定义

    注意：Struts2的配置文件是从上到下处理的，所以父包应该在子包的前面~！（其实所有xml文件都是自上往下顺序执行的）

4. 理解示例：

 

 < struts >
     <!-- 配置第一个包，该包名为defalut,继承struts-defalut -->
     < package   name = "default"   extends = "struts-defalut" >

         <!-- 下面定义了拦截器部分-->
         < interceptors >

             <!--定义拦截器栈-->
             < interceptor-stack   name = "crudStack" >
                 < interceptor-ref   name = "params"   />
                 < interceptor-ref   name = "defalutStack"   />
             </ interceptor-stack >
         </ interceptors >

         < default-action-ref   name = "showcase"   />

         <!--定义一个Action，该Action直接映射到showcase.jsp页面-->
         < action   name = "Showcase" >
             < result >  showcase.jsp </ result >
         </ action >

         <!--定义一个Action,该Action类为com.opensymphony.webwork.showcase.DateAction-->
         < action   name = "Date"   class = "lee.DateAction" >
             < result   name = "success" > /date.jsp  </ result >
         </ action >
     </ package >

     <!--配置第二个包，该包名为skill,该包继承default包-->
     < package   name = "skill"   extends = "defalut"   name = "/skill" >

         <!-- 定义默认你的拦截器引用-->
                 < defalut-interceptor-ref   name = "crudStack" />

         <!--定义名为Edit的Action,该类对应Action对应的处理类为lee.SkillAction
 -->
         < action   name = "Edit"   class = "lee.SkillAction" >
             < result > /empmanager/editSkill.jsp </ result >
             < intercepor-ref   name = "params"   />
             < interceptor-ref   name = "basicStack"   />

         </ action >

         <!--定义名为Save的Action，该Action对应的处理类为lee.SkillAction,使用save方法作为处理方法-->
         < action   name = "Save"   class = "lee.SkillAction"   method = "save" >
             < result   name = "input" > /empmanager/editSkill.jsp </ result >
             < result   type = "redirect" > edit.action? skillName =${currentSkill.name}
             </ result >
         </ action >
     </ package >
 </ struts >

 

 

 

三。命名空间配置

1.不使用命名空间的方式：

struts配置：

 < struts >
     < include   file = "struts-default.xml"   />
     < package   name = "com.casc.manager"   extends = "struts-default"
         < action   name = "xxn"   class = "com.casc.manager.XxnAction" >
             < result   name = "success" > /success.jsp </ result >
              < result   name = "error" > /index.jsp </ result >
              < result   name  = "input"   > /index.jsp </ result   >
         </ action >

     </ package >
 </ struts >

 

 < form   action = "xxn.action"   method = "post" >
         < s:text   name = "user.name" > </ s:text > < input   type = "text"   name = "name" > < br >
           < s:text   name = "user.password" > </ s:text > < input   type = "password"   name = "password" > < br >
           < input   type = "submit"   value =" < s:text  name=" user .submit" /> " />
 </ form >

 

地址栏访问：http://localhost:9999/TDIAP/xxn.action

 

这样配置基本不会有问题。

可是在struts1.2里，我们习惯：path="/abc/xxn"

方便于在abc文件夹下操作。

 

2.这样在struts2.0中就要是用命名空间来达到相同的效果。

 < struts >
     < include   file = "struts-default.xml"   />
     < package   name = "com.casc.manager"   extends = "struts-default"   namespace = "/mng" >
         < action   name = "xxn"   class = "com.casc.manager.XxnAction" >
             < result   name = "success" > /success.jsp </ result >
              < result   name = "error" > /index.jsp </ result >
              < result   name  = "input"   > /index.jsp </ result   >
         </ action >
     </ package >
 </ struts >

 

   < form   action = "<%=request.getContextPath() %>/mng/xxn.action"   method = "post" >
         < s:text   name = "user.name" > </ s:text > < input   type = "text"   name = "name" > < br >
           < s:text   name = "user.password" > </ s:text > < input   type = "password"   name = "password" > < br >
           < input   type = "submit"   value =" < s:text  name=" user .submit" /> " />
 </ form >

 

这里主页 因为我们使用了命名空间“/mng”，如果在mng文件夹下的jsp页面我们可以直接写 action="xxn.action"

但在其他文件夹下就不行了。如果在mng上级目录尽量不要写成action="mng/xxn.action", 这样会成功但会出现问题，他很可能出现地址栏中http://localhost:9999/TDIAP/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng/mng /xxn.action

这种情况。

安全起见 使用绝对路径：action="<%=request.getContextPath() %>/mng/xxn.action" 这样写不用考虑当前目录。

地址栏访问：http://localhost:9999/TDIAP/mng/ xxn.action  要把命名空间加上。

 

3.注意

    1. 对于包struts2：没有指定namespace属性。如果某个包没有指定namespace属性，即该包使用默认的命名空间，默认的命名空间总是""。

2. 对于包com.casc.manager：指定了命名空间/mng，则该包下所有的Act ion处理的URL应该是“命名空间/Act ion名”。

3. struts2先在指定的路径下找act ion,如果找不到则会去默认的路径找act ion

4. 命名空间只有一个级别，如果 /a/b/get.action,系统将先在 /a/b 的命名空间下查找，如果找不到，直接进去默认命名空间查找get.action ， 而不是在 /a 的命名空间下查找

5. Struts2以命名空间的方式来管理 Act ion，同一个命名空间不能有同名的Act ion。不同的命名空间 可以有 同名的 action.

 

四。包含配置

在Struts2中可以将一个配置文件分解成多个配置文件，那么我们必须在struts.xml中包含其他配置文件(注，所有的.xml文件都是标准的 Struts 2 配置文件，一样包含ＤＴＤ等的声明)。

 < struts >
     < include   file = "struts-default.xml"   />
     < include   file = "struts-user.xml"   />
     < include   file = "struts-book.xml"   />
 </ struts >

 

 

五。拦截器配置

1:所有拦截器的超级接口Interceptor ,Action去实现这个接口;

 Interceptor 它其中有三个方法(init(),destroy() ,interceptor()):

      Init()方法:在服务器起动的时候加载一次,并且只加载一次;

      Destroy()方法:当拦截器销毁时执行的方法;

      Interceptor()方法:其中里边有一个参数invocation

 public  String intercept(ActionInvocation invocation)  throws  xception {

        System.out.println("interceptor!!" );

        String result=invocation.invoke();

        return  result;

     }

 

Invocation.invoke()是如果只有一个拦截器执行完这个方法后,会返回给视图,如果有多个拦截器,它顺序的执行完所有的拦截器,才返回给视图.

2: 可以在系统初始化中给拦截器指定默认的参数(也包括了定义拦截器方式)如下:

    在拦截器类中把hello当做属性set/get方式注入到拦截器类中;

 < interceptors >

     <!-- 先定义拦截器 -->

     < interceptor   name = "myInterceptor"
         class = "com.zzz.struts2.interceptor.MyInterceptor" >

         <!-- 指定系统初始化给拦截器的参数 -->

         < param   name = "hello" > 张钊钊 </ param >

     </ interceptor >

     <!-- 加到自己设置的拦截器栈里边去 -->

     < interceptor-stack   name = "myStack" >

         < interceptor-ref   name = "myInterceptor" >

         </ interceptor-ref >

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

     </ interceptor-stack >

 </ interceptors >

     <!--
         改变系统默认的拦截器,改成自己的默认拦截器,并且一个系统只能有一个默认的拦截器,这样这个拦截器栈会默认应用到所有的Action上去
     -->

 < default-interceptor-ref   name = "myStack" >

 </ default-interceptor-ref >
     <!--
 也可以在使用拦截器的时候给它设置参数:

 就是在一个action 的reslut下面配置上如下:
 -->
 < action   name = "register"   class = "com.zzz.struts2.action.RegisterAction" >

     < result   name = "success" > /success.jsp </ result >

     <!-- result 它其中还有一个信息转发类型 type=""记住，如果不转向JSP，转向图表，可以改变type=""值 -->

     < result   name = "input" > /register.jsp </ result >

     < interceptor-ref   name = "myInterceptor" >

         < param   name = "hello" > welcome </ param >

     </ interceptor-ref >

     < interceptor-ref   name = "myStack" > </ interceptor-ref >

 </ action >

 

     

2.拦截器,拦截器栈和默认的拦截器之间的关系

1: 拦截器和拦截器栈是一个级别的,也就是说一个拦截器栈中包括许多拦截器, 一个拦截器栈中还可以包括许多拦截器栈,配置如下方式:

 < interceptors >

            <!-- 先定义拦截器 -->

            < interceptor   name = "myInterceptor"   class = "com.zzz.struts2.interceptor.MyInterceptor" >

               <!-- 指定系统初始化给拦截器的参数 -->

               < param   name = "hello" > 张钊钊 </ param >

            </ interceptor >

            <!-- 加到自己设置的拦截器栈里边去 -->

            < interceptor-stack   name = "myStack" >

               < interceptor-ref   name = "myInterceptor" >

               </ interceptor-ref >

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

            </ interceptor-stack >

        </ interceptors >

 

拦截器的使用:1.先定义;2.在引用使用;

 < interceptor   name = "myInterceptor"   class = "com.zzz.struts2.interceptor.MyInterceptor" >

 < interceptor-ref   name = "myInterceptor" >

               </ interceptor-ref >

 

2: struts2中有一个系统默认的拦截器栈是 defaultStack,如果你手动引用自己的拦截器,系统默认的拦截器栈将不起作用;这样必需手动引入系统的拦截器栈

 < interceptor-ref   name = "defaultStack" >

               </ interceptor-ref >

 

如果想改变系统默认的拦截器栈,可以这样配置:

 < default-interceptor-ref   name = "myStack" >

 </ default-interceptor-ref >

 其中myStack是自己定义的拦截器栈名字;

如果拦截器栈中有多个拦截器,在执行action之前的顺序跟配置拦截器的顺序一致,而在action之后执行的顺序是相反的;

 3:抽象的拦截器类AbstractInterceptor

1: Interceptor这个超级拦截器接口,有三方法需要实现,但是如果不想使用init();

    和destroy()方法,可以去继承这个抽象拦截器类;

它的使用跟上边的没有什么区别;

 4:方法过滤拦截器MethodFilterInterceptor

1: 上边的拦截器都要是针对整个action的,如果针对某个方法进行拦截可以去继承这个类;

它的使用跟上边的使用方法差不多,只是需要要配置它对那个方法进行拦截,方法过滤拦截器最好不要配置到自己设置默认的拦截器栈里边,自己手动配置.

 < interceptor-ref   name = "myInterceptor3" >
     < param   name = "includeMethods" > execute </ param >
     < param   name = "excludeMethods" > execute </ param >
 </ interceptor-ref >
 < interceptor-ref   name = "defaultStack" > </ interceptor-ref >

 

其中includeMethods ,excludeMethods是固定写法: includeMethods 包含拦截那些方法,多个方法需要用”,”隔开; excludeMehtods是排除拦截的那些方法;

5:鉴听器PreResultListener接口

1: 它的鉴听点在拦截器执行完某个action方法后,在渲染视图之前做一些事情；让某个类去实现这个接口；

然后向需要它的拦截器中注册进去如下代码：

 publicclass MyInterceptor3  extends  MethodFilterInterceptor {

     privatestaticfinallongserialVersionUID = 3756655410194005443L;

     @Override

     protected  String doIntercept(ActionInvocation invocation)  throws  Exception {

        //把鉴听器注册到拦截中去;

        invocation.addPreResultListener(new  MyListener());

        System.out.println("my Interceptor3" );

        String result=arg0.invoke();

        System.out.println("my interceptor3 finshed!" );

        return  result;

     }

 }
 转载自：http://terryjs.iteye.com/blog/772670