Struts 2 拦截器之拦截器的使用

jopen 8年前

          一旦定义了拦截器和拦截器栈后,就可以使用这个拦截器或拦截器栈来拦截器Action了。拦截器的拦截行为将会在Actionexecute方法执行之前执行。

         一、实现拦截器类

          虽然Struts 2框架提供了许多拦截器,这些拦截器也实现了Struts 2的大部分功能。但是用户仍然可以开发自己的拦截器。

          实现自己的拦截器,应该实现com.opensymphoney.xwork2.interceptor.Interceptor接口

          该接口包含三个方法:init() destroy()interceptor(ActionInvocation invocation)

          init():在该拦截器被实例化之后,在该拦截器执行拦截之前,系统将会回调该方法。该方法主要用于初始化资源。对于每一个拦截器而言,其init()方法只会执行一次。        

          destroy():该方法在拦截器实例被销毁之前被系统回调。该方法用于销毁init()方法里打开的资源  

          interceptor(ActionInvocation invocation):该方法是用户需要实现的拦截动作。该方法会返回一个字符串,系统将会跳转到该逻辑视图对应的实际视图资源,不会调用被拦截的Action

          Struts 2还提供了一个AbstractInterceptor类,该类提供了一个initdestroy方法的空实现,如果我们实现的拦截器不需要打开资源,则可以无须实现这两个方法。由此可见,继承AbstractInterceptor类来实现自定义拦截器会更加简单。

          下面实现一个简单的拦截器:

public class SimpleInterceptor extends AbstractInterceptor {   // 简单拦截器的名字   private String name;     public void setName(String name) {    this.name = name;   }     @Override   public String intercept(ActionInvocation invocation) throws Exception {    //取得被拦截的Action实例    LoginAction action = (LoginAction) invocation.getAction();    //打印执行开始的实现    System.out.println(name+"拦截器的动作----------开始执行登录Action的时间:"+new Date());    //取得开始执行Action的时间    long start = System.currentTimeMillis();    //执行该拦截器的后一个拦截器    //如果该拦截器没有其他拦截器,则直接执行Action的execute方法    String result = invocation.invoke();    //打印执行结束的时间    System.out.println(name+"拦截器的动作----------执行完登录Action的时间:"+new Date());    long end = System.currentTimeMillis();    System.out.println(name+"拦截器的动作----------执行完该Action的事件为:"+(end-start)+"毫秒");        return result;   }  }


         当我们实现interceptor方法时,可以获得ActionInvocation参数,这个参数可以获得被拦截的Action实例,一旦取得了Action实例,几乎获得了全部的控制权。

 

         二、使用拦截器

         实现了拦截器类后,就是配置拦截器,使用拦截器。使用拦截器需要以下两个步骤:

            1、通过<interceptor.../>元素来定义拦截器。

            2、通过<interceptor-ref.../>元素来使用拦截器。 

         拦截器的配置如下:

<package name="mystruts" extends="struts-default">    <!-- 应用所需使用的拦截器都在改元素下配置 -->    <interceptors>     <!-- 配置没有simple拦截器 -->     <interceptor name="mysimple" class="com.app.interceptor.SimpleInterceptor">      <!-- 为该拦截器指定参数值 -->      <param name="name">简单拦截器</param>     </interceptor>    </interceptors>        <action name="login" class="com.app.action.LoginAction">     <result name="error">/error.jsp</result>     <result name="success">/welcome.jsp</result>     <!-- 配置系统的默认拦截器 -->     <interceptor-ref name="defaultStack"></interceptor-ref>     <!-- 应用自定义的mysimple拦截器 -->     <interceptor-ref name="mysimple">      <param name="name">改名后的拦截器</param>     </interceptor-ref>    </action>   </package>

         这个拦截器只是一个简单地在控制台打印一些文本,获取被拦截方法的执行时间信息。

         当浏览者在浏览器中对该Action发送请求时,该拦截器将会拦截该Actionexecute方法,将会在控制台看到如下结果:


         三、拦截方法的拦截器

         在默认情况下,如果我们为某个Action定义了拦截器,则这个拦截器会拦截该Action内所有方法,但是有时我们不需要拦截所有方法,只需要拦截指定的方法。此时需要使用Struts 2拦截器的方法过滤特性。

