一篇文章带你搞定 SpringMVC 中的拦截器

一、拦截器的作用

Spring MVC 的处理器拦截器类似于 Servlet 开发中的过滤器 Filter，用于对处理器进行预处理和后处理。
用户可以自己定义一些拦截器来实现特定的功能。
谈到拦截器，还要向大家提一个词——拦截器链（Interceptor Chain）。
拦截器链就是将拦截器按一定的顺序联结成一条链。在访问被拦截的方法或字段时，拦截器链中的拦截器就会按其之前定义的顺序被调用。

说到这里，可能大家脑海中有了一个疑问，这不是我们之前学的过滤器吗？是的它和过滤器是有几分相似，但是也有区别，接下来我们就来说说他们的区别：

过滤器是 servlet 规范中的一部分， 任何 java web 工程都可以使用。
拦截器是 SpringMVC 框架自己的，只有使用了 SpringMVC 框架的工程才能用。
过滤器在 url-pattern中配置了/*之后，可以对所有要访问的资源拦截。

拦截器它是只会拦截访问的控制器方法，如果访问的是 jsp， html,css,image 或者 js 是不会进行拦截的。

它也是 AOP 思想的具体应用。
我们要想自定义拦截器， 要求必须实现： HandlerInterceptor 接口。

二、自定义拦截器的步骤

（1）创建类，实现HandlerInterceptor接口，重写需要的方法

/**
 * 自定义拦截器
 */
public class MyInterceptor1 implements HandlerInterceptor {

    /**
     * 预处理，controller方法执行前
     * return true 放行，执行下一个拦截器，如果没有，执行controller中的方法
     * return false不放行
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("MyInterceptor1执行了---前");
        // request.getRequestDispatcher("/WEB-INF/pages/error.jsp").forward(request,response);
        return true;
    }

    /**
     * 后处理方法，controller方法执行后，success.jsp执行之前
     */
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("MyInterceptor1执行了---后");
        // request.getRequestDispatcher("/WEB-INF/pages/error.jsp").forward(request,response);
    }

    /**
     * success.jsp页面执行后，该方法会执行
     */
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("MyInterceptor1执行了---最后");
    }
}

（2）在springmvc.xml中配置拦截器类

<!--配置拦截器-->
    <mvc:interceptors>
        <!--配置拦截器-->
        <mvc:interceptor>
            <!--要拦截的具体的方法-->
            <mvc:mapping path="/user/*"/>
            <!--不要拦截的方法
            <mvc:exclude-mapping path=""/>
            -->
            <!--配置拦截器对象-->
            <bean class="springmvc.controller.interceptor.MyInterceptor1" />
        </mvc:interceptor>
        <!--配置第二个拦截器
        <mvc:interceptor>
            <mvc:mapping path="/**"/>
            <bean class="springmvc.controller.interceptor.MyInterceptor2" />
        </mvc:interceptor>
        -->
   </mvc:interceptors>

三、HandlerInterceptor接口中的方法

1. preHandle方法是controller方法执行前拦截的方法

	- 可以使用request或者response跳转到指定的页面
	- return true放行，执行下一个拦截器，如果没有拦截器，执行controller中的方法。
	- return false不放行，不会执行controller中的方法。

2. postHandle是controller方法执行后执行的方法，在JSP视图执行前。

	- 可以使用request或者response跳转到指定的页面
	- 如果指定了跳转的页面，那么controller方法跳转的页面将不会显示。

3. postHandle方法是在JSP执行后执行：request或者response不能再跳转页面了

四、拦截器的细节

（1）拦截器的放行
放行的含义是指，如果有下一个拦截器就执行下一个，如果该拦截器处于拦截器链的最后一个，则执行控制器中的方法。

（2）多个拦截器的执行顺序：多个拦截器是按照配置的顺序决定的

五、拦截器的简单案例（验证用户是否登录）

（1）需求

• 有一个登录页面，需要写一个 controller 访问页面
• 登录页面有一提交表单的动作。需要在 controller 中处理。

	- 判断用户名密码是否正确
	- 如果正确 向 session 中写入用户信息
	- 返回登录成功。

• 拦截用户请求，判断用户是否登录

- 如果用户已经登录。放行
- 如果用户未登录，跳转到登录页面

（2）控制器代码

//登陆页面
@RequestMapping("/login")
public String login(Model model)throws Exception{
	return "login";
}
//登陆提交
//userid：用户账号， pwd：密码
@RequestMapping("/loginsubmit")
public String loginsubmit(HttpSession session,String userid,String pwd)throws
Exception{
	//向 session 记录用户身份信息
	session.setAttribute("activeUser", userid);
	return "redirect:/main.jsp";
}
//退出
@RequestMapping("/logout")
public String logout(HttpSession session)throws Exception{
	//session 过期
	session.invalidate();
	return "redirect:index.jsp";
}

（3）拦截器代码

public class LoginInterceptor implements HandlerInterceptor{
@Override
Public boolean preHandle(HttpServletRequest request,HttpServletResponse response, Object handler) throws Exception {
	//如果是登录页面则放行
	if(request.getRequestURI().indexOf("login.action")>=0){
	return true;
		}
	HttpSession session = request.getSession();
	//如果用户已登录也放行
	if(session.getAttribute("user")!=null){
	return true;
		}
	//用户没有登录挑战到登录页面
	request.getRequestDispatcher("/WEB-INF/jsp/login.jsp").forward(request,response);
	return false;
	}
}