【Spring Boot系列】-Spring Boot过滤器Filter

【Spring Boot系列】-Spring Boot过滤器Filter

一、概述

**Filter（过滤器）可以理解为经过一层次的过滤处理才达到使用的要求，而其实Filter（过滤器）就是服务器与客户端请求与响应的中间层组件，在实际项目开发中Filter（过滤器）**主要用于对浏览器的请求进行过滤处理，将过滤后的请求再转给下一个资源。

**Filter（过滤器）**是一个小型web组件，它们通过拦截请求和响应，以便查看、提取或以某种方式操作客户端和服务器之间交换的数据，实现“过滤”的功能。Filter通常封装了一些功能的web组件，过滤器提供了一种面向对象的模块化机制，将任务封装到一个可插入的组件中， Filter组件通过配置文件来声明，并动态的代理。

二、Filter（过滤器）数据流程

1. 接收用户请求，处理用户请求
2. Filter:拦截用户请求
3. Listener:监听器

三、Spring Boot 过滤器生命周期

使用过滤器很简单，只需要实现Filter类，然后重写它的3个方法即可。

• init方法：程序启动调用Filter的init()方法(永远只调用一次)；在容器中创建当前过滤器的时候自动调用这个方法。
• destory方法：程序停止调用Filter的destroy()方法(永远只调用一次)；在容器中销毁当前过滤器的时候自动调用这个方法。
• doFilter方法：doFilter()方法每次的访问请求如果符合拦截条件都会调用(程序第一次运行，会在servlet调用init()方法以后调用；不管第几次，都在调用doGet(),doPost()方法之前)。这个方法有3个参数，分别是ServletRequest、ServletResponse和FilterChain可以从参数中获取HttpServletReguest和HttpServletResponse对象进行相应的处理操作。

四、使用注解方式实现过滤器(@WebFilter)

4.1. 在springboot 启动类添加该注解@ServletComponentScan

@SpringBootApplication
@ServletComponentScan // 过滤器
public class SpringbootFilterApplication {SpringApplication.run(SpringbootFilterApplication.class, args);
}

4.2. 写个过滤器类，实现Filter接口

@Component
@WebFilter(urlPatterns = "/filter/*", filterName = "myTestFilter") 
@Slf4
public class MyTestFilter implements Filter {@Overridepublic void init(FilterConfig filterConfig) throws ServletException {log.info("[ {} ] 创建啦...", this.getClass().getSimpleName());}@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {log.info("[ {} ] 执行啦...", this.getClass().getSimpleName());chain.doFilter(request, response);}@Overridepublic void destroy() {log.info("[ {} ] 被摧毁啦...", this.getClass().getSimpleName());}
}

4.3 @WebFilter作用总结

Tomcat 的 servlet 包下的注解，通过 @WebFilter 注解可以将指定类声明为过滤器。
@WebFilter 属性中没有配置顺序的，其执行顺序和 Filter 类名称字符排序有关，如果需要设置执行顺序，可以在命名的时候注意一下。

五、@Component注解实现过滤器

使用 @Component 将类声明为 Bean ，配合使用 @Order 注解可以设置过滤器执行顺序。

@Order(1)
@Component
public class WebVisitFilter implements Filter {@Overridepublic void init(FilterConfig filterConfig) throws ServletException {//初始化配置}/*** 输出访问*/@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws ServletException, IOException {// 业务处理}@Overridepublic void destroy() {//业务注销}
}

六、Java Config 配置类

使用 @Configuration + @Bean 配置类，注解声明Bean，交由 Spring 容器管理。
Java Config 的方式可以通过 @Bean 配置顺序或 FilterRegistrationBean.setOrder() 决定 Filter 执行顺序。

public class MyFilter implements Filter {@Overridepublic void init(FilterConfig filterConfig) throws ServletException {}@Overridepublic void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws ServletException, IOException {// 业务处理}@Overridepublic void destroy() {}
}@Configuration
public class MyFilterConfig {/*** 注册 过滤器 Filter*/@Beanpublic FilterRegistrationBean<Filter> webVisitFilterConfigRegistration() {//匹配拦截 URLString urlPatterns = "/admin/*,/system/*";FilterRegistrationBean<Filter> registration = new FilterRegistrationBean<Filter>();registration.setDispatcherTypes(DispatcherType.REQUEST);registration.setFilter(new WebVisitFilter());registration.addUrlPatterns(StringUtils.split(urlPatterns, ","));//设置名称registration.setName("MyFilter");//设置过滤器链执行顺序registration.setOrder(3);//启动标识registration.setEnabled(true);//添加初始化参数registration.addInitParameter("enabel", "true");return registration;}
}

七、FilterChain 的作用

过滤器链是一种责任链模式的设计实现，在一个Filter 处理完成业务后，通过 FilterChain 调用过滤器链中的下一个过滤器。
流程如下：

• FilterChain 接口定义了 doFilter 方法

public interface FilterChain { public void doFilter(ServletRequest request, ServletResponse response)throws IOException, ServletException;
}

• ApplicationFilterChain类实现了 FilterChain 接口，管理所有的 Filter 的执行与调用

public final class ApplicationFilterChain implements FilterChain {// 数组存储所有的过滤器链private ApplicationFilterConfig[] filters = new ApplicationFilterConfig[0];// 类中实现 doFilter() 方法 调用 调用 internalDoFilter(req,res) 方法public void doFilter(ServletRequest request, ServletResponse response)throws IOException, ServletException {// ...//调用 internalDoFilterinternalDoFilter(request,response);}
}

• internalDoFilter(req,res) 方法中实现 Filter 调用的具体的操作

//取得数组中下一个过滤器实例
ApplicationFilterConfig filterConfig = filters[pos++];
Filter filter = filterConfig.getFilter();
// ...
//调用下一个过滤器的 doFilter() 方法
filter.doFilter(request, response, this);

七、总结

创建过滤器有三种方法分别：

1. @Component + @Order

2. @WebFilter + ServlertComponentScan

3. JavaConfig - FilterRegistrationBean

过滤器Filter作用场景 1）.防止未登录就进入界面 2）. 控制应用编码 3) . 过滤敏感词汇等场景