详述 Spring MVC 框架中拦截器 Interceptor 的使用方法

详述 Spring MVC 框架中拦截器 Interceptor 的使用方法

1 前言
　 之前，也在网络上搜了很多关于Interceptor的文章，但感觉内容都大同小异，而且知识点零零散散，不太方便阅读。因此，正好借此机会，整理一篇关于拦截器的文章，在此分享给大家，以供大家参考阅读。

2 拦截器
2.1 概念
　　Java 里的拦截器是动态拦截 action 调用的对象。它提供了一种机制可以使开发者可以定义在一个 action 执行的前后执行的代码，也可以在一个 action 执行前阻止其执行，同时也提供了一种可以提取 action 中可重用部分的方式。在AOP（Aspect-Oriented Programming，面向切面编程）中拦截器用于在某个方法或字段被访问之前进行拦截，然后在之前或之后加入某些操作。

2.2 原理
　　拦截器 Interceptor 的拦截功能是基于 Java 的动态代理来实现的，具体可以参考博文“ 用 Java 实现拦截器 Interceptor 的拦截功能 ”，也可以通过阅读 Spring 源代码来了解更为权威的实现细节。

3 实现方法
　　在 Spring 框架之中，咱们要想实现拦截器的功能，主要通过两种途径，第一种是实现HandlerInterceptor接口，第二种是实现WebRequestInterceptor接口。接下来，咱们分别详细的介绍两者的实现方法。

3.1 HandlerInterceptor 接口
在HandlerInterceptor接口中，定义了 3 个方法，分别为preHandle()、postHandle()和afterCompletion()，咱们就是通过复写这 3 个方法来对用户的请求进行拦截处理的。因此，咱们可以通过直接实现HandlerInterceptor接口来实现拦截器的功能。不过在 Spring 框架之中，其还提供了另外一个接口和一个抽象类，实现了对HandlerInterceptor接口的功能扩展，分别为：AsyncHandlerInterceptor和HandlerInterceptorAdapter.

对于AsyncHandlerInterceptor接口，其在继承HandlerInterceptor接口的同时，又声明了一个新的方法afterConcurrentHandlingStarted()；而HandlerInterceptorAdapter抽象类，则是更进一步，在其继承AsyncHandlerInterceptor接口的同时，又复写了preHandle方法。因此，AsyncHandlerInterceptor更像是一个过渡的接口。

在实际应用中，咱们一般都是通过实现HandlerInterceptor接口或者继承HandlerInterceptorAdapter抽象类，复写preHandle()、postHandle()和afterCompletion()这 3 个方法来对用户的请求进行拦截处理的。下面，咱们就详细介绍这个 3 个方法。

preHandle(HttpServletRequest request, HttpServletResponse response, Object handle)方法，该方法在请求处理之前进行调用。SpringMVC 中的 Interceptor 是链式调用的，在一个应用中或者说是在一个请求中可以同时存在多个 Interceptor 。每个 Interceptor 的调用会依据它的声明顺序依次执行，而且最先执行的都是 Interceptor 中的 preHandle 方法，所以可以在这个方法中进行一些前置初始化操作或者是对当前请求做一个预处理，也可以在这个方法中进行一些判断来决定请求是否要继续进行下去。该方法的返回值是布尔值 Boolean 类型的，当它返回为 false 时，表示请求结束，后续的 Interceptor 和 Controller 都不会再执行；当返回值为 true 时，就会继续调用下一个 Interceptor 的 preHandle 方法，如果已经是最后一个 Interceptor 的时候，就会是调用当前请求的 Controller 中的方法。
postHandle(HttpServletRequest request, HttpServletResponse response, Object handle, ModelAndView modelAndView)方法，通过 preHandle 方法的解释咱们知道这个方法包括后面要说到的 afterCompletion 方法都只能在当前所属的 Interceptor 的 preHandle 方法的返回值为 true 的时候，才能被调用。postHandle 方法在当前请求进行处理之后，也就是在 Controller 中的方法调用之后执行，但是它会在 DispatcherServlet 进行视图返回渲染之前被调用，所以咱们可以在这个方法中对 Controller 处理之后的 ModelAndView 对象进行操作。postHandle 方法被调用的方向跟 preHandle 是相反的，也就是说，先声明的 Interceptor 的 postHandle 方法反而会后执行。这和 Struts2 里面的 Interceptor 的执行过程有点类型，Struts2 里面的 Interceptor 的执行过程也是链式的，只是在 Struts2 里面需要手动调用 ActionInvocation 的 invoke 方法来触发对下一个 Interceptor 或者是 action 的调用，然后每一个 Interceptor 中在 invoke 方法调用之前的内容都是按照声明顺序执行的，而 invoke 方法之后的内容就是反向的。
afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handle, Exception ex)方法，也是需要当前对应的 Interceptor 的 preHandle 方法的返回值为 true 时才会执行。因此，该方法将在整个请求结束之后，也就是在 DispatcherServlet 渲染了对应的视图之后执行，这个方法的主要作用是用于进行资源清理的工作。
接下来，咱们在看看以上接口和抽象类的具体代码：

