一、拦截器概念

拦截器（Interceptor）是一种动态拦截方法调用的机制，在SpringMVC中动态拦截控制器方法的执行
作用：
- 在指定的方法调用前后执行预先设定的代码
- 阻止原始方法的执行

二、拦截器与过滤器的区别

归属不同：Filter属于Servlet技术，Interceptor属于SpringMVC技术
拦截内容不同：Filter对所有访问进行增强，Interceptor仅针对SpringMVC的访问进行增强

三、拦截器入门案例

3.1制作拦截器功能类

3.2 声明拦截器的bean

实现HandlerInterceptor接口
注意：配置好后，要在SpringMvcConfig类中扫描加载bean

package com.practice.controller.interceptor;

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

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

/**
 * @Author YJ
 * @Date 2023/8/16 18:34
 * Description:拦截器
 */
@Component
public class ProjectInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("preHandle...");
        return true;
    }

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

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

此处preHandle()方法中返回需注意：
返回为true:不会对原始方法造成影响，继续执行postHandle()和afterCompletion()方法。
返回为false:此时会直接拦截住原始方法的执行，将不会执行原来的方法，只执行preHandle()方法·。

3.3定义配置类

继承WebMvcConfigurationSupport，实现addInterceptors方法
注意扫描加载配置

package com.practice.config;

import com.practice.controller.interceptor.ProjectInterceptor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;

/**
 * @Author YJ
 * @Date 2023/8/16 18:39
 * Description:
 */
@Configuration
public class SpringMvcSupport extends WebMvcConfigurationSupport {
    @Override
    protected void addInterceptors(InterceptorRegistry registry) {
        ...
    }
}

3.4添加拦截器

设置拦截器的访问路径，路径可以通过可变参数设置多个

package com.practice.config;

import com.practice.controller.interceptor.ProjectInterceptor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;

/**
 * @Author YJ
 * @Date 2023/8/16 18:39
 * Description:
 */
@Configuration
@ComponentScan({"com.practice.controller"})
public class SpringMvcSupport extends WebMvcConfigurationSupport {
    @Autowired
    private ProjectInterceptor projectInterceptor;
    @Override
    protected void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(projectInterceptor).addPathPatterns("/address","/address/*");
    }
}

3.5简化开发（侵入式较强）

使用标准接口WebMvcConfigurer简化开发

package com.practice.config;

import com.practice.controller.interceptor.ProjectInterceptor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * @Author YJ
 * @Date 2023/8/15 18:59
 * Description:
 */
//3.创建Springmvc配置文件，加载controller对应的bean
@Configuration
@ComponentScan({"com.practice.controller"})
//开启由json数据转换为对象的功能
@EnableWebMvc
public class SpringMvcConfig implements WebMvcConfigurer {

    @Autowired
    private ProjectInterceptor projectInterceptor;
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(projectInterceptor).addPathPatterns("/address","/address/*");
    }
}

3.6执行流程

无拦截器
有拦截器

四、拦截器参数

4.1前置处理

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

参数

- request：请求对象
- response：响应对象
- handler：被调用的处理器对象，本质上是一个方法对象，对反射技术中的Method对象进行了再包装
返回值
- 返回值为false,被拦截的处理器将不执行

4.2后置处理

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

参数
- modelAndView：如果处理器执行完成具有返回结果，可以读取到对应数据与页面信息，并进行调整

4.3完成后处理

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

参数
- ex:如果处理器执行过程中出现异常对象，可以针对异常情况进行单独处理

五、拦截器链配置

当配置多个拦截器时，形成拦截器链
拦截器的运行顺序参照拦截器添加顺序为准
当拦截器中出现对原始处理器的拦截，后面的拦截器均终止运行
当拦截器运行中断，仅运行配置在前面的拦截器的afterCompletion操作

假定有三个拦截器：1、2、3
- 1、2、3拦截器的preHandle返回均为true时，顺序是：pre1–>pre2–>pre3–>controller–>post3–>post2–>post1–>after3–>after2–>after1
- 1、2拦截器的preHandle返回为true,3拦截器的preHandle返回为false时，顺序是：pre1–>pre2–>pre3–>after2–>after1
1拦截器的preHandle返回为true，2、3拦截器的preHandle返回为false时，顺序是：pre1–>pre2–>after1
- 三个拦截器的preHandle返回为false时顺序是：pre1–>结束