SpringBoot过滤器与 * 使用方法深入分析

什么是过滤器

过滤器 Filter 基于 Servlet 实现，过滤器的主要应用场景是对字符编码、跨域等问题进行过滤。Servlet 的工作原理是拦截配置好的客户端请求，然后对 Request 和 Response 进行处理。Filter 过滤器随着 web 应用的启动而启动，只初始化一次。

Filter 使用时需要继承 Filter 接口，实现对应的 init、doFilter 以及 destroy 方法即可。

import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import org.springframework.stereotype.Component;
@Component
public class MyFilter implements Filter {
   @Override
   public void init(FilterConfig filterConfig) throws ServletException {
       System.out.println("初始化 * ");
   }
   @Override
   public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
       //做一些处理
       System.out.println("doSomeThing");
       chain.doFilter(request,response);
   }
   @Override
   public void destroy() {
       System.out.println("销毁 * ");
   }
}

1、init：在容器启动时调用初始化方法，只会初始化一次

2、doFilter：每次请求都会调用 doFilter 方法，通过 FilterChain 调用后续的方法。

3、destroy：当容器销毁时，执行 destory 方法，只会被调用一次。

什么是 *

* 是 SpringMVC 中实现的一种基于 Java 反射（ * ）机制的方法增强工具， * 的实现是继承 HandlerInterceptor 接口，并实现接口的 preHandle、postHandle 和 afterCompletion 方法。

1、preHandle：请求方法前置拦截，该方法会在 Controller 处理之前进行调用，Spring 中可以有多个 Interceptor，这些 * 会按照设定的 Order 顺序调用，当有一个 * 在 preHandle 中返回 false 的时候，请求就会终止。

2、postHandle：preHandle 返回结果为 true 时，在 Controller 方法执行之后，视图渲染之前被调用

3、afterCompletion：在 preHandle 返回 ture，并且整个请求结束之后，执行该方法。

具体的代码实现如下，首先编写一个 * ：

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
@Component
public class UserInterceptor implements HandlerInterceptor {
   @Override
   public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
       System.out.println("preHandle");
       String userName=request.getParameter("username");
       String password = request.getParameter("password");
       if (userName==null||password==null){
           response.setStatus(500);
           response.setContentType("text/html; charset=UTF-8");
           response.getWriter().print("参数缺失");
           return false;
       }
       //进行用户校验
       if (userName.equals("admin")&&password.equals("admin")){
           return true;
       }else {
           response.setStatus(500);
           response.setContentType("text/html; charset=UTF-8");
           response.getWriter().print("用户名或密码错误");
           return false;
       }
   }
   @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");
   }
}

编写完 * 之后，通过一个配置类设置 * ，并且可以通过 addPathPatterns 和 excludePathPatterns 执行哪些请求需要被拦截，哪些不需要被拦截。

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.WebMvcConfigurer;
@Configuration
public class MvcConfig implements WebMvcConfigurer {
   @Autowired
   private UserInterceptor userInterceptor;
   @Override
   public void addInterceptors(InterceptorRegistry registry) {
       registry.addInterceptor(userInterceptor)
               .addPathPatterns("/**")
               .excludePathPatterns("/error");
   }
}

再次访问 /test 页面，如果不带任何参数，就会在页面上提示 参数缺失。只有当带上参数 /test?username=admin&password=admin 才能够访问。

* 与过滤器的区别

相同点：

1、 * 与过滤器都是体现了 AOP 的思想，对方法实现增强，都可以拦截请求方法。

2、 * 和过滤器都可以通过 Order 注解设定执行顺序

不同点：

1、 过滤器属于 Servlet 级别， * 属于 Spring 级别。

Filter 是在 javax.servlet 包中定义的，要依赖于网络容器，因此只能在 web 项目中使用。

Interceptor 是 SpringMVC 中实现的，归根揭底 * 是一个 Spring 组件，由 Spring 容器进行管理。

2、过滤器和 * 的执行顺序不同：

下面通过一张图展示 Filter 和 Interceprtor 的执行顺序：

首先当一个请求进入 Servlet 之前，过滤器的 doFilter 方法进行过滤，进入 Servlet 容器之后，执行 Controller 方法之前， * 的 preHandle 方法进行拦截，执行 Controller 方法之后，视图渲染之前， * 的 postHandle 方法进行拦截，请求结束之后，执行 * 的 postHandle 方法。

3、 过滤器基于函数回调方式实现， * 基于 Java 反射（ * ）机制实现。

来源：https://blog.csdn.net/weixin_64061088/article/details/128432250