掌握Spring MVC拦截器整合技巧，实现灵活的请求处理与权限控制！

╰半橙微兮° 2024-04-17 06:46 14阅读 0赞

#### 拦截器 ####

*   *  1.1 拦截器概念
     *  1.2 拦截器入门案例
     *   *  1.2.1 环境准备
         *  1.2.2 拦截器开发
         *   *  步骤1:创建拦截器类
             *  步骤2:配置拦截器类
             *  步骤3:SpringMVC添加SpringMvcSupport包扫描
             *  步骤4:运行程序测试
             *  步骤5:修改拦截器拦截规则
             *  步骤6:简化SpringMvcSupport的编写
     *  1.3 拦截器参数
     *   *  1.3.1 前置处理方法
         *  1.3.2 后置处理方法
         *  1.3.3 完成处理方法
     *  1.4 拦截器链配置
     *   *  1.4.1 配置多个拦截器
         *   *  步骤1:创建拦截器类
             *  步骤2:配置拦截器类

### 1.1 拦截器概念 ###

![在这里插入图片描述][c4470afd0bea493d844c61ece65ca2b2.png]

(1)浏览器发送一个请求会先到Tomcat的web服务器。

(2)Tomcat服务器接收到请求以后，会去判断请求的是静态资源还是动态资源。

(3)如果是静态资源，会直接到Tomcat的项目部署目录下去直接访问。

(4)如果是动态资源，就需要交给项目的后台代码进行处理。

(5)在找到具体的方法之前，我们可以去配置过滤器(可以配置多个)，按照顺序进行执行。

(6)然后进入到到中央处理器，SpringMVC会根据配置的规则进行拦截。

(7)如果满足规则，则进行处理，找到其对应的controller类中的方法进行执行,完成后返回结果。

(8)如果不满足规则，则不进行处理。

(9)这个时候，如果我们需要在每个Controller方法执行的前后添加业务，具体该如何来实现?

这个就是拦截器要做的事。

*  拦截器（Interceptor）是一种动态拦截方法调用的机制，在SpringMVC中动态拦截控制器方法的执行
 *  作用:
    
     *  在指定的方法调用前后执行预先设定的代码。
     *  阻止原始方法的执行。
     *  总结：拦截器就是用来做增强。

看完以后，大家会发现

*  拦截器和过滤器在作用和执行顺序上也很相似。

所以这个时候，就有一个问题需要思考:拦截器和过滤器之间的区别是什么?

*  归属不同：Filter属于Servlet技术，Interceptor属于SpringMVC技术。
 *  拦截内容不同：Filter对所有访问进行增强，Interceptor仅针对SpringMVC的访问进行增强。  
    ![在这里插入图片描述][289dbd12757344cf95b617c558effc1e.png]

### 1.2 拦截器入门案例 ###

#### 1.2.1 环境准备 ####

*  创建一个Web的Maven项目
 *  pom.xml添加SSM整合所需jar包
 *  创建对应的配置类
 *  创建模型类Book
 *  编写Controller
    
        @RestController
        @RequestMapping("/books")
        public class BookController {
              
        
            @PostMapping
            public String save(@RequestBody Book book){
              
                System.out.println("book save..." + book);
                return "{'module':'book save'}";
            }
        
            @DeleteMapping("/{id}")
            public String delete(@PathVariable Integer id){
              
                System.out.println("book delete..." + id);
                return "{'module':'book delete'}";
            }
        
            @PutMapping
            public String update(@RequestBody Book book){
              
                System.out.println("book update..."+book);
                return "{'module':'book update'}";
            }
        
            @GetMapping("/{id}")
            public String getById(@PathVariable Integer id){
              
                System.out.println("book getById..."+id);
                return "{'module':'book getById'}";
            }
        
            @GetMapping
            public String getAll(){
              
                System.out.println("book getAll...");
                return "{'module':'book getAll'}";
            }
        }

#### 1.2.2 拦截器开发 ####

##### 步骤1:创建拦截器类 #####

让类实现HandlerInterceptor接口，重写接口中的三个方法。

@Component
    //定义拦截器类，实现HandlerInterceptor接口
    //注意当前类必须受Spring容器控制
    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...");
        }
    }

**注意**:拦截器类要被SpringMVC容器扫描到。

##### 步骤2:配置拦截器类 #####

@Configuration
    public class SpringMvcSupport extends WebMvcConfigurationSupport {
        
        @Autowired
        private ProjectInterceptor projectInterceptor;
    
        @Override
        protected void addResourceHandlers(ResourceHandlerRegistry registry) {
        
            registry.addResourceHandler("/pages/**").addResourceLocations("/pages/");
        }
    
        @Override
        protected void addInterceptors(InterceptorRegistry registry) {
        
            //配置拦截器
            registry.addInterceptor(projectInterceptor).addPathPatterns("/books" );
        }
    }

##### 步骤3:SpringMVC添加SpringMvcSupport包扫描 #####

@Configuration
    @ComponentScan({
        "com.itheima.controller","com.itheima.config"})
    @EnableWebMvc
    public class SpringMvcConfig{
        
       
    }

##### 步骤4:运行程序测试 #####

使用PostMan发送`http://localhost/books`  
![在这里插入图片描述][aa3212dcd8724fe9aa1ed723f50bf94d.png]

如果发送`http://localhost/books/100`会发现拦截器没有被执行，原因是拦截器的`addPathPatterns`方法配置的拦截路径是`/books`,我们现在发送的是`/books/100`，所以没有匹配上，因此没有拦截，拦截器就不会执行。

##### 步骤5:修改拦截器拦截规则 #####

这个时候，如果再次访问`http://localhost/books/100`，拦截器就会被执行。

