2024.10月11日--- SpringMVC拦截器

拦截器

1 回顾过滤器：

Servlet规范中的三大接口：==Servlet接口，Filter接口、Listener接口。==

过滤器接口，是Servlet2.3版本以来，定义的一种小型的，可插拔的Web组件，可以用来拦截和处理Servlet容器的请求和响应过程。以便查看，提取或以某种方式操作正在客户端与服务器端之间交换的数据。

过滤器的配置比较简单，直接实现Filter 接口即可，也可以通过@WebFilter注解实现对特定URL拦截。Filter 接口中定义了三个方法。

init() ：该方法在容器启动初始化过滤器时被调用，它在 Filter 的整个生命周期只会被调用一次。「注意」：这个方法必须执行成功，否则过滤器会不起作用。
doFilter() ：容器中的每一次请求都会调用该方法， FilterChain 用来调用下一个过滤器 Filter。
destroy()：当容器销毁过滤器实例时调用该方法，一般在方法中销毁或关闭资源，在过滤器 Filter 的整个生命周期也只会被调用一次。

2 拦截器的简介

SpringMVC里的拦截器是面向切面编程AOP的一个具体实现，用于对请求做预处理。

1）什么是拦截器：

在AOP（Aspect-Oriented Programming）中用于在某个方法或字段被访问之前，进行拦截然后在之前或之后加入某些操作。拦截是AOP的一种实现策略

2）为什么需要拦截器：

在做身份认证或者是进行日志的记录时，我们需要通过拦截器达到我们的目的。最常用的登录拦截、或是权限校验、或是防重复提交、或是根据业务像12306去校验购票时间,总之可以去做很多的事情

3 拦截器的应用

步骤1)：自定义一个类，实现HandlerInterceptor接口，或者继承HandlerInterceptorAdapter抽象类

步骤2)：根据自己的需求，重写方法

方法1：boolean preHandle()- 想要在执行Controller之前执行拦截，就重写该方法。- 存在多个interceptor时，它们基于链式方式调用，按照注册的先后顺序依次执行。- 方法返回true时，后续有拦截器，就继续执行拦截器，没有就执行controller.- 方法返回false时，后续任何内容都不执行了，直接返回浏览器


方法2：void postHandle()：会在Controller执行后，视图渲染之前调用该方法。因此可以在这个阶段，对将要返回给客户端的ModelAndView进行处理。

方法3：void afterCompletion：- 该方法会在视图渲染后被调用，主要是用来进行资源清理工作。- 多个拦截器时，依旧是先执行先注册的拦截器的afterCompletion方法- 不管处理器是否抛出异常，该方法都将执行。

步骤3）在spring的配置文件中配置拦截器(或者配置类中也可以)

4 拦截器执行流程

4.1 拦截器的执行时机

4.2 拦截器和过滤器一起应用时的执行时机

5 拦截器的应用场景

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

权限检查：如登录校验，在处理器处理之前先判断是否已经登录；

性能监控：通过拦截器在进入处理器之前记录开始时间，在处理完后记录结束时间，从而得到该请求的处理时间。

通用行为：读取 Cookie 得到用户信息并将用户对象放入请求，从而方便后续流程使用。还有如提取 Locale、Theme 信息等，只要是多个处理器都需要的都可以用拦截器来实现。

6 当前路径绑定权限拦截器

package com.ssm.netctoss.interceptor;

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

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

