@WebFilter两种使用方法和失效解决方案

Posted OkidoGreen

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了@WebFilter两种使用方法和失效解决方案相关的知识,希望对你有一定的参考价值。

1、直接使用过滤器不会生效@WebFilter(urlPatterns="/dd/*", filterName=“loginFilter”)
需要在springboot启动类上加上@ServletComponent注解才会生效(无法设置Filter顺序)

/**  
 * @author nineee
 * @description urlPatterns:拦截的url地址 
 *              filterName:拦截器名称
 * @date 2020/8/31 16:09
 */
@Slf4j
@WebFilter(urlPatterns="/dd/*", filterName="loginFilter")
public class LoginFilter implements Filter

  /*
   * 容器加载完成调用
   * */
  @Override
  public void init(FilterConfig filterConfig) throws ServletException 
    log.info("LoginFilter.init");
  

  /*
   *  请求被拦截的时候调用
   * */
  @Override
  public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
      throws IOException, ServletException 
    log.info("LoginFilter.doFilter");
    HttpServletRequest req = (HttpServletRequest)request;
    HttpServletResponse resp = (HttpServletResponse)response;
    chain.doFilter(request, response);
  

  /*
   * 容器被销毁的时候调用
   * */
  @Override
  public void destroy() 
    System.out.println("filter destroy...");
  
@SpringBootApplication
@ServletComponentScan
public class NineeeStart 
    public static void main(String[] args) 
        SpringApplication.run(NineeeStart.class, args);
    


2、手动配置bean(推荐这种方式,可以在FilterRegistrationBean里设置Order)

不需要@WebFilter注解

/**
 * @author nineee
 * @description urlPatterns:拦截的url地址
 *              filterName:拦截器名称
 * @date 2020/8/31 16:09
 */
@Slf4j
public class LoginFilter implements Filter

  /*
   * 容器加载完成调用
   * */
  @Override
  public void init(FilterConfig filterConfig) throws ServletException 
    log.info("LoginFilter.init");
  

  /*
   *  请求被拦截的时候调用
   * */
  @Override
  public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
      throws IOException, ServletException 
    log.info("LoginFilter.doFilter");
    HttpServletRequest req = (HttpServletRequest)request;
    HttpServletResponse resp = (HttpServletResponse)response;
    chain.doFilter(request, response);
  

  /*
   * 容器被销毁的时候调用
   * */
  @Override
  public void destroy() 
    System.out.println("filter destroy...");
  
@Configuration
public class WebAuthFilterConfig 

    @Bean
    public FilterRegistrationBean webAuthFilterRegistration() 
        FilterRegistrationBean registration = new FilterRegistrationBean();
        registration.setFilter(loginFilter());
        registration.setName("LoginFilter");
        registration.addUrlPatterns("/spu/*");
//        registration.addInitParameter("excludeUrls", "/web/login");
        registration.setOrder(0);
        return registration;
    

    @Bean
    public Filter loginFilter() 
        return new LoginFilter();
    


3、网上有的加上@Component注解@Configuration注解过滤器会生效,url会匹配全部,原因得去扒源码看。
过程可以看这篇:

@WebFilter 的使用及采坑 - 木西-Muxy - 博客园 (cnblogs.com)https://www.cnblogs.com/muxi0407/p/11950627.html我尝试了如下几种情况

  1. Filter 实现类 + @WebFilter + @ServletComponentScan:正常urlpattern的Filter
  2. Filter 实现类 + FilterRegistrationBean构造 + @Configuration:正常urlpattern的Filter,并且可以设置Order
  3. 仅仅 Filter实现类 + @Component :会注册一个urlpattern 为 /*的过滤器
  4. 通过1、2、3可以得知,只要在Filter实现类上增加 @Component ,就会导致 1个正常urlpattern的filter+1个拦截/*的filter(由于@Component注解导致)

具体原因可以查看关键类:ServletContextInitializerBeans,看名字就知道,这个类收集了所有ServletContextInitializer的bean列表,而这个接口的实现

 就是所有可以注册Filter、servlet、Listener的 RegistrationBean。

与此同时,ServletContextInitializerBeans的构造函数中做了几件事:

 1、将各个RegistrationBean 放入 MultiValueMap<Class<?>, ServletContextInitializer> initializers 中

 

 2、addAdaptableBeans 方法是上面提到的 增加@Component注解后,就会增加一个 urlpattern 为/* 的filter的元凶了,拿Filter来举例,首先,它会获取所有实现Filter类的Bean集合,并通过FilterRegistrationBeanAdapter中的createRegistrationBean方法 创建一个新的 FilterRegistrationBean,并把Filter的Bean当成构造函数进行初始化,可以看到他并未设置FilterRegistrationBean中的其它Filter属性,比如urlPatterns 都为空。

 

 

 3、最后,将1与2中的所有ServletContextInitializer 实例通过Order等排序手段放入 List<ServletContextInitializer> sortedList中,ServletContextInitializerBeans构造完成。

4、接下来我们来看下 ServletContextInitializerBeans 是在什么时候进行调用的,经过一系列的debug和搜索后锁定了 ServletWebServerApplicationContext

 在 Spring容器启动后,调用了 refresh方法,接着createWebServer 、this.getSelfInitializer().onStartup(servletContext);、

 在这里,构造了上文中提到的ServletContextInitializerBeans,并通过ServletContextInitializerBeans的迭代器获取了所有  ServletContextInitializer 实例,可以看到正是获取了上文中提到的sortedList

 最后通过调用每个 ServletContextInitializer 实例的 onstartup方法,进行了 Filter 的注册

 

进入了  FilterRegistrationBean的父类 AbstractFilterRegistrationBean 的 configure方法

 

 可以明显看到 当 servletname 和 urlpatterns 为空时,使用了 默认值 DEFAULT_URL_MAPPINGS,而这个默认值 正是

 后续就是正常配置filter的逻辑了

完。 

 

以上是关于@WebFilter两种使用方法和失效解决方案的主要内容,如果未能解决你的问题,请参考以下文章

SpringBoot项目@WebFilter过滤器urlPatterns配置失效的解决方案,以及多个filter过滤器demo

SwiftUI禁止用户关闭sheet弹出视图在iOS14.6+失效的巧妙解决

SwiftUI禁止用户关闭sheet弹出视图在iOS14.6+失效的巧妙解决

@WebFilter("")配置servlet访问出现404的原因

十spring自身调用事务失效及两种解决方法- -示列验证

(WebFlux)004WebFilter踩坑记录