SpringBoot2.X自定义拦截器实战及新旧配置对比(核心知识)

简介: 讲解拦截器使用，Spingboot2.x新版本配置拦截拦截器和旧版本SpringBoot配置拦截器区别讲解

1、@Configuration
　　继承WebMvcConfigurationAdapter(SpringBoot2.X之前旧版本)

　　SpringBoot2.X 新版本配置拦截器 implements WebMvcConfigurer

2、自定义拦截器 HandlerInterceptor
　　preHandle：调用Controller某个方法之前
　　postHandle：Controller之后调用，视图渲染之前，如果控制器Controller出现了异常，则不会执行此方法
　　afterCompletion：不管有没有异常，这个afterCompletion都会被调用，用于资源清理

3、按照注册顺序进行拦截，先注册，先被拦截

　　拦截器不生效常见问题：
　　　　1）是否有加@Configuration
　　　　2）拦截路径是否有问题 ** 和 *
　　　　3）拦截器最后路径一定要 “/**”， 如果是目录的话则是 /*/

　　Filter
　　　　是基于函数回调 doFilter()，而Interceptor则是基于AOP思想
　　　　Filter在只在Servlet前后起作用，而Interceptor够深入到方法前后、异常抛出前后等

　　　　依赖于Servlet容器即web应用中，而Interceptor不依赖于Servlet容器所以可以运行在多种环境。

　　　　在接口调用的生命周期里，Interceptor可以被多次调用，而Filter只能在容器初始化时调用一次。

　　　　Filter和Interceptor的执行顺序

　　　　过滤前->拦截前->action执行->拦截后->过滤后

代码示例：

　　CustomWebMvcConfigurer.java

 package net.xdclass.demo.intecpter;

 import org.springframework.context.annotation.Configuration;
 import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

 @Configuration
 public class CustomWebMvcConfigurer implements WebMvcConfigurer  {

     @Override
     public void addInterceptors(InterceptorRegistry registry) {

         //'/*'匹配一个文件夹
         registry.addInterceptor(new LoginIntercepter()).addPathPatterns("/api2/*/**");
         registry.addInterceptor(new TwoIntercepter()).addPathPatterns("/api2/*/**");

         //.excludePathPatterns("/api2/xxx/**"); //拦截全部 /*/*/**

         WebMvcConfigurer.super.addInterceptors(registry);
     }

 }

LoginIntercepter.java：

 package net.xdclass.demo.intecpter;

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

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

 public class LoginIntercepter implements HandlerInterceptor{

     /**
      * 进入controller方法之前
      */
     @Override
     public boolean preHandle(HttpServletRequest request,
             HttpServletResponse response, Object handler) throws Exception {
         System.out.println("LoginIntercepter------->preHandle");

 //        String token = request.getParameter("access_token");

 //        response.getWriter().print("fail");

         return HandlerInterceptor.super.preHandle(request, response, handler);
     }

     /**
      * 调用完controller之后，视图渲染之前
      */
     @Override
     public void postHandle(HttpServletRequest request,
             HttpServletResponse response, Object handler,
             ModelAndView modelAndView) throws Exception {

         System.out.println("LoginIntercepter------->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("LoginIntercepter------->afterCompletion");

         HandlerInterceptor.super.afterCompletion(request, response, handler, ex);
     }

 }

TwoIntercepter.java：

 package net.xdclass.demo.intecpter;

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

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

 public class TwoIntercepter implements HandlerInterceptor{

     /**
      * 进入对应的controller方法之前
      */
     @Override
     public boolean preHandle(HttpServletRequest request,
             HttpServletResponse response, Object handler) throws Exception {

         System.out.println("TwoIntercepter------>preHandle");
         return HandlerInterceptor.super.preHandle(request, response, handler);
     }

     /**
      * controller处理之后，返回对应的视图之前
      */
     @Override
     public void postHandle(HttpServletRequest request,
             HttpServletResponse response, Object handler,
             ModelAndView modelAndView) throws Exception {
         System.out.println("TwoIntercepter------>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("TwoIntercepter------>afterCompletion");
         HandlerInterceptor.super.afterCompletion(request, response, handler, ex);
     }

 }

测试代码：

浏览器访问：http://localhost:8083/api2/v1/account

控制台查看：