STRUTS2拦截器介绍

拦截器（Interceptor）是Struts 2的核心组成部分。拦截器几乎完成了Struts2框架70%的工作，包括解析请求参数、将请求参数赋值给Action属性、执行数据校验、文件上传……，Struts2设计的灵巧性，更大程度地得益于拦截器设计，当需要扩展Struts2功能时，只需要提供对应拦截器，并将它配置在Struts2容器中即可；如果不需要该功能时，也只需要取消该拦截器的配置即可。这种可插拔式的设计，正是软件设计领域一直孜孜以求的目标。

实际上，Struts2的精髓就在于拦截器，掌握了Struts2的拦截器机制，你就可以说精通了Struts2。从某个角度来看，我们可以把Struts2框架理解成一个空壳，而这些拦截器像一个一个抽屉，随时可以插进入，也可以拔出来——这是软件产品一直追求的目标。
如果你喜欢，你可以把Struts2的全部插件拔出，那么Struts2就成了一个空容器——而这种空，正是 Struts2的魅力，你可以把任何自己想要的东西填入进去，甚至包括自己完全实现这个框架。另一方面，因为Struts2的插件机制,Struts2提供了无限扩展的可能性，你可以把自己想要的任何东西做成插件，然后填入Struts2——这样的结果是：一个企业，一个团队，可以把自己业务相关的东西做成插件，随时随地地复用。也就是说：如果你想要，你可以把Struts2改造成属于自己的框架。

在Struts 2文档中对拦截器的解释为——拦截器是动态拦截Action调用的对象。它提供了一种机制，使开发者可以定义一个特定的功能模块，这个模块可以在 Action执行之前或者之后运行，也可以在一个Action执行之前阻止Action执行。同时也提供了一种可以提取Action中可重用的部分的方式。

Struts 2 拦截器原理

读者可以通过 Struts 2 官方文档说明来理解拦截器，如果读者具有较强的英文阅读能力，建议查阅官方使用文档（ http://struts.apache.org/2.0.11/docs/interceptors.html ）。如图 所示，是拦截器在 Struts 2 中的示意图。

从图 所示内容中可以看出， Struts 2 架构的 Action 被一个或者多个拦截器（拦截器栈）所包围，所有的用户请求都会被拦截器所拦截，然后交给 Action 处理，处理结果以逻辑视图方式返回给用户。而这个调用执行流程，是由 Struts 2 的配置文件来实现的，后面会详细介绍。拦截器是 Struts 2 核心部分之一。

当用户请求到达 Struts 2 的 ServletDispatcher 时， Struts 2 会查找配置文件，并根据其配置实例化相对的拦截器对象，然后串成一个列表（ List ），最后一个一个地调用列表中的拦截器。拦截器时序图如图 5 所示。

在 Struts 2 架构中， Action 的调用都是通过拦截器来实现的。有的读者可能会疑惑，前几章的介绍中，没有明确说明拦截器，为什么可以直接调用 Action ？那是因为 Struts 2 架构如果不做显式的拦截器配置，则系统会调用默认的拦截器来调用 Action ，在用户看来，好像没有配置拦截器。系统默认的拦截器笔者后面会详细介绍。

HelloWorld 拦截器

读者可以按照笔者的步骤，一步一步建立第一个拦截器示例，来体验 Struts 2 框架中拦截器带给读者的惊喜。

（１）  在配置文件中增加拦截器定义和在 Action 中声明拦截器。笔者建立了一个目录 ch5 来对应本章， ch5.xml 配置文件内容如代码 5.8 所示。

代码 5.8  HelloWorld 拦截器配置文件

<? 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 >
     <!--   定义包 -->
< package  name ="ch5"  extends ="struts-default"  namespace ="/ch5" >

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

         < interceptors >

             < interceptor  name ="Myinterceptor"

                class ="ch5.Myintercepor" >

             </ interceptor >

         </ interceptors >

         < action  name ="Reg"  class ="ch5.Reg" >

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

             < result  name ="input" > /ch5/reg.jsp </ result >

             <!--   引用默认拦截器 -->

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

             <!--   引用自定义默认拦截器 -->

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

         </ action >

     </ package >

</ struts >

 

★ 注意 ★

需要读者在 struts.xml 文件中使用 <include file="/ch5/ch5.xml"></include> 将该配置文件包含进去。

 

 （２） 在 ch5 包内建立一个拦截器类 Myintercepor ，如代码 5.9 所示。

代码 5.9  Helloworld 拦截器类 Myintercepor

package  ch5;

import  com.opensymphony.xwork2.ActionInvocation;

import  com.opensymphony.xwork2.interceptor.AbstractInterceptor;

