springboot使用之多个filter的执行顺序以及配置方式

springboot 多个filter的执行顺序以及配置

当项目中有多个filter时，为了便于管理，可以创建一个配置文件，对所有的filter进行管理。

有的方法可能同时需要多个filter依次对其进行过滤，这时候便需要对filter的执行进行优先级的排序。如下：

新建一个配置文件ComponentFilterOrderConfig.java

先生成一个过滤器的bean，再把过滤器的bean注入到FilterRegistrationBean中，并设置一些属性，过滤的url，执行的顺序之类的（order的数值越小，优先级越高）即可。

在MyHiddenHttpMethodFilter.java和TokenAuthorFilter.java里面不需要在添加注解@WebFilter(urlPatterns={})或@Configuration @Component等注解

				?

									@Configuration

									public class ComponentFilterOrderConfig {

									 @Bean

									 public Filter MyHiddenHttpMethodFilter(){

									  return new MyHiddenHttpMethodFilter();//自定义的过滤器

									 }

									 @Bean

									 public Filter tokenAuthorFilter(){

									  return new TokenAuthorFilter();//自定义的过滤器

									 }

									 @Bean

									 public FilterRegistrationBean filterRegistrationBean1(){

									  FilterRegistrationBean filterRegistrationBean=new FilterRegistrationBean();

									  filterRegistrationBean.setFilter(MyHiddenHttpMethodFilter());

									  filterRegistrationBean.addUrlPatterns("/app/approval/*");

									  filterRegistrationBean.setOrder(6);//order的数值越小 则优先级越高

									  return filterRegistrationBean;

									 }

									 @Bean

									 public FilterRegistrationBean filterRegistrationBean2(){

									  FilterRegistrationBean filterRegistrationBean=new FilterRegistrationBean();

									  filterRegistrationBean.setFilter(tokenAuthorFilter());

									  filterRegistrationBean.addUrlPatterns("/app/*");

									  filterRegistrationBean.setOrder(7);

									  return filterRegistrationBean;

									 }  

									}

SpringBoot 使用 Filter 的正确姿势

Filter 是 JavaEE 中 Servlet 规范的一个组件，位于包javax.servlet 中，它可以在 HTTP 请求到达 Servlet 之前，被一个或多个Filter处理。

它的工作流程如图：

springboot使用之多个filter的执行顺序以及配置方式

Filter的这个特性在生产环境中有很广泛的应用，如：修改请求和响应、防止xss攻击、包装二进制流使其可以多次读，等等。

实际工作中，我们都是使用 SpringBoot 进行业务开发，本文总结三种 Filter 用法，SpringBoot 版本采用目前最新的 v2.3.1.RELEASE

1. 编写Filter

要编写 Filter ，只需要实现javax.servlet.Filter接口就可以了

				?

									public class MyFilter implements Filter {

									    @Override

									    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {

									        System.out.println("MyFilter");

									        // 要继续处理请求，必须添加 filterChain.doFilter()

									        filterChain.doFilter(servletRequest,servletResponse);

									    }

									}

Filter 接口有三个方法：init(),doFilter(),destroy()。

其中doFilter()需要自己实现，其余两个是default的，可以不用实现。

注意：如果Filter要使请求继续被处理，就一定要调用filterChain.doFilter()！

2. 配置Filter被 Spring 管理

让自定义的 Filter 被 Spring 的 IOC 容器管理，有三种实现方式，各有优缺点。下面课代表给大家总结一下：

1. 使用@Component+@Order

在刚刚定义的MyFilter类上加上@Component和@Order注解，即可被Spring管理

				?

									@Component

									@Order(1)

									public class MyFilter implements Filter {

									    @Override

									    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {

									        System.out.println("MyFilter");

									        // 要继续处理请求，必须添加 filterChain.doFilter()

									        filterChain.doFilter(servletRequest,servletResponse);

									    }

									}

没错就这么简单，这样 MyFilter 就生效了，写个Controller 调用一下就可以看到效果。

当有多个Filter时，这里的@Order(1)注解会指定执行顺序，数字越小，越优先执行，如果只写@Order，默认顺序值是Integer.MAX_VALUE。

@Component + @Order 注解方式配置简单，支持自定义 Filter 顺序。缺点是只能拦截所有URL，不能通过配置去拦截指定的 URL。

2.@WebFilter+@ServletComponentScan

在 MyFilter上添加@WebFilter注解，并在启动类上增加@ServletComponentScan("com.zhengxl.filterdemo.filter")注解，参数就是Filter所在的包路径，相当于告诉 SpringBoot，去哪里扫描 Filter

				?

									@WebFilter(urlPatterns = "/*")

									public class MyFilter implements Filter {

									    @Override

									    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {

									        System.out.println("MyFilter");

									        // 要继续处理请求，必须添加 filterChain.doFilter()

									        filterChain.doFilter(servletRequest,servletResponse);

									    }

									}

									@SpringBootApplication

									@ServletComponentScan("com.zhengxl.filterdemo.filter")

									public class FilterDemoApplication {

									    public static void main(String[] args) {

									        SpringApplication.run(FilterDemoApplication.class, args);

									    }

									}

@WebFilter+@ServletComponentScan 注解方式支持对 Filter 匹配指定URL，但是不支持指定 Filter 的执行顺序。

3. JavaConfig 配置方式

				?

									@Configuration

									public class FilterConfig {

									    @Bean

									    public FilterRegistrationBean registerMyFilter(){

									        FilterRegistrationBean<MyFilter> bean = new FilterRegistrationBean<>();

									        bean.setOrder(1);

									        bean.setFilter(new MyFilter());

									        // 匹配"/hello/"下面的所有url

									        bean.addUrlPatterns("/hello/*");

									        return bean;

									    }

									    @Bean

									    public FilterRegistrationBean registerMyAnotherFilter(){

									        FilterRegistrationBean<MyAnotherFilter> bean = new FilterRegistrationBean<>();

									        bean.setOrder(2);

									        bean.setFilter(new MyAnotherFilter());

									        // 匹配所有url

									        bean.addUrlPatterns("/*");

									        return bean;

									    }

									}