浅谈Struts2拦截器的原理与实现

时间:2023-01-25 11:10:59

拦截器与过滤器     

     拦截器是对调用的Action起作用,它提供了一种机制可以使开发者定义在一个action执行的前后执行的代码,也可以在一个action执行前阻止其执行。同时也是提供了一种可以提取action中可重用的部分的方式,很多业务逻辑都是靠拦截实现的,比如校验,验证登录权限(比如下载时跳转到登陆页面)等等。
     过滤器是对整个的请求过程起作用!换句话说就是拦截器没有过滤器的范围广。过滤器是在java web中,你传入的request,response提前过滤掉一些信息,或者提前设置一些参数,然后再传入servlet或者struts的 action进行业务逻辑,比如过滤掉非法url(不是login.do的地址请求,如果用户没有登陆都过滤掉),或者在传入servlet或者 struts的action前统一设置字符集,或者去除掉一些非法字符(聊天室经常用到的,一些骂人的话,比如判断用户提交的数据是否存在非法字符等等。

Struts2拦截器是Struts2中的一个很重要的功能,本质是代理模式。本文将从概念开始,为大家讲解Struts2拦截器的实现原理以及如何定义等等内容。

一、理解Struts2拦截器

1. Struts2拦截器是在访问某个Action或Action的某个方法,字段之前或之后实施拦截,并且Struts2拦截器是可插拔的,拦截器是AOP的一种实现

2. 拦截器栈(Interceptor Stack)。Struts2拦截器栈就是将拦截器按一定的顺序联结成一条链。在访问被拦截的方法或字段时,Struts2拦截器链中的拦截器就会按其之前定义的顺序被调用。

二、执行责任

这个执行职责有3种选择:

     1) 中止整个执行,直接返回一个字符串作为resultCode 

    2) 通过递归调用负责调用堆栈中下一个Interceptor的执行 

    3) 如果在堆栈内已经不存在任何的Interceptor,调用Action

三、实现Struts2拦截器原理

Struts2拦截器的实现原理相对简单,当请求struts2的action时,Struts2会查找配置文件,并根据其配置实例化相对应的拦截器对象,然后串成一个列表,最后一个一个地调用列表中的拦截器。

四、定义Struts2拦截器

Struts2规定用户自定义拦截器必须实现com.opensymphony.xwork2.interceptor.Interceptor接口。该接口声明了3个方法

voidinit();
voiddestroy();
String intercept(ActionInvocation invocation)throws Exception;

不过,struts中又提供了几个抽象类来简化这一步骤。其中,init和destroy方法会在程序开始和结束时各执行一遍,不管使用了该拦截器与否,只要在struts.xml中声明了该Struts2拦截器就会被执行。
intercept方法就是拦截的主体了,每次拦截器生效时都会执行其中的逻辑。

public abstract classAbstractInterceptorimplementsInterceptor;
public abstract classMethodFilterInterceptorextendsAbstractInterceptor;

其中AbstractInterceptor提供了init()和destroy()的空实现,使用时只需要覆盖intercept()方法;都是模板方法实现的;而MethodFilterInterceptor则提供了includeMethods和excludeMethods两个属性,用来过滤执行该过滤器的action的方法。可以通过param来加入或者排除需要过滤的方法。

一般来说,拦截器的写法都差不多。看下面的示例:

package interceptor;
import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.Interceptor;
public classMyInterceptorimplementsInterceptor{
publicvoiddestroy(){
// TODO Auto-generated method stub
}
publicvoidinit(){
// TODO Auto-generated method stub
}
public String intercept(ActionInvocation invocation)throws Exception {
System.out.println("Action执行前插入 代码");
//执行目标方法 (调用下一个拦截器, 或执行Action)
final String res = invocation.invoke();
System.out.println("Action执行后插入 代码");
return res;
}

Struts2拦截器需要在struts.xml中声明,如下struts.xml配置文件,配置Struts2拦截器

<?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>
<constant name="struts.objectFactory" value="spring" />
<package name="default" extends="struts-default">
<interceptors>
<interceptor name="MyInterceptor" class="interceptor.MyInterceptor"></interceptor>
<interceptor-stack name="myInterceptorStack">
<interceptor-ref name="MyInterceptor" />
<interceptor-ref name="defaultStack" />
</interceptor-stack>
</interceptors>
<action name="loginAction" class="loginAction">
<result name="fail">/index.jsp </result>
<result name="success">/success.jsp</result>
<interceptor-ref name="myInterceptorStack"></interceptor-ref>
</action>
</package>
</struts>

拦截器全套简单例子:

  <body>
<form action="loginAction" method="post" >
用户名:<input type="text" name="user.name" />
密码: <input type="password" name="user.password" />
<input type="submit" value="登录按钮" >
</form>
</body>

login.jsp  登陆页面

  <!-- Struts2核心过滤器 -->
<filter>
<filter-name>struts2</filter-name>
<filter-class>
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
</filter-class>
</filter> <filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>

web.xml  web配置文件

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "struts-2.1.dtd" >
<struts>
<package name="struts2" extends="struts-default" namespace="/" > <!-- 拦截器 -->
<interceptors>
<!-- 配置自己的拦截器 -->
<interceptor name="myTime" class="com.interceptor.TimeConsumingInterceptor"/>
<interceptor name="myLogin" class="com.interceptor.CheckLoginInterceptor"/>
<interceptor name="myother" class="com.interceptor.OtherInterceptor"></interceptor> <!-- 配置拦截器栈 -->
<interceptor-stack name="myStack">
<!-- 默认自带的拦截器,当配置自己的拦截器时不再走默认的拦截器,所以需要调用自带的拦截器,并写在第一行 -->
<interceptor-ref name="defaultStack"/>
<!-- 加入自己的拦截器 -->
<interceptor-ref name="myTime"/>
<interceptor-ref name="myLogin"/>
</interceptor-stack>
</interceptors> <!-- 定义默认的拦截器 每个Action都会自动引用,如果Action中引用了其它的拦截器 默认的拦截器将无效 -->
<default-interceptor-ref name="myStack"/> <action name="*Action" class="com.struts.UsersAction" method="{1}" >
<!-- 定义局部的拦截器:
当定义局部的拦截器,外面全局(默认)的拦截器则不会走,只会走局部的拦截器,
所以,我们在定义局部拦截器的同时,也要引用Struts2自带的默认拦截器defaultStack。
不引用defaultStack至少会遭成取不到form表单提交的值。 <interceptor-ref name="defaultStack"/>
<interceptor-ref name="myother"/>
-->
<!-- name属性不写默认success -->
<result >/home.jsp</result>
<result name="login">/file.jsp</result>
<result name="input">/login.jsp</result>
</action>
</package>
</struts>

struts.xml  struts2配置文件

package com.entity;
/**
* 用户类
* @author asus
*
*/
public class Users { /** 属性 */
private String name;
private String password; /** 构造方法 */
public Users() {
super();
}
public Users(String name, String password) {
super();
this.name = name;
this.password = password;
} /** javaBean */
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
} }

