《研磨struts2》第六章拦截器之 6.3 自定义的拦截器

最新推荐文章于 2024-11-04 22:26:34 发布

tiantongxa

最新推荐文章于 2024-11-04 22:26:34 发布

阅读量454

点赞数

分类专栏： Struts2 文章标签： struts interceptor action java setter login

Struts2 专栏收录该内容

41 篇文章 0 订阅

订阅专栏

本文详细介绍了如何在Struts2中实现自定义拦截器，包括基本接口说明、简单示例以及如何在拦截器中传入参数以实现特定功能。通过实例演示了如何在Action运行前后输出信息，以及如何配置拦截器和参数，确保了拦截器、Action和Result的正确执行顺序。

摘要由CSDN通过智能技术生成

6.3 自定义的拦截器

6.3.1 什么是自定义的拦截器

所谓自定义的拦截器，就是由我们自己定义并实现的拦截器，而不是由Struts2定义好的拦截器。

虽然Struts2的预定义拦截器已经满足了大多数情况的需要。但在有些时候，我们可能会根据项目的实际需要而自定义一些拦截器，来实现一些特别的功能。

比如，我们可能认为Struts2预置的logger拦截器功能比较弱，我们希望在任何一个action运行的时候，都会先打印出所访问的动作类Action，再打印出所有的request参数，最后打印出要跳转到的jsp。这个功能并不影响真正的业务逻辑，但是对调试错误是非常有帮助的，免的我们再手工一一对应和查看。

6.3.2 开发自定义拦截器

好了，了解了什么是自定义的拦截器过后，一起来看看究竟如何实现自定义的拦截器。

其实在Struts2里面，要实现自定义的拦截器是非常简单的，只要写一个实现Interceptor接口的类就可以了。

也就是说，所有的拦截器都要实现com.opensymphony.xwork2.interceptor.Interceptor接口，这个接口中定义如下：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 public interface Interceptor extends Serializable {  
     void destroy();  
     void init();  
     String intercept(ActionInvocation invocation) throws Exception;  
 }  

方法的基本说明如下：

init方法就类似于构造方法，用于初始化一些相关资源
destory方法类似于析构方法，用于释放资源
intercept方法，就是拦截器执行的处理方法，我们要实现的功能主要就写在这个方法里面。

对于intercept方法，再说明几点：

（1）在intercept方法中写“invocation.invoke();”，这句话的意思是继续运行拦截器后续的处理，如果这个拦截器后面还有拦截器，那么会继续运行，一直到运行Action，然后执行Result。

如果intercept方法中没有写“invocation.invoke();”这句话，那就意味着对请求的运行处理到此为止，不再继续向后运行了，换句话说，后续的拦截器和Action就不再执行了。而是在这里返回Result字符串，直接去进行Result处理了。

（2）在“invocation.invoke();”这句话之前写的功能，会在Action运行之前执行

（3）在“invocation.invoke();”这句话之后写的功能，会在Result运行之后执行

（4）intercept方法的返回值就是最终要返回的Result字符串，这个只是在前面没有执行Result的时候才有效，也就是前面没有“invocation.invoke();”这句话的时候，这个返回值就相当于是最终要返回的Result字符串，然后才执行相应的Result处理。

说了这么多，还是来示例一下，看看如何实现自定义的拦截器吧。

1：先来个最简单的，就是在Action运行之前，和Result运行之后输出一点信息，当然，有实际功能需求的时候，就写成实际功能的处理代码了，示例代码如下：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 package cn.javass.action.action;  
   
 import com.opensymphony.xwork2.ActionInvocation;  
 import com.opensymphony.xwork2.interceptor.Interceptor;  
   
 public class MyInterceptor implements Interceptor{    
     public void destroy() {  
         System.out.println("MyInterceptor 销毁");  
     }     
     public void init() {  
         System.out.println("MyInterceptor 初始化");          
     }  
       
     public String intercept(ActionInvocation invocation) throws Exception {  
         System.out.println("在acton执行之前");  
         String result = invocation.invoke();  
         System.out.println("在Result运行之后");  
           
         return result;  
     }  
 }  