         为了实现方法的过滤的特性,Struts 2提供了一个MethodFilterInterceptor类,该类是AbstractInterceptor类的子类如果用户需要自己实现的拦截器支持方法过滤特性,则应该继承MethodFilterInterceptor。并且需要重写doIntercept(ActionInvocation invocation)方法。

         实际上实现方法过滤的拦截器与实现普通拦截器并没没什么区别。所以这里就不展示代码了。

         MethodFilterInterceptor类中,增加了如下两个方法:

         1、public void setExcludeMethods(String excludeMethods):排除需要过滤的方法,所有在  excludeMethods字符串中列出的方法都不会被拦截

         2、public void setIncludeMethods(String includeMethods):设置需要过滤的方法,所有在includeMethods字符串中列出的方法都会被拦截。

         注:如果一个方法同时在excludeMethodsincludeMethods中列出,则该方法会被拦截。

         通过上面两个方法,我们可以在配置文件中指定需要被拦截,或者不被拦截的方法。

         如下:

<interceptor-ref name="myfilter">      <!-- 指定execute方法不需要被拦截 -->      <param name="excludeMethods">execute</param>      <!-- 指定login方法需要被拦截 -->      <param name="includeMethods">login</param>     </interceptor-ref>

         如果需要同时指定多个方法不需要被拦截器拦截,则多个方法之间以英文逗号隔开

         如下:

<interceptor-ref name="myfilter">      <!-- 指定execute方法和login方法不需要被拦截 -->      <param name="excludeMethods">execute,login</param>     </interceptor-ref>

         如果excludeMethods参数和includeMethods参数同时知道指定了一个方法名,则该方法会被拦截器拦截。

         如下:

<interceptor-ref name="myfilter">      <!-- 指定execute方法和login方法不需要被拦击 -->      <param name="excludeMethods">execute,login</param>      <!-- 指定login方法需要被拦截 -->      <param name="includeMethods">login</param>     </interceptor-ref>

         上面的配置中通过excludeMethods参数指定executelogin方法不需要被拦截,includeMethods参数指定login方法需要被拦截,则拦截器会拦截login方法。

         

         四、拦截器的执行顺序

         随着系统中配置拦截器的顺序不同,系统执行拦截器的顺序也会不同。通常认为:先配置的拦截器,会先获得执行机会,但是有时候也会存在一些特殊的情况。

         有如下的配置文件:

<package name="mystruts" extends="struts-default">    <!-- 应用所需使用的拦截器都在改元素下配置 -->    <interceptors>     <!-- 配置没有simple拦截器 -->     <interceptor name="mysimple" class="com.app.interceptor.SimpleInterceptor">      <!-- 为该拦截器指定参数值 -->      <param name="name">简单拦截器</param>     </interceptor>    </interceptors>        <action name="login" class="com.app.action.LoginAction">     <result name="error">/error.jsp</result>     <result name="success">/welcome.jsp</result>     <!-- 配置系统的默认拦截器 -->     <interceptor-ref name="defaultStack"></interceptor-ref>     <!-- 应用自定义的mysimple拦截器 -->     <interceptor-ref name="mysimple">      <param name="name">第一个</param>     </interceptor-ref>     <interceptor-ref name="mysimple">      <param name="name">第二个</param>     </interceptor-ref>    </action>   </package>

         通过上面的配置文件中我们可以看到,对于上面的名为loginAction,有两次使用了mysimple拦截器拦截该Action。两个拦截器名分别为:第一个、第二个。

         当用户再浏览器中向该Action发送请求时,就会看到如下效果:



         从上面的效果中可以看到,对于在execute方法之前的动作,第一个拦截器会先起作用,也就是说配置在前面的拦截器会先起作用;对于在execute方法之后的动作,则第二个拦截器先起作用,也就是说,配置在后的拦截器会先起作用。

         所有可以得到如下结论:在Action的控制方法执行之前,位于拦截器链前面的拦截器会先起作用。在Action控制方法执行之后,位于拦截器链后面的拦截器会先起作用。



 读李刚《轻量级Java EE企业应用实战》

来自: http://blog.csdn.net/chenssy/article/details/7354645