拦截器中的`preHandler`方法，如果返回true,则代表放行，会执行原始Controller类中要请求的方法，如果返回false，则代表拦截，后面的就不会再执行了。

##### 步骤6:简化SpringMvcSupport的编写 #####

@Configuration
    @ComponentScan({
        "com.itheima.controller"})
    @EnableWebMvc
    //实现WebMvcConfigurer接口可以简化开发，但具有一定的侵入性
    public class SpringMvcConfig implements WebMvcConfigurer {
        
        @Autowired
        private ProjectInterceptor projectInterceptor;
    
        @Override
        public void addInterceptors(InterceptorRegistry registry) {
        
            //配置多拦截器
            registry.addInterceptor(projectInterceptor).addPathPatterns("/books","/books/*");
        }
    }

此后咱们就不用再写`SpringMvcSupport`类了。

最后我们来看下拦截器的执行流程:  
![在这里插入图片描述][ef0b137fcbdb42d69837e9bd324576d1.png]

当有拦截器后，请求会先进入preHandle方法，

如果方法返回true，则放行继续执行后面的handle\[controller的方法\]和后面的方法。

如果返回false，则直接跳过后面方法的执行。

### 1.3 拦截器参数 ###

#### 1.3.1 前置处理方法 ####

原始方法之前运行preHandle

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

*  request:请求对象
 *  response:响应对象
 *  handler:被调用的处理器对象，本质上是一个方法对象，对反射中的Method对象进行了再包装

使用request对象可以获取请求数据中的内容，如获取请求头的`Content-Type`

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        
        String contentType = request.getHeader("Content-Type");
        System.out.println("preHandle..."+contentType);
        return true;
    }

使用handler参数，可以获取方法的相关信息

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        
        HandlerMethod hm = (HandlerMethod)handler;
        String methodName = hm.getMethod().getName();//可以获取方法的名称
        System.out.println("preHandle..."+methodName);
        return true;
    }

#### 1.3.2 后置处理方法 ####

原始方法运行后运行，如果原始方法被拦截，则不执行

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

前三个参数和上面的是一致的。

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

因为咱们现在都是返回json数据，所以该参数的使用率不高。

#### 1.3.3 完成处理方法 ####

拦截器最后执行的方法，无论原始方法是否执行

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

前三个参数与上面的是一致的。

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

因为我们现在已经有全局异常处理器类，所以该参数的使用率也不高。

这三个方法中，最常用的是preHandle,在这个方法中可以通过返回值来决定是否要进行放行，我们可以把业务逻辑放在该方法中，如果满足业务则返回true放行，不满足则返回false拦截。

### 1.4 拦截器链配置 ###

目前，我们在项目中只添加了一个拦截器，如果有多个，该如何配置?配置多个后，执行顺序是什么?

#### 1.4.1 配置多个拦截器 ####

##### 步骤1:创建拦截器类 #####

实现接口，并重写接口中的方法

@Component
    public class ProjectInterceptor2 implements HandlerInterceptor {
        
        @Override
        public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        
            System.out.println("preHandle...222");
            return false;
        }
    
        @Override
        public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        
            System.out.println("postHandle...222");
        }
    
        @Override
        public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        
            System.out.println("afterCompletion...222");
        }
    }

##### 步骤2:配置拦截器类 #####

@Configuration
    @ComponentScan({
        "com.itheima.controller"})
    @EnableWebMvc
    //实现WebMvcConfigurer接口可以简化开发，但具有一定的侵入性
    public class SpringMvcConfig implements WebMvcConfigurer {
        
        @Autowired
        private ProjectInterceptor projectInterceptor;
        @Autowired
        private ProjectInterceptor2 projectInterceptor2;
    
        @Override
        public void addInterceptors(InterceptorRegistry registry) {
        
            //配置多拦截器
            registry.addInterceptor(projectInterceptor).addPathPatterns("/books","/books/*");
            registry.addInterceptor(projectInterceptor2).addPathPatterns("/books","/books/*");
        }
    }

步骤3:运行程序，观察顺序  
![在这里插入图片描述][046bf24b28d34b8d90e5ba393ccdb805.png]

拦截器执行的顺序是和配置顺序有关，先进后出。

*  当配置多个拦截器时，形成拦截器链。
 *  拦截器链的运行顺序参照拦截器添加顺序为准。
 *  当拦截器中出现对原始处理器的拦截，后面的拦截器均终止运行。
 *  当拦截器运行中断，仅运行配置在前面的拦截器的afterCompletion操作。  
    ![在这里插入图片描述][d8f07031987543b1a1c548b94e24593b.png]

preHandle：与配置顺序相同，必定运行

postHandle:与配置顺序相反，可能不运行

afterCompletion:与配置顺序相反，可能不运行。

这个顺序不太好记，最终只需要把握住一个原则即可:以最终的运行结果为准。

**后记  
????美好的一天，到此结束，下次继续努力！欲知后续，请看下回分解，写作不易，感谢大家的支持！！ ???**

[c4470afd0bea493d844c61ece65ca2b2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/7c3b74201aab4f1ba04fc4c05bd33f3a.png
[289dbd12757344cf95b617c558effc1e.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/f5cd79232a5f4b7996f65e20fc5c91d9.png
[aa3212dcd8724fe9aa1ed723f50bf94d.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/47e379a7a0a84dcd893086dc74414ea4.png
[ef0b137fcbdb42d69837e9bd324576d1.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/231306a69da3489eaa40bc4dd2f8b8c5.png
[046bf24b28d34b8d90e5ba393ccdb805.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/38ae2fea154c4c5cb55bc052f39abb42.png
[d8f07031987543b1a1c548b94e24593b.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/15/3c4c9061a16348afaf8187da08439c34.png