可以看到，这个Interceptor的init方法和destroy方法只是输出了一句信息，它的intercept方法用来执行响应，在“invocation.invoke();”这句话之前和之后分别输出了一句信息。最后返回的result，就是invocation.invoke()的返回值。

2：HelloWorldAction这个类不用修改

3：需要到struts.xml里面配置拦截器的声明和引用，示例如下：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 <package name="helloworld"  extends="struts-default">  
     <interceptors>  
             <interceptor name=“myInterceptor” class="cn.javass.action.action.MyInterceptor"/>  
         </interceptors>  
                   
         <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
             <result name="toWelcome">/s2impl/welcome.jsp</result>  
             <interceptor-ref name=“myInterceptor”/>  
             <interceptor-ref name="defaultStack"/>  
         </action>  
 </package>  

在这个<package>元素中，首先声明了一个自定义的拦截器：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 <interceptors>  
         <interceptor name=“myInterceptor” class="cn.javass.action.action.MyInterceptor"/>  
     </interceptors>  

然后在<action>中引用了这个拦截器。

4：运行测试一下，后台输出：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 在acton执行之前  
 用户输入的参数为===account=test,password=test,submitFlag=login  
 在Result运行之后  

可以看到加粗部分就是在拦截器里输出的信息，它分别运行于Action运行之前和Result运行之后。可能有朋友会说，从这里只看到了Action的运行，并没有看到Result的运行啊，你怎么知道是在Result运行之后呢？

很简单，前面增经做过一个自定义的Result，这里来使用它，这样就可以在里面输出信息，从而看出拦截器、Action和Result运行的顺序了。

5：上一章自定义Result的类MyResult不需要改动

6：修改struts.xml，在里面添加上Result的定义，配置如下：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 <package name="helloworld"  extends="struts-default">  
         <result-types>  
             <result-type name="MyResult" class="cn.javass.action.action.MyResult" default="false"/>  
         </result-types>  
                   
         <interceptors>  
             <interceptor name=“myInterceptor” class="cn.javass.action.action.MyInterceptor"/>  
         </interceptors>  
                   
         <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
             <result name="toWelcome" type="MyResult">/s2impl/welcome.jsp</result>  
             <interceptor-ref name=“myInterceptor”/>  
             <interceptor-ref name="defaultStack"/>  
         </action>  
 </package>  

7：再次访问登录页面，重新运行测试，后台的输出为：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 在acton执行之前  
 用户输入的参数为===account=test,password=test,submitFlag=login  
 要处理的Result字符串是=toWelcome  
 在Result运行之后  

加粗的那句话，就是自定义的Result运行时输出的，你会发现，确实是Result运行完成过后，才运行的自定义拦截器中“invocation.invoke();”这句话后面的输出语句的。

另外一点，你要是细心的话，你会发现，在启动服务器的时候，就会输出如下一句：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 MyInterceptor 初始化  

这表明，拦截器在启动服务器的时候，就已经初始化好了。

8：要注意，如果自定义拦截器中没有调用“invocation.invoke();”这句话的话，那么就相当于后续的拦截器和Action都不会运行了，而是直接根据拦截器的intercept方法所直接返回的Result字符串，来匹配和运行Result。

首先，要修改拦截器类，去掉“invocation.invoke();”这句话，直接返回一个Result字符串，示例代码如下：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 public class MyInterceptor implements Interceptor{  
     public void destroy() {  
         System.out.println("MyInterceptor 销毁");  
     }  
     public void init() {  
         System.out.println("MyInterceptor 初始化");          
     }  
     public String intercept(ActionInvocation invocation) throws Exception {  
         System.out.println("在acton执行之前");  
         System.out.println("在Result运行之后");  
         return "toWelcome";  
     }  
 }  

然后再次运行测试，后台的输出为：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 在acton执行之前  
 在Result运行之后  
 要处理的Result字符串是=toWelcome  

也就是说，是先把拦截器的intercept方法执行完成，然后才运行的Result。

6.3.3 向拦截器传入参数