/**
* 步骤1)：自定义一个类，实现HandlerInterceptor接口，或者继承HandlerInterceptorAdapter抽象类
* 步骤2)：根据自己的需求，重写方法
* 步骤3）在spring的配置文件中配置拦截器(或者配置类中也可以)
*/
public class CurrentPathPrivilegeInterceptor implements HandlerInterceptor {
/**
*
* @param request 请求对象
* @param response 响应对象
* @param handler 请求路径对应的Controller里的方法对象(反射机制)
* /fee/findByPage
* public String findByPage(){
* ........
* }
* @return
* @throws Exception
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("----------preHandle------------");
System.out.println("-------注意：需要给每个用户添加0,8,9权限，在数据库中-----------");
System.out.println("-------注意：需要给每个用户添加0,8,9权限，在数据库中-----------");
System.out.println("-------注意：需要给每个用户添加0,8,9权限，在数据库中-----------");
//获取请求路径：
String uri = request.getRequestURI();
int currentPrivilege = -1;
if(uri.contains("/toIndex")){
currentPrivilege = 0;
}else if(uri.contains("/role/")){
currentPrivilege = 1;
}else if(uri.contains("/admin/")){
currentPrivilege = 2;
}else if(uri.contains("/fee/")) {
currentPrivilege = 3;
}else if(uri.contains("/account/")) {
currentPrivilege = 4;
}else if(uri.contains("/service/")) {
currentPrivilege = 5;
}else if(uri.contains("/bill/")) {
currentPrivilege = 6;
}else if(uri.contains("/report/")) {
currentPrivilege = 7;
}else if(uri.contains("/user/show")) {
currentPrivilege = 8;
}else if(uri.contains("/user/toUpdate")) {
currentPrivilege = 9;
}
request.getSession().setAttribute("currentPrivilege", currentPrivilege);

return true;
}

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

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

编写导航高亮提示

<%@taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>

<%@taglib prefix="fmt" uri="http://java.sun.com/jsp/jstl/fmt" %>

<div id="navi">

   <ul id="menu">

      <li><a href="../index/toIndex" class="<c:choose><c:when test="${currentPrivilege==0}">index_on</c:when><c:otherwise>index_off</c:otherwise></c:choose>"></a></li>

      <li><a href="../role/findByPage" class="<c:choose><c:when test="${currentPrivilege==1}">role_on</c:when><c:otherwise>role_off</c:otherwise></c:choose>"></a></li>

      <li><a href="../admin/findByPage" class="<c:choose><c:when test="${currentPrivilege==2}">admin_on</c:when><c:otherwise>admin_off</c:otherwise></c:choose>"></a></li>

      <li><a href="../fee/findByPage" class="<c:choose><c:when test="${currentPrivilege==3}">fee_on</c:when><c:otherwise>fee_off</c:otherwise></c:choose>"></a></li>

      <li><a href="../account/findByPage" class="<c:choose><c:when test="${currentPrivilege==4}">account_on</c:when><c:otherwise>account_off</c:otherwise></c:choose>"></a></li>

      <li><a href="../service/searchService" class="<c:choose><c:when test="${currentPrivilege==5}">service_on</c:when><c:otherwise>service_off</c:otherwise></c:choose>"></a></li>

      <li><a href="../bill/bill_list.html" class="bill_off"></a></li>

      <li><a href="../report/report_list.html" class="report_off"></a></li>

      <li><a href="../user/showUserInfo" class="<c:choose><c:when test="${currentPrivilege==8}">information_on</c:when><c:otherwise>information_off</c:otherwise></c:choose>"></a></li>

      <li><a href="../user/toUpdatePwd" class="<c:choose><c:when test="${currentPrivilege==9}">password_on</c:when><c:otherwise>password_off</c:otherwise></c:choose>"></a></li>

   </ul>

</div>

7 登录拦截

package com.ssm.netctoss.interceptor;

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

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

/**
* 使用拦截器，来完成用户是否登录过。如果没有登录，应该跳转到登录页面，强制其登录
*
* 返回值：
* false: 不执行后续的代码，包括Controller
* true: 执行后续的代码，如果有下一个拦截器，就执行下一个拦截器的preHandle。如果没有拦截器，执行Controller
*/
public class LoginInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("----------LoginInterceptor的preHandle-----------");
//获取session，从中获取绑定的信息
Object loginAdmin = request.getSession().getAttribute("LOGINADMIN");
if (loginAdmin == null) {
//没有登录过，就跳转
response.sendRedirect(request.getContextPath()+"/login/toLogin");
return false;
}
return true;
}

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

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

