@WebFilter和@Component一起使用导致urlPatterns不起作用

@WebFilter和@Component

本文你主要讲解@WebFilter注解和@Component以及在使用过程中遇到的坑

@WebFilter

1.基本概念:
@WebFilter用于将一个类声明为过滤器,该注解将会在部署时候被容器处理,容器将根据具体的属性配置将相应的类部署为过滤器。该注解具有下表给出的常用属性(以下所有属性均为可选属性,但是value、urlPatterns、servletNames三者必须至少包含一个,且value和urlPatterns不能共存,如果同同时制定,通常忽略value的值)

属性名类型描述
filterNameString指定过滤器的name属性,等价于< filter-name>
valueString[]该属性等价于urlPatterns属性,但是两个不应该同时使用
urlPatternsString[]指定一组过滤器的URL匹配模式。等价于< url-pattern>
sevletNamesString[]指定过滤器将用于哪些servlet。取值是@WebServlet中的name属性的取值,或者是web.xml中< servlet-name>
dispatcherTypesDispatcheType指定过滤器的转发模式。具体取值包括:ASYNC、ERROR、FORWARD、INCLUDE、REQUEST
initParamsWebInitParam[]指定一组过滤器初始化参数,等价于< init-param>
asyncSupportedboolean声明过滤器是否支持异步操作模式,等价于< async-supported>标签
descriptionString该过滤器的描述信息,等价于< description>
displayNameString该过滤器的显示名,通常配合工具使用,等价于< display-name>

2.正确示例:
a.过滤器如下

@WebFilter(filterName = "useTokenRequestFilter", urlPatterns = {"/v1/quote/*"})
public class MyFilter implements Filter{
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
    }


    @Override
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException {
        //TODO
        chain.doFilter(req, resp);
    }

    @Override
    public void destroy() {
    }
}

b.在启动类添加@ServletComponentScan

@SpringBootApplication(exclude = {DataSourceAutoConfiguration.class})
@EnableAspectJAutoProxy
@EnableDiscoveryClient
@ServletComponentScan(basePackages = {"填写自己的过滤器包名"})
@EnableFeignClients
@EnableCaching
public class123Application {
    public static void main(String[] args) {
        System.setProperty("com.alibaba.nacos.client.naming.tls.enable","true");
        SpringApplication.run(OrderServiceApplication.class);
    }
}

@Component

@component: 标注一个类为Spring容器的Bean,(把普通pojo实例化到spring容器中,相当于配置文件中的)

采坑记录

由于业务需要使用Filter。大体逻辑如下:
①通过WebFilter进行Filter声明,这样容器在进行部署的时候就会处理该Filter,创建实例并创建配置对象FilterConfig,然后会将该Filter应用到urlPatterns所指定的url;
②在init方法中获取到初始化参数,自定义的excludedUrls,作为成员在后续执行过滤逻辑的时候使用;
③在doFilter中进行url的鉴定,如果需要执行认证鉴权处理,则执行相应逻辑。不满足条件的情况下重定向到登录页;
④Filter类增加Component注解,让该Filter被容器管理。
问题就出在第一步和第四步。urlPatterns指定的URL不起作用,所有的请求都会经过过滤器,

@Component
@WebFilter(filterName = "1212121", urlPatterns = {"/v1/9874/*"})
public class MyFilter implements Filter{
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
    }


    @Override
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException {
        //TODO
        chain.doFilter(req, resp);
    }

    @Override
    public void destroy() {
    }
}

然后在SpringBoot的Application中增加注解@ServletComponentScan,这样容器会扫描到@Component注解的Filter。

问题出现

出现的问题是:访问的url为/user/*或者/product/*的时候,该过滤器也执行了!
也就是说,WebFilter注解配置的urlPatterns没有起作用。

问题定位:
在查看容器启动日志的时候,发现WebAuthFilter被两次注册,两次映射,分别为WebAuthFilter和webAuthFilter

问题原因:
WebAuthFilter的第一次映射容易理解,是我们自己通过@WebFilter定义的。那么webAuthFilter是谁给映射的呢?必然是Spring容器处理的。在跟踪源码的时候找到AbstractFilterRegistrationBean抽象类,该类中有一个方法onStartup,应该是容器启动的时候执行的,做的是一些Bean注册的工作。该方法最后调用了configure,在该方法中进行了映射处理。

if (servletNames.isEmpty() && this.urlPatterns.isEmpty()) {
	this.logger.info("Mapping filter: '" + registration.getName() + "' to: "
		+ Arrays.asList(DEFAULT_URL_MAPPINGS));
     registration.addMappingForUrlPatterns(dispatcherTypes, this.matchAfter,
                    DEFAULT_URL_MAPPINGS);
}else {
       if (!servletNames.isEmpty()) {
                this.logger.info("Mapping filter: '" + registration.getName()
                        + "' to servlets: " + servletNames);
                registration.addMappingForServletNames(dispatcherTypes, this.matchAfter,
                        servletNames.toArray(new String[servletNames.size()]));
            }
            if (!this.urlPatterns.isEmpty()) {
                this.logger.info("Mapping filter: '" + registration.getName()
                        + "' to urls: " + this.urlPatterns);
                registration.addMappingForUrlPatterns(dispatcherTypes, this.matchAfter,
                        this.urlPatterns.toArray(new String[this.urlPatterns.size()]));
            }
        }

在servletNames和urlPatterns为空的情况下,进行了缺省映射,即映射到“/*”。置于servletNames和urlPatterns为空的情况,这里没有深究了。那么,为什么会出现定义的WebAuthFilter被两次注册的情况呢?仔细分析了一下,认为可能的原因是:@Component和@WebFilter双重注册导致的。
解决方法:
解决办法一@WebFilter
在这种情况下,去掉了@Component注解,再次启动服务。查看日志,发现该Filter仅被映射一次,通过浏览器访问相应的url也表现正确。

解决办法二@Component

这种情况下,保留了@Component注解,那么要进行配置的urlPatterns怎么处理呢?
通过FilterRegistrationBean进行@Bean声明,查看源码知道,onStartup进行注册的时候,实际上也是找到了各类RegistrationBean然后分别注册,配置映射。
有各种类型的RegistrationBean:
①AbstractFilterRegistrationBean;
②FilterRegistrationBean;
③ServletListenerRegistrationBean;
④ServletRegistrationBean;
那么我们自然可以通过自声明一个FilterRegistrationBean来进行注册。这种处理方式如下:
去掉FIlter上的@WebFilter注解,增加如下的Configuration类:

@Configuration
public class WebAuthFilterConfig {

    @Bean
    public FilterRegistrationBean webAuthFilterRegistration() {
        FilterRegistrationBean registration = new FilterRegistrationBean();
        registration.setFilter(webAuthFilter());
        registration.setName("WebAuthFilter");
        registration.addUrlPatterns("/web/*");
        registration.addInitParameter("excludeUrls", "/web/login");
        registration.setOrder(0);
        return registration;
    }

    @Bean
    public Filter webAuthFilter() {
        return new WebAuthFilter();
    }
}

如此处理,也能达到同样的效果。
经过对比,当然第一种解决方案更直白,更简洁。
参考链接:https://www.cnblogs.com/muxi0407/p/11950627.html

Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