为什么要传入参数呢？因为有些时候，同一个拦截器为不同的Action服务的时候，需要根据传入的参数进行处理上的变化。比如说，一个记录日志的拦截器，可以根据配置来决定到底把日志记录在数据库还是文件里面。

可以把这种配置数据作为一个参数，在配置的时候设置值，会自动传入拦截器中。具体做法还是看个示例比较清楚。

1：首先看看在struts.xml中，如何为拦截器设置参数。

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
         <result name="toWelcome" type="MyResult">/s2impl/welcome.jsp</result>  
         <interceptor-ref name=“myInterceptor”>  
                 <param name="dbOrFile">db</param>  
         </interceptor-ref>  
         <interceptor-ref name="defaultStack"/>  
 </action>  

在这里，通过<param>子元素来为拦截器注入参数，名称是自定义的，当然要与拦截器里面的属性匹配上。

2：拦截器类要想接到这个参数，就必须定义一个对应的属性，并提供setter方法，示例代码如下：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 public class MyInterceptor implements Interceptor{  
     private String dbOrFile;  
     public void setDbOrFile(String dbOrFile) {  
         this.dbOrFile = dbOrFile;  
     }  
     public void destroy() {  
     }  
     public void init() {  
     }  
     public String intercept(ActionInvocation invocation) throws Exception {  
         System.out.println("接到dbOrFile的参数=="+this.dbOrFile);  
         if("db".equalsIgnoreCase(this.dbOrFile)){  
             System.out.println("记录日志到数据库");  
         }else{  
             System.out.println("记录日志到文件");  
         }  
         String result = invocation.invoke();  
         return result;  
     }     
 }  

注意加粗的部分，名称为dbOrFile的属性以及对应的setter方法。这样，在初始化这个拦截器的时候，Struts2就会反射的调用对应的setter，把在<param>元素中配置的值设置到dbOrFile属性上去。

测试运行，后台输出为：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 接到dbOrFile的参数==db  
 记录日志到数据库  
 用户输入的参数为===account=test,password=test,submitFlag=login  
 要处理的Result字符串是=toWelcome  

3：上面是在引用拦截器的时候设置参数，还有另一种方式指定参数。就是在拦截器声明的时候就设置参数，示例配置如下：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 <package name="helloworld"  extends="struts-default">  
         <result-types>  
             <result-type name="MyResult" class="cn.javass.action.action.MyResult" default="false"/>  
         </result-types>  
                   
         <interceptors>  
             <interceptor name=“myInterceptor” class="cn.javass.action.action.MyInterceptor">  
                 <param name="dbOrFile">db</param>  
             </interceptor>  
         </interceptors>  
                   
         <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
             <result name="toWelcome" type="MyResult">/s2impl/welcome.jsp</result>  
             <interceptor-ref name=“myInterceptor”/>    
             <interceptor-ref name="defaultStack"/>  
         </action>  
 </package>  

去运行测试一下，这种配置方式得到的运行效果和前一种方式是一样的。

4：在<interceptor-ref>元素上注册的参数会覆盖在<interceptor>元素上注册的同名参数。示例配置如下：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 <package name="helloworld"  extends="struts-default">  
         <result-types>  
             <result-type name="MyResult" class="cn.javass.action.action.MyResult" default="false"/>  
     </result-types>  
                   
         <interceptors>  
             <interceptor name=“myInterceptor” class="cn.javass.action.action.MyInterceptor">  
                 <param name="dbOrFile">db</param>  
             </interceptor>  
         </interceptors>  
                   
     <action name="helloworldAction" class="cn.javass.action.action.HelloWorldAction">  
         <result name="toWelcome" type="MyResult">/s2impl/welcome.jsp</result>  
         <interceptor-ref name=“myInterceptor”>  
                 <param name="dbOrFile">file</param>  
         </interceptor-ref>                  
         <interceptor-ref name="defaultStack"/>  
 </action>  
 </package>  

再次运行测试，后台输出为：

java代码：

 
    查看 
    复制到剪贴板 
    打印 
   
 接到dbOrFile的参数==file  
 记录日志到文件  
 用户输入的参数为===account=test,password=test,submitFlag=login  
 要处理的Result字符串是=toWelcome  