HandlerInterceptor 接口：

package org.springframework.web.servlet;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public interface HandlerInterceptor {

boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
    throws Exception;

void postHandle(
        HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)
        throws Exception;

void afterCompletion(
        HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
        throws Exception;

}

AsyncHandlerInterceptor 接口：

package org.springframework.web.servlet;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public interface AsyncHandlerInterceptor extends HandlerInterceptor {

void afterConcurrentHandlingStarted(
        HttpServletRequest request, HttpServletResponse response, Object handler)
        throws Exception;

}

HandlerInterceptorAdapter 抽象类：

package org.springframework.web.servlet.handler;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.AsyncHandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

/**
* Abstract adapter class for the HandlerInterceptor interface,
* for simplified implementation of pre-only/post-only interceptors.
*
* @author Juergen Hoeller
* @since 05.12.2003
*/
public abstract class HandlerInterceptorAdapter implements AsyncHandlerInterceptor {

/**
 * This implementation always returns {@code true}.
 */
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
    throws Exception {
    return true;
}

/**
 * This implementation is empty.
 */
public void postHandle(
        HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)
        throws Exception {
}

/**
 * This implementation is empty.
 */
public void afterCompletion(
        HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
        throws Exception {
}

/**
 * This implementation is empty.
 */
public void afterConcurrentHandlingStarted(
        HttpServletRequest request, HttpServletResponse response, Object handler)
        throws Exception {
}

}

如上面的代码所示，其实在HandlerInterceptor和AsyncHandlerInterceptor中还有很多的代码注释，只是博主感觉太多了，就将其全部删除啦！如果大家对这些注释感兴趣的话，可以自行查看源代码。下面，咱们以继承HandlerInterceptorAdapter抽象类为例进行演示：

package com.hit.interceptor;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**

*/

public class WrongCodeInterceptor extends HandlerInterceptorAdapter {

@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
        throws Exception {
    System.out.println("WrongCodeInterceptor, preHandle......");
    return true;
}

@Override
public void postHandle(
        HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)
        throws Exception {
    System.out.println("WrongCodeInterceptor, postHandle......");
}

@Override
public void afterCompletion(
        HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
        throws Exception {
    System.out.println("WrongCodeInterceptor, afterCompletion......");
}

@Override
public void afterConcurrentHandlingStarted(
        HttpServletRequest request, HttpServletResponse response, Object handler)
        throws Exception {
    System.out.println("WrongCodeInterceptor, afterConcurrentHandlingStarted......");
}

}

3.2 WebRequestInterceptor 接口
在WebRequestInterceptor接口中也定义了 3 个方法，同HandlerInterceptor接口完全相同，咱们也是通过复写这 3 个方法来用户的请求进行拦截处理的。而且这 3 个方法都传递了同一个参数 WebRequest，那么这个 WebRequest 到底是什么呢？其实这个 WebRequest 是 Spring 中定义的一个接口，它里面的方法定义跟 HttpServletRequest 类似，在WebRequestInterceptor中对 WebRequest 进行的所有操作都将同步到 HttpServletRequest 中，然后在当前请求中依次传递。

在 Spring 框架之中，还提供了一个和WebRequestInterceptor接口长的很像的抽象类，那就是：WebRequestInterceptorAdapter，其实现了AsyncHandlerInterceptor接口，并在内部调用了WebRequestInterceptor接口。

接下来，咱们主要讲一下WebRequestInterceptor接口的 3 个函数：

preHandle(WebRequest request)方法，该方法在请求处理之前进行调用，也就是说，其会在 Controller 中的方法调用之前被调用。这个方法跟 HandlerInterceptor 中的 preHandle 不同，主要区别在于该方法的返回值是void 类型的，也就是没有返回值，因此我们主要用它来进行资源的准备工作，比如我们在使用 Hibernate 的时候，可以在这个方法中准备一个 Hibernate 的Session 对象，然后利用 WebRequest 的 setAttribute(name, value, scope) 把它放到 WebRequest 的属性中。在这里，进一步说说 setAttribute 方法的第三个参数 scope ，该参数是一个Integer 类型的。在 WebRequest 的父层接口 RequestAttributes 中对它定义了三个常量，分别为：
SCOPE_REQUEST ，它的值是 0，表示只有在 request 中可以访问。
SCOPE_SESSION，它的值是1，如果环境允许的话，它表示的是一个局部的隔离的 session，否则就代表普通的 session，并且在该 session 范围内可以访问。
SCOPE_GLOBAL_SESSION，它的值是 2，如果环境允许的话，它表示的是一个全局共享的 session，否则就代表普通的 session，并且在该 session 范围内可以访问。
postHandle(WebRequest request, ModelMap model)方法，该方法在请求处理之后，也就是在 Controller 中的方法调用之后被调用，但是会在视图返回被渲染之前被调用，所以可以在这个方法里面通过改变数据模型 ModelMap 来改变数据的展示。该方法有两个参数，WebRequest 对象是用于传递整个请求数据的，比如在 preHandle 中准备的数据都可以通过 WebRequest 来传递和访问；ModelMap 就是 Controller 处理之后返回的 Model 对象，咱们可以通过改变它的属性来改变返回的 Model 模型。
afterCompletion(WebRequest request, Exception ex)方法，该方法会在整个请求处理完成，也就是在视图返回并被渲染之后执行。因此可以在该方法中进行资源的释放操作。而 WebRequest 参数就可以把咱们在 preHandle 中准备的资源传递到这里进行释放。Exception 参数表示的是当前请求的异常对象，如果在 Controller 中抛出的异常已经被 Spring 的异常处理器给处理了的话，那么这个异常对象就是是 null.
接下来，咱们在看看以上接口和抽象类的具体代码：

WebRequestInterceptor 接口：

package org.springframework.web.context.request;

import org.springframework.ui.ModelMap;

public interface WebRequestInterceptor {

void preHandle(WebRequest request) throws Exception;

void postHandle(WebRequest request, ModelMap model) throws Exception;

void afterCompletion(WebRequest request, Exception ex) throws Exception;

}

WebRequestInterceptorAdapter 抽象类：

package org.springframework.web.servlet.handler;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.util.Assert;
import org.springframework.web.context.request.AsyncWebRequestInterceptor;
import org.springframework.web.context.request.WebRequestInterceptor;
import org.springframework.web.servlet.AsyncHandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

/**
* Adapter that implements the Servlet HandlerInterceptor interface
* and wraps an underlying WebRequestInterceptor.
*
* @author Juergen Hoeller
* @since 2.0
* @see org.springframework.web.context.request.WebRequestInterceptor
* @see org.springframework.web.servlet.HandlerInterceptor
*/
public class WebRequestHandlerInterceptorAdapter implements AsyncHandlerInterceptor {

private final WebRequestInterceptor requestInterceptor;


/**
 * Create a new WebRequestHandlerInterceptorAdapter for the given WebRequestInterceptor.
 * @param requestInterceptor the WebRequestInterceptor to wrap
 */
public WebRequestHandlerInterceptorAdapter(WebRequestInterceptor requestInterceptor) {
    Assert.notNull(requestInterceptor, "WebRequestInterceptor must not be null");
    this.requestInterceptor = requestInterceptor;
}


public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
        throws Exception {

    this.requestInterceptor.preHandle(new DispatcherServletWebRequest(request, response));
    return true;
}

public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)
        throws Exception {

    this.requestInterceptor.postHandle(new DispatcherServletWebRequest(request, response),
            (modelAndView != null && !modelAndView.wasCleared() ? modelAndView.getModelMap() : null));
}

public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
        throws Exception {

    this.requestInterceptor.afterCompletion(new DispatcherServletWebRequest(request, response), ex);
}

public void afterConcurrentHandlingStarted(HttpServletRequest request, HttpServletResponse response, Object handler) {
    if (this.requestInterceptor instanceof AsyncWebRequestInterceptor) {
        AsyncWebRequestInterceptor asyncInterceptor = (AsyncWebRequestInterceptor) this.requestInterceptor;
        DispatcherServletWebRequest webRequest = new DispatcherServletWebRequest(request, response);
        asyncInterceptor.afterConcurrentHandlingStarted(webRequest);
    }
}

}

如上面的代码所示，展示了WebRequestInterceptor接口和WebRequestInterceptorAdapter抽象类的源码。下面，咱们以实现WebRequestInterceptor接口为例进行演示：

package com.hit.interceptor;

import org.springframework.ui.ModelMap;
import org.springframework.web.context.request.WebRequest;
import org.springframework.web.context.request.WebRequestInterceptor;

/**

*/

public class WrongCodeInterceptor implements WebRequestInterceptor {

@Override
public void preHandle(WebRequest request) throws Exception {
    System.out.println("WrongCodeInterceptor, preHandle......");
}

@Override
public void postHandle(WebRequest request, ModelMap model) throws Exception {
    System.out.println("WrongCodeInterceptor, postHandle......");
}

@Override
public void afterCompletion(WebRequest request, Exception ex) throws Exception {
    System.out.println("WrongCodeInterceptor, afterCompletion......");
}

}

3.3 AbstractInterceptor 抽象类
除了上面3.2 和3.3所讲的内容，咱们还可以通过继承 Struts2 框架提供的AbstractInterceptor抽象类来实现拦截的功能。如果咱们在深入一点研究，会发现AbstractInterceptor实现了Interceptor接口，而Interceptor接口又继承了Serializable接口。

在Interceptor接口中，提供了 3 个方法供咱们使用，分别为init()、destroy()和intercept()，由于AbstractInterceptor实现了Interceptor接口，因此咱们就可以直接继承AbstractInterceptor，然后复写方法就可以啦！至于为什么继承AbstractInterceptor而不是直接实现Interceptor接口，是因为AbstractInterceptor已经帮咱们实现了空的init()和destroy()方法，不需要咱们自己去复写了，咱们直接复写intercept()方法就可以啦！现在，咱们大致了解一下这 3 个方法的作用：

init()方法，一般用来进行初始化操作；
destroy()方法，一般用来进行释放资源的操作；
intercept()方法，该方法是实现拦截功能的主要方法，咱们就在该方法中编写拦截的逻辑。
接下来，咱们在看看以上接口和抽象类的具体代码：

Interceptor 接口：

package com.opensymphony.xwork2.interceptor;

import com.opensymphony.xwork2.ActionInvocation;

import java.io.Serializable;

public interface Interceptor extends Serializable {

/**
 * Called to let an interceptor clean up any resources it has allocated.
 */
void destroy();

/**
 * Called after an interceptor is created, but before any requests are processed using
 * {@link #intercept(com.opensymphony.xwork2.ActionInvocation) intercept} , giving
 * the Interceptor a chance to initialize any needed resources.
 */
void init();

/**
 * Allows the Interceptor to do some processing on the request before and/or after the rest of the processing of the
 * request by the {@link ActionInvocation} or to short-circuit the processing and just return a String return code.
 *
 * @param invocation the action invocation
 * @return the return code, either returned from {@link ActionInvocation#invoke()}, or from the interceptor itself.
 * @throws Exception any system-level error, as defined in {@link com.opensymphony.xwork2.Action#execute()}.
 */
String intercept(ActionInvocation invocation) throws Exception;

}

AbstractInterceptor 接口：

package com.opensymphony.xwork2.interceptor;

import com.opensymphony.xwork2.ActionInvocation;

/**
* Provides default implementations of optional lifecycle methods
*/
public abstract class AbstractInterceptor implements Interceptor {

/**
 * Does nothing
 */
public void init() {
}

/**
 * Does nothing
 */
public void destroy() {
}

/**
 * Override to handle interception
 */
public abstract String intercept(ActionInvocation invocation) throws Exception;

}

如上面的代码所示，展示了Interceptor接口和AbstractInterceptor抽象类的源码。下面，咱们以继承AbstractInterceptor抽象类为例进行演示：

package com.hit.interceptor;

import com.opensymphony.xwork2.ActionInvocation;
import com.opensymphony.xwork2.interceptor.AbstractInterceptor;
import org.apache.struts2.ServletActionContext;

/**
* @author 维C果糖
* @create 2017-03-31
*/

public class WrongCodeInterceptor extends AbstractInterceptor {

/**
 * 通过拦截功能，验证用户是否登录
 */
public String intercept(ActionInvocation invocation) throws Exception {

    UserInfo info = (UserInfo) ServletActionContext.getRequest().getSession().getAttribute("user");

    if(info != null && !info.getName().equals("") && !info.getPwd().equals(""))
    {
        return invocation.invoke();
    }
    return "login";
}

}

UserInfo 类文件：

/**

*/

public class UserInfo {
String name;
String pwd;

public String getName() {
    return name;
}

public void setName(String name) {
    this.name = name;
}

public String getPwd() {
    return pwd;
}

public void setPwd(String pwd) {
    this.pwd = pwd;
}

}

4 配置拦截器
在前面，咱们用了很大篇幅的内容讲述了拦截器如何实现，因此，我相信大家实现拦截器已经没有问题啦！接下来，咱们在看看，如何在 XML 文件中配置拦截器，使咱们的拦截器生效。

在配置拦截器之前，有 4 个名称的概念需要大家先了解一下，分别为：Join Point、Pointcut、Advice和Advisor.

Join Point，表示“连接点”，它是程序运行中的某个阶段点，比如方法的调用、异常的抛出等；
Advice，表示“通知”，它是某个连接点所采用的处理逻辑，也就是向连接点注入的代码；
Pointcut，表示“切入点”，它是“连接点”的集合，是程序中需要注入 Advice 的位置的集合，指明 Advice 要在什么样的条件下才能被触发；
Advisor，它是 Pointcut 和 Advice 的配置器，包括 Pointcut 和 Advice，是将 Advice 注入程序中 Pointcut 位置的代码。
接下来，给出 XML 配置文件的声明：