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-name V-value

        struts.devMode=ture

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

    3.web.xml:通过元素的子元素指定的
       

  >
 < filter >
   >

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

     >

     < 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"   ?>

     "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
     "http://struts.apache.org/dtds/struts-2.0.dtd">

 < struts >

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


     < constant   name = "struts.serve.static.browserCache"   value = "false"   />


     < constant   name = "struts.configuration.xml.reload"   value = "true"   />


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


     < constant   name = "struts.ui.theme"   value = "simple"   />


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


     < constant   name = "struts.locale"   value = "zh_CN"   />
     < constant   name = "struts.i18n.encoding"   value = "GBK"   />


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


     < cosntant   name = "struts.objectFactory.spring.useClassCache"   />


     < cosntant   name = "struts.objectTypeDeterminer"   value = "tiger"   />


     < constant   name = "struts.multipart.parser"   value = "cos"   />
     < constant   name = "struts.multipart.parser"   value = "pell"   />
     < constant   name = "struts.multipart.parser"   value = "jakarta"   />


     < constant   name = "struts.multipart.saveDir"   value = "/tmpuploadfiles"   />


     < constant   name = "struts.multipart.maxSize"   value = "2097152"   />


     < constant   name = "struts.mapper.class"
         value = "org.apache.struts2.dispatcher.mapper.DefaultActionMapper"   />


     < constant   name = "struts.action.extension"   value = "do"   />


     < constant   name = "struts.serve.static.browserCache"   value = "true"   />


     < constant   name = "struts.enable.DynamicMethodInvocation"   value = "true"   />


     < constant   name = "struts.enable.SlashesInActionNames"   value = "true"   />


     < constant   name = "struts.tag.altSyntax"   value = "true"   />


     < cosntant   name = "struts.configuration.xml.reload"   value = "true"   />


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


     < cosntant   name = "struts.i18n.reload"   value = "false"   />


     < cosntant   name = "struts.ui.theme"   value = "xhtml"   />


     < cosntant   name = "struts.ui.templateDir"   value = "template"   />


     < cosntant   name = "struts.ui.templateSuffix"   value = "ftl"   />


     < cosntant   name = "struts.velocity.configfile"   value = "velocity.properties"   />


     < cosntant   name = "struts.velocity.contexts"   value = "...."   />


     < cosntant   name = "struts.velocity.toolboxlocation"   value = "...."   />


     < cosntant   name = "struts.url.http.port"   value = "80"   />


     < cosntant   name = "struts.url.https.port"   value = "443"   />


     < cosntant   name = "struts.url.includeParams"   value = "get"   />


     < cosntant   name = "struts.custom.i18n.resources"   value = "application"   />


     < cosntant   name = "struts.freemarker.manager.classname"
         value = "org.apache.struts2.views.freemarker.FreemarkerManager"   />


     < cosntant   name = "struts.freemarker.templatesCache"   value = "false"   />


     < cosntant   name = "struts.freemarker.wrapper.altMap"   value = "true"   />


     < cosntant   name = "struts.xslt.nocache"   value = "false"   />


     < cosntant   name = "struts.configuration.files"
         value = "struts-default.xml,struts-plugin.xml,struts.xml"   />


     < 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 >

     < 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   name = "Showcase" >
             < result >  showcase.jsp  result >
          action >


         < action   name = "Date"   class = "lee.DateAction" >
             < result   name = "success" > /date.jsp   result >
          action >
      package >


     < package   name = "skill"   extends = "defalut"   name = "/skill" >


                 < defalut-interceptor-ref   name = "crudStack" />


         < action   name = "Edit"   class = "lee.SkillAction" >
             < result > /empmanager/editSkill.jsp  result >
             < intercepor-ref   name = "params"   />
             < interceptor-ref   name = "basicStack"   />

          action >


         < 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 >



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

  default-interceptor-ref >


     < 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