public   class  Myintercepor  extends  AbstractInterceptor  ... {

     // 拦截方法

     public  String intercept(ActionInvocation arg0)  throws  Exception  ... {

        Reg reg  =  (Reg) arg0.getAction();

        System.out.println( " 拦截器信息：HelloWorld拦截器！ " );

         // 执行Action或者执行下一个拦截器

        String result  =  arg0.invoke();

         // 提示Action执行完毕

        System.out.println( " 拦截器信息：Action执行完毕！ " );

         return  result;

    }

}

 

 （３） 在 ch5 包内建立一个业务控制器 Reg ，如代码 5.10 所示。

代码 5.10  HelloWorld 拦截器示例的业务控制器

 

package  ch5;

import  java.util.Date;

import  com.opensymphony.xwork2.ActionSupport;

public   class  Reg  extends  ActionSupport  ... {

     // 定义用户名属性

     private  String username;

     // 定义处理信息：注意同http中的msg不同名称

     private  String mymsg;

     // 定义密码属性

     private  String password1;

     // 定义确认密码

     private  String password2;

     // 定义生日属性

     private  Date birthday;

     public  String execute()  throws  Exception  ... {

         if  (username  !=   null   &&  getPassword1().equals(getPassword2())

                 &&   ! getUsername().trim().equals( "" ))  ... {

             // 输出调试信息

            System.out.println( " Action信息：正在执行Actiion... ... " );

             return  SUCCESS;

        }   else   ... {

             return  INPUT;

        }

    }

     // getter和setter方法

     public  String getUsername()  ... {

         return  username;

    }

     public   void  setUsername(String username)  ... {

         this .username  =  username;

    }

     public  String getMymsg()  ... {

         return  mymsg;

    }

     public   void  setMymsg(String mymsg)  ... {

         this .mymsg  =  mymsg;

    }

     public  String getPassword1()  ... {

         return  password1;

    }

     public   void  setPassword1(String password1)  ... {

         this .password1  =  password1;

    }

     public  String getPassword2()  ... {

         return  password2;

    }

     public   void  setPassword2(String password2)  ... {

         this .password2  =  password2;

    }

     public  Date getBirthday()  ... {

         return  birthday;

    }

     public   void  setBirthday(Date birthday)  ... {

         this .birthday  =  birthday;

    }

}

 

  （４）同样在 ch5 包内，建立一个用户注册 reg.jsp 文件和一个用于显示注册成功信息的 success.jsp 文件。内容分别如代码 5.11 和代码 5.12 所示。

代码 5.11  用户注册界面 reg.jsp

 

<% ... @ page contentType = " text/html;charset=UTF-8 "  language = " java "   %>

<% ... @ taglib prefix = " s "  uri = " /struts-tags "   %>

< html >

< head >

< title > 用户注册 </ title >

< s:head  />

</ head >

< body >

< table >

< s:form  id ="id"  action ="Reg" >

     < s:textfield  name ="username"  label ="用户名：" />

     < s:password  name ="password1"  label ="密码：" />

     < s:password  name ="password2"  label ="确认密码：" />

     < s:datetimepicker  name ="birthday"  label ="生日：" />

     < s:submit  value ="注册" />

</ s:form >

</ table >

</ body >

</ html >

 

代码 5.12  注册成功界面 success.jsp

<% ... @ page contentType = " text/html;charset=UTF-8 "  language = " java "   %>

<% ... @ taglib prefix = " s "  uri = " /struts-tags "   %>

< html >

< head >

< title > 注册成功界面 </ title >

< s:head  />

</ head >

< body >

< table >

< h2 > 用户名： < s:property   value ="username"   /></ h2 >

< h2 > 密码： < s:property   value ="password1"   /></ h2 >

< h2 > 生日： < s:property   value ="birthday"   /></ h2 >

</ table >

</ body >

</ html >

（５）  启动 Tomcat 服务器，在浏览器中输入： http://localhost:8080/bookcode/ch5/reg.jsp ，运行界面如图 所示。

（６）读者可以在“用户名”、“密码”、“确认密码”和“生日”输入框中填入相关字符串，单击“注册”按钮，会发现 Tomcat 控制台输出如下信息：

… …

信息 : Detected AnnotationActionValidatorManager, initializing it...

拦截器信息： HelloWorld 拦截器！

Action 信息：正在执行 Actiion... ...

拦截器信息： Action 执行完毕！

… …

到此为止，第一个拦截器 HelloWorld 示例就建立成功了，读者通过本示例，可以了解拦截器的基本功能。

★ 说明 ★

Struts 2 框架提供的拦截器功能确实给项目开发提供了一个非常有用的手段。后面笔者将会逐步深入介绍 Struts 2 的拦截器。