（三）一步步来开始SSM：拦截器实现

上一篇文章[（二）一步步来开始SSM：数据连通测试]

1、拦截器类

在项目中新建一个文件夹filter，创建一个编码拦截器EncodingFilter实现HandlerInterceptor接口，所有的拦截器类都需要通过实现这个接口来对请求进行拦截。

HandlerInterceptor接口中需要实现三个方法：

1、preHandle  该方法将在请求处理之前进行调用，只有该方法返回true，才会继续执行后续的Interceptor和Controller，当返回值为true 时就会继续调用下一个Interceptor的preHandle 方法，如果已经是最后一个Interceptor的时候就会是调用当前请求的Controller方法；

2、postHandle  该方法也是需要当前对应的Interceptor的preHandle方法的返回值为true时才会执行，该方法将在整个请求结束之后，也就是在DispatcherServlet 渲染了对应的视图之后执行。用于进行资源清理。

3、afterCompletion  该方法将在请求处理之后，DispatcherServlet进行视图返回渲染之前进行调用，可以在这个方法中对Controller 处理之后的ModelAndView 对象进行操作。

执行顺序为：preHandler -> Controller -> postHandler -> model渲染-> afterCompletion

package com.libraryManage.filter;

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

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

public class EncodingFilter implements HandlerInterceptor {
    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response, Object handler) throws Exception {
        request.setCharacterEncoding("utf-8");
        response.setCharacterEncoding("utf-8");
        return true;
    }
    public void postHandle(HttpServletRequest request,
                           HttpServletResponse response, Object handler,
                           ModelAndView modelAndView) throws Exception {

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

在该拦截其中，preHandle方法对编码格式进行设置，保证后续的数据传递没有乱码问题。

2、配置文件加入拦截器

spring-mvc.xml文件

<!-- 自定义的拦截器 --> 
<mvc:interceptors>
        <!-- 编码拦截器 -->
        <mvc:interceptor>
            <mvc:mapping path="/**"/>
            <bean class="com.libraryManage.filter.EncodingFilter" />
        </mvc:interceptor>
 </mvc:interceptors>

<mvc:mapping>标签是需要拦截的路径

<bean>标签是拦截器类的路径

每个拦截器都必须有以上两个标签，且标签的顺序不能乱

还有一个<mvc:exclude-mapping>标签，用来过滤不需要拦截的一些请求。我在使用这个标签时遇到idea标红报错的提示，将上面的路径进行修改就可以了，如下图所示：将原来的spring-mvc-3.0.xsd改为spring-mvc-3.2.xsd。

3、拦截器的常见应用场景

1、权限检查：如检测请求是否具有登录权限，如果没有直接返回到登陆页面。

2、性能监控：用请求处理前和请求处理后的时间差计算整个请求响应完成所消耗的时间。 

3、日志记录：可以记录请求信息的日志，以便进行信息监控、信息统计等。

4、用拦截器实现登录权限校验

管理员登录拦截AdminLoginFilter类，如果缓存中没有拿到管理员的登录信息，对该请求进行拦截并且页面重定向到登录页。

package com.libraryManage.filter;

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

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

public class AdminLoginFilter implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse,
                             Object o) throws Exception {
        HttpSession session = httpServletRequest.getSession();

        Object admin = session.getAttribute("admin");

        if (admin == null) {
            // 获取项目根路径
            ServletContext context = httpServletRequest.getServletContext();
            String basePath = String.valueOf(context.getAttribute("project_access_path"));
            httpServletResponse.sendRedirect(basePath + "/index.jsp");
        }

        return true;
    }

    @Override
    public void postHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse,
                           Object o, ModelAndView modelAndView) throws Exception {

    }

    @Override
    public void afterCompletion(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse,
                                Object o, Exception e) throws Exception {

    }
}

配置文件spring-mvc.xml，只有访问登录页面和登录接口时不进行拦截

    <!-- 自定义的拦截器 -->
    <mvc:interceptors>
        <!-- 编码拦截器 -->
        <mvc:interceptor>
            <mvc:mapping path="/**"/>
            <bean class="com.libraryManage.filter.EncodingFilter" />
        </mvc:interceptor>

        <!-- 管理员登录拦截 -->
        <mvc:interceptor>
            <mvc:mapping path="/**/*.do" />
            <mvc:exclude-mapping path="/index.jsp" />
            <mvc:exclude-mapping path="/admin/login.do" />
            <bean class="com.libraryManage.filter.AdminLoginFilter"></bean>
        </mvc:interceptor>
    </mvc:interceptors>

5、扩展：在配置文件中自定义参数

在上面的拦截器跳转重定向时，选择的路径为项目的根路径再加上登录页面，我们在配置文件中对项目的根路径进行配置，这样直接在代码中获取到配置的路径，增加代码的灵活性。

spring-mvc.xml文件中加入了以下代码：

<!-- 自定义参数 -->
    <bean class="org.springframework.web.context.support.ServletContextAttributeExporter">
        <property name="attributes">
            <map>
                <!-- 项目访问路径 -->
                <entry key="project_access_path" value="http://localhost:8080/library"/>
            </map>
        </property>