8 权限验证拦截器

package com.ssm.netctoss.interceptor;

import com.ssm.netctoss.pojo.Admin;
import com.ssm.netctoss.pojo.Privilege;
import com.ssm.netctoss.pojo.Role;
import com.ssm.netctoss.service.AdminService;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;

import javax.annotation.Resource;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.util.HashSet;
import java.util.List;
import java.util.Set;

/**
* 登录用户的权限校验拦截：
* 比如：登录用户，只能访问管理员，资费，账务，没有其他权限，那么相应的导航栏，有的能访问，有的不能访问
*
*
* admin_info ----> admin_role---->role_info--->role_privilege-->privilege_info
* caocao 管理员1 100 1 2 3
* 营业员 200 3 4 5 6
* 经理 300 7
*/
public class PrivilegeInterceptor extends HandlerInterceptorAdapter {
/**
* 因为拦截器是运行在Spring容器中维护的。（Bean），因此可以使用DI注入其他业务层/控制层的各种类型属性
*/
// @Resource
// private AdminService adminService;
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
//获取当前登录用户的所有权限
Admin admin = (Admin) request.getSession().getAttribute("LOGINADMIN");
//创建一个Set集合，用于存储该用户的所有权限(privilegeId,name)
Set<Privilege> privileges = new HashSet<Privilege>(); // Privileges实体类要重新hashCode和equals方法
List<Role> roles = admin.getRoles();
for (Role role : roles) {
//添加进集合，并去重
privileges.addAll(role.getPrivileges());
}
/*从当前的请求路径上获取对应的绑定权限*/
int currentPrivilege = (Integer)(request.getSession().getAttribute("currentPrivilege"));
/*查看当前路径的绑定权限是否在当前用户的权限集合里，如果没有，就跳转进行提示*/
for (Privilege privilege : privileges) {
if(privilege.getPrivilegeId()==currentPrivilege){
return true;
}
}
//如果在循序期间，没有遇到return true，说明要访问的路径用户是没有该权限的。因此要做一个跳转
response.sendRedirect(request.getContextPath()+"/login/nopower");
return false;
}
}

注册拦截器

<mvc:interceptors>

<mvc:interceptor>
<mvc:mapping path="/**"/>
<mvc:exclude-mapping path="/login/login"/>
<mvc:exclude-mapping path="/login/getCheckCode"/>
<mvc:exclude-mapping path="/login/toLogin"/>
<bean class="com.ssm.netctoss.interceptor.LoginInterceptor"></bean>
</mvc:interceptor>

<mvc:interceptor>

<mvc:mapping path="/**"/>



<mvc:exclude-mapping path="/login/toLogin"/>
<mvc:exclude-mapping path="/login/login"/>
<mvc:exclude-mapping path="/login/logout"/>

<bean class="com.ssm.netctoss.interceptor.CurrentPathPrivilegeInterceptor"></bean>
</mvc:interceptor>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<mvc:exclude-mapping path="/login/*"/>
<bean class="com.ssm.netctoss.interceptor.PrivilegeInterceptor"></bean>
</mvc:interceptor>
</mvc:interceptors>

9 拦截器与过滤器的比较

**①** 拦截器是基于java的反射机制的，而过滤器是基于函数回调。
　　

**②** 拦截器不依赖与servlet容器，过滤器依赖与servlet容器。
　　

**③** 拦截器只能对action请求起作用，而过滤器则可以对几乎所有的请求起作用。
　　

**④** 拦截器可以访问action上下文、值栈里的对象，而过滤器不能访问。
　　

**⑤** 在action的生命周期中，拦截器可以多次被调用，而过滤器只能在容器初始化时被调用一次。

**⑥** 拦截器可以获取IOC容器中的各个bean，而过滤器就不行，这点很重要，在拦截器里注入一个service，可以调用业务逻辑。

**⑦ **过滤器和拦截器触发时机、时间、地方不一样

**⑧**过滤器包裹住servlet，servlet包裹住拦截器。