SpringBoot 过滤器和拦截器

过滤器实现过滤器需要实现 javax.servlet.Filter 接口 。重写三个方法 。其中 init() 方法在服务启动时执行,destroy() 在服务停止之前执行 。
可用两种方式注册过滤器:

  • 使用 FilterRegistrationBean 来注入 。可使用 setOrder(0) 设置过滤器的优先级,越小优先级越高 。
  • 使用 @WebFilter(filterName = "myFilter2" ,urlPatterns = "/*") 配合 @ServletComponentScan() 实现注入 。(@Order 注解无效)
编写过滤器package com.example.recorddemo.filters;import javax.servlet.*;import javax.servlet.http.HttpServletRequest;import java.io.IOException;public class MyFilter1 implements Filter {@Overridepublic void init(FilterConfig filterConfig) throws ServletException {System.out.println("初始化过滤器:" + filterConfig.getFilterName());}@Overridepublic void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {System.out.println("在请求之前做处理");if (servletRequest instanceof HttpServletRequest) {System.out.println("URL:" + ((HttpServletRequest)servletRequest).getRequestURL());}// 调用filter链中的下一个filterfilterChain.doFilter(servletRequest, servletResponse);System.out.println("在请求之后做处理");}@Overridepublic void destroy() {System.out.println("销毁:MyFilter1");}}注册过滤器基于 FilterRegistrationBean在配置类中注册一个 FilterRegistrationBean 类型的Bean 。
  • 如果没有设置 UrlPatterns  ,  那么会自动关联到 /* 上 。
  • 如果没有设置过滤器的名字,那么会自动推理出一个过滤器名称(bean的名字)
    【SpringBoot 过滤器和拦截器】When no URL pattern or servlets are specified the filter will be associated to '/*'. The filter name will be deduced if not specified.
  • fileter默认是enable的,将其设置为false表示关闭当前过滤器 。
  • 可通过 setOrder(0) 方法设置过滤器的优先级,如果优先级相同 , 则先定义的优先级更高 。
@Configurationpublic class FilterConfiguration {@Beanpublic FilterRegistrationBean myFilter1(){MyFilter1 filter = new MyFilter1();FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean(filter);//filterRegistrationBean.addUrlPatterns("/*");//filterRegistrationBean.setEnabled(true);return filterRegistrationBean;}}基于 @WebFilter
  • 使用 @WebFilter 修饰filter 。
  • 在任意configuration类中添加 @ServletComponentScan("com.example.recorddemo.filters") , 包名可以不填 。
import javax.servlet.*;import javax.servlet.annotation.WebFilter;import javax.servlet.http.HttpServletRequest;import java.io.IOException;@WebFilter(filterName = "myFilter2" ,urlPatterns = "/*")public class MyFilter2 implements Filter {@Overridepublic void init(FilterConfig filterConfig) throws ServletException {}@Overridepublic void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {// 调用filter链中的下一个filterfilterChain.doFilter(servletRequest, servletResponse);}@Overridepublic void destroy() {}}拦截器拦截器会在处理指定请求之前和之后进行相关操作,配置拦截器需要两步
    1. 编写拦截器类(实现 HandlerInterceptor 接口)
    1. 添加已实现的拦截器(实现 WebMvcConfigurer 接口,并重写 addInterceptors() 方法)
    1. 添加addPathPatterns()规定拦截哪些请求 。(/*表示只拦截/下的所有目录,但是不包括子目录, /**表示拦截/下的所有目录,及其子目录)
拦截器类:
package com.example.recorddemo.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 wangchao */@Componentpublic class MyInterceptor implements HandlerInterceptor {@Overridepublic boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {// handle可拿到执行方法的反射对象 。System.out.println("preHandle: MyInterceptor");return true;}@Overridepublic void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {// 对于RESTful 接口用处不大}@Overridepublic void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {// 可捕捉异常,但是springboot已经有了全局异常捕捉}}

推荐阅读