站长网 语言 Spring Boot使用Filter的正确方式!

Spring Boot使用Filter的正确方式!

Filter 是 JavaEE 中 Servlet 规范的一个组件,位于包javax.servlet 中,它可以在 HTTP 请求到达 Servlet 之前,被一个或多个Filter处理。 它的工作流程如图: Filter的这个特性在生产环境中有很广泛的应用,如:修改请求和响应、防止xss攻击、包装二进制流

Filter 是 JavaEE 中 Servlet 规范的一个组件,位于包javax.servlet 中,它可以在 HTTP 请求到达 Servlet 之前,被一个或多个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的,可以不用实现。
 
Spring Boot 基础就不介绍了,推荐下这个实战教程:https://github.com/javastacks/spring-boot-best-practice
 
注意:如果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;  
    }  
}
通过 Java 代码显式配置 Filter ,功能强大,配置灵活。只需要把每个自定义的 Filter 声明成 Bean 交给 Spring 管理即可,还可以设置匹配的 URL 、指定 Filter 的先后顺序。

本文来自网络,不代表站长网立场,转载请注明出处:https://www.tzzz.com.cn/html/biancheng/yuyan/2021/1105/20290.html

作者: dawei

【声明】:站长网内容转载自互联网,其相关言论仅代表作者个人观点绝非权威,不代表本站立场。如您发现内容存在版权问题,请提交相关链接至邮箱:bqsm@foxmail.com,我们将及时予以处理。
联系我们

联系我们

0577-28828765

在线咨询: QQ交谈

邮箱: xwei067@foxmail.com

工作时间:周一至周五,9:00-17:30,节假日休息

返回顶部