Users.java  用户实体类

package com.interceptor;

import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
/**
* 拦截器类
* 作用:计算用户从开始登录到结束登录消耗的毫秒数
* @author asus
*
*/
public class TimeConsumingInterceptor extends AbstractInterceptor { @Override
public String intercept(ActionInvocation invocation) throws Exception {
System.out.println("执行顺序:1进入TimeConsumingInterceptor"); //开始时间
long startTime = System.currentTimeMillis();
System.out.println("执行顺序:2输出开始时间startTime:"+startTime);
//调用下一个拦截器,如果拦截器不存在,则执行Action。
String result = invocation.invoke();
System.out.println("执行顺序:5输出Action返回的结果:"+result);
//结束时间
long endTimen = System.currentTimeMillis();
System.out.println("执行顺序:6输出结束时间endTimen:"+endTimen);
//登陆使用时间
System.out.println("登陆使用时间:"+(endTimen-startTime)+"毫秒。。。");
return result;
} }

TimeConsumingInterceptor.java  拦截器

package com.interceptor;

import javax.servlet.http.HttpServletRequest;

import org.apache.struts2.ServletActionContext;

import com.entity.Users;
import com.opensymphony.xwork2.Action;
import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.Interceptor; /**
* 拦截器类
* 作用:检查用户是否登陆,没有登录则不能向Action发送请求。
*
* 测试请url访问:loginUsers.action
* @author asus
*
*/
public class CheckLoginInterceptor implements Interceptor { @Override/** 销毁的方法 */
public void destroy() {
// TODO Auto-generated method stub } @Override/** 初始化方法 */
public void init() {
// TODO Auto-generated method stub } @Override/** 拦截器 */
public String intercept(ActionInvocation invocation) throws Exception {
System.out.println("执行顺序:3进入CheckLoginInterceptor");
//得到request对象
HttpServletRequest request = ServletActionContext.getRequest();
//取得登陆页面用户输入的账号密码若不为空的话让其通过
String name = request.getParameter("user.name");
String password = request.getParameter("user.password");
//取session中保存的用户登录信息
Users users = (Users) invocation.getInvocationContext().getSession().get("users");
if(name!=null && password!=null){
//若是登陆页面请求Action,则通过
return invocation.invoke();
}else if(users==null){
return Action.INPUT;//input常量
} //若已经登陆,则让其通过访问下一个拦截器,或Action。
return invocation.invoke();
} }

CheckLoginInterceptor.java  拦截器

package com.interceptor;

import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
/**
* 拦截器
* 作用:测试定义局部拦截器执行顺序。
* @author asus
*
*/
public class OtherInterceptor extends AbstractInterceptor { @Override
public String intercept(ActionInvocation invocation) throws Exception { System.out.println("局部拦截器");
return invocation.invoke();
} }

OtherInterceptor.java  拦截器

package com.struts;

import com.entity.Users;
import com.opensymphony.xwork2.ActionSupport;
/**
* 控制器类
* 作用:处理用户的请求
* @author asus
*
*/
public class UsersAction extends ActionSupport { /** 属性 */
private Users user; /** 重写execute方法 :此方法作用,为指定处理请求的方法时,默认走此方法*/
public String execute(){ return "";
} /** 登陆验证的方法 */
public String login(){
System.out.println("执行顺序:4进入login()"); if(user!=null){
if(user.getName().equals("admin") && user.getPassword().equals("admin")){
return SUCCESS;
}
} return LOGIN;
} /** JavaBean */
public Users getUser() {
return user;
} public void setUser(Users user) {
this.user = user;
} }

UsersAction.java  控制器

  <body>
登录成功进入首页。。
</body>

home.jsp  登录成功页面

  <body>
登陆失败页面。。
</body>

file.jsp  登录失败页面

全局拦截器:控制台输出登录成功的拦截器执行顺序。

浅谈Struts2拦截器的原理与实现

局部拦截器:控制台输出登录成功的拦截器执行顺序。当定义局部拦截器时,则不会再走全局拦截器。

浅谈Struts2拦截器的原理与实现