1. java过滤器作用:Web请求处理的核心枢纽
java过滤器(Filter)是Java EE规范中定义的一种组件,位于Web容器与资源(如Servlet、JSP、静态资源)之间,用于在请求到达目标资源前或响应返回客户端前进行预处理和后处理。其核心作用可概括为请求拦截、权限校验、编码统一、日志记录与性能监控五大维度。
从架构视角看,Filter构成了请求-响应链(Filter Chain)中的关键环节。当客户端发起HTTP请求时,Web容器首先将请求交由Filter链处理——每个Filter可选择:继续传递请求(调用filterChain.doFilter())或中断链路(直接响应客户端)。这种机制实现了业务逻辑与横切关注点(如认证、日志)的解耦,符合面向切面编程(AOP)思想。
特别需要指出的是,Filter与Servlet同属“组件级”技术,但其职责更偏向“管道式”处理:不生成最终响应内容,而是对请求/响应对象进行加工、增强或阻断。例如:字符编码过滤器统一将请求编码设为UTF-8;安全过滤器验证用户登录状态;CORS过滤器添加跨域响应头;性能监控过滤器记录请求耗时。这些功能若直接写入每个Servlet,将导致代码冗余、维护困难。
开发者高频认知误区:许多初学者误认为Filter只能拦截Servlet请求。实际上,Filter可拦截任意资源路径(包括静态资源如.css/.js/.png),只要其URL模式匹配即可。例如:/static/*可过滤所有静态资源访问。
从技术演进角度看,Filter机制是Spring Framework中HandlerInterceptor、Spring Security过滤器链的基础原型。理解原生Filter对掌握现代Java Web框架至关重要——它不仅是工具,更是构建可维护系统的核心范式。
1.1 与Servlet的协同关系
Filter与Servlet的协作遵循“管道模式”(Pipeline Pattern):请求流经多个Filter后抵达Servlet,响应则逆序流经Filter链返回客户端。其执行顺序由web.xml中<filter-mapping>配置顺序或注解@WebFilter的urlPatterns决定(注解方式按类名字母序,需谨慎控制)。
典型执行流程如下:
客户端 → Filter1.doFilter() → Filter2.doFilter() → Servlet.service() → Filter2.doFilter()后置处理 → Filter1.doFilter()后置处理 → 客户端
特别注意:若某Filter未调用doFilter(),请求将在此中断,后续Filter及Servlet均不执行。这常被用于权限拦截——当检测到未登录时,直接重定向至登录页。
2. java过滤器作用原理:请求拦截的底层机制
Filter的核心原理在于对HttpServletRequest与HttpServletResponse对象的包装与增强。Web容器在启动时加载Filter实例,并根据配置构建FilterChain。当匹配URL的请求到达时,容器调用第一个Filter的doFilter()方法,该方法可选择:
• ① 调用filterChain.doFilter(request, response)传递请求
• ② 直接向客户端写入响应并终止流程
• ③ 修改request/response对象后传递(需使用包装类)
关键机制在于FilterChain的递归调用设计。每个Filter持有剩余链的引用,形成递归调用树。简化伪代码如下:
void doFilter(Request req, Response res, FilterChain chain) {
// 前置处理
chain.doFilter(req, res); // 关键:触发下一Filter
// 后置处理
}
这种设计使Filter具备天然的双向拦截能力:前置处理(请求进入前)与后置处理(响应返回前)。例如日志过滤器可在请求进入时记录开始时间,响应返回时计算耗时并输出日志。
2.1 请求包装器(Request Wrapper)技术
当需要修改请求参数(如统一转小写)或读取多次输入流(如JSON请求体)时,原生HttpServletRequest无法满足需求,需继承HttpServletRequestWrapper创建包装类。典型场景:
• ① 参数标准化:将所有参数值去除首尾空格、统一编码
• ② 输入流重复读取:缓存getInputStream()的字节数组
• ③ 安全过滤:对请求参数进行XSS/SQL注入清洗
示例代码片段:
| 操作 | 原生限制 | 包装器解决方案 |
|---|---|---|
| 读取请求体 | getInputStream()只能调用一次 | 重写getInputStream(),返回缓存流 |
| 修改参数 | getParameter()不可变 | 重写getParameter(),内部维护修改后的Map |
| 增强请求头 | 无法添加新Header | 重写getHeader(),合并原始与新增头 |
2.2 响应压缩过滤器原理
为减少网络传输量,Filter可实现响应压缩。其原理是:
① 检查客户端Accept-Encoding头是否支持gzip/deflate
② 若支持,包装HttpServletResponse为GZipResponseWrapper
③ 在getOutputStream()中返回GZIPOutputStream
④ 响应内容经压缩后写入客户端
关键点在于:压缩流需在doFilter()后置处理中关闭,确保数据完整刷新。否则可能出现响应体截断。
3. java过滤器作用生命周期:初始化→执行→销毁
Filter的生命周期完全由Web容器管理,包含三个核心阶段:
① 初始化阶段:容器创建Filter实例后调用init(FilterConfig config)。此时可读取初始化参数(如<init-param>配置的编码集),建立资源连接(如数据库连接池)。该方法仅执行一次。
② 过滤阶段:每次匹配请求到达时调用doFilter(ServletRequest req, ServletResponse res, FilterChain chain)。此方法可能被调用多次,是核心业务逻辑所在。
③ 销毁阶段:容器关闭时调用destroy()。用于释放资源(如关闭连接池、文件句柄)。该方法仅执行一次。
init(),传入FilterConfig。参数:<filter-name>、<init-param>值、ServletContext引用doFilter()。关键操作:• 前置:修改请求/响应对象
• 中断:直接响应客户端
• 后置:处理响应结果
destroy()。释放资源、清理缓存。注意:Tomcat热部署可能不触发此方法!3.1 多Filter执行顺序控制
当多个Filter匹配同一URL时,执行顺序至关重要。容器按以下规则排序:
规则1:web.xml中<filter-mapping>顺序优先于<filter>定义顺序
规则2:注解方式按@WebFilter类名字母序(Tomcat 8+)
规则3:Spring Boot中@Order注解优先级最高
最佳实践:
• 将CharacterEncodingFilter置于链首,确保后续处理使用统一编码
• 将SecurityFilter置于LogFilter之前,避免敏感日志泄露
• 使用Order注解明确指定优先级(Spring环境)
生产环境风险点:在Tomcat热部署时,Filter销毁方法可能不被调用,导致资源泄漏(如线程池未关闭)。建议使用ServletContextListener管理资源生命周期。
4. java过滤器作用配置方式:XML与注解双模式
Filter配置支持两种主流方式:web.xml声明式配置与@WebFilter注解配置。二者可混合使用,但注解优先级更高(容器合并规则)。
4.1 web.xml配置详解
典型配置结构:
<filter>定义Filter类与初始化参数
<filter-mapping>指定URL匹配规则
示例:配置字符编码过滤器
<filter>
<filter-name>encodingFilter</filter-name>
<filter-class>com.example.filter.EncodingFilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>UTF-8</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
关键配置项:
url-pattern:支持精确匹配(/login)、路径匹配(/api/*)、扩展名匹配(*.jsp)
dispatcher:指定拦截时机(REQUEST/INCLUDE/FORWARD/ERROR),默认REQUEST
init-param:传递自定义参数(如编码、白名单)
4.2 注解配置进阶技巧
使用@WebFilter注解简化配置:
@WebFilter(filterName="logFilter", urlPatterns="/*", dispatcherTypes=DispatcherType.REQUEST)
public class LogFilter implements Filter { ... }
优势:
• 类内定义,避免XML配置错位
• 支持asyncSupported开启异步过滤
• 与@WebListener配合实现自动注册
局限:
• 无法动态调整URL模式
• 多环境配置需配合web-fragment.xml
4.3 Spring Boot自动配置
在Spring Boot中,Filter通过FilterRegistrationBean注册,支持动态配置:
@Bean
public FilterRegistrationBean<LogFilter> logFilter() {
FilterRegistrationBean<LogFilter> registration = new FilterRegistrationBean();
registration.setFilter(new LogFilter());
registration.addUrlPatterns("/*");
registration.setOrder(1);
registration.setName("logFilter");
return registration;
}
特别优势:
• 通过setOrder()精确控制优先级
• 支持条件化注册(如@ConditionalOnProperty)
• 自动处理异步请求(无需额外配置)
5. java过滤器作用高频场景:10大实战应用
5.1 权限控制过滤器
拦截未授权访问,核心逻辑:
① 从Session获取用户凭证
② 检查当前URL是否在白名单(如/login)
③ 验证角色权限(如/admin需ADMIN角色)
④ 不满足则重定向至登录页
关键实现:
String uri = request.getRequestURI();
if (isWhiteListed(uri)) { chain.doFilter(req, res); return; }
if (!user.hasPermission(uri)) { response.sendRedirect("/login"); return; }
增强方案:
• 使用JWT令牌替代Session(无状态)
• 支持RBAC(基于角色)与ABAC(基于属性)模型
• 集成CAS实现单点登录
5.2 请求日志过滤器
记录完整请求链路,包含:
• 请求时间、IP、URL、参数
• 响应状态码、耗时
• 异常堆栈(5xx时)
实现要点:
① 时间戳记录:在doFilter开始记录System.currentTimeMillis()
② 响应状态捕获:需包装HttpServletResponseWrapper重写sendError()与setStatus()
③ 高性能日志输出:使用异步日志框架(如Logback AsyncAppender)
示例输出:
[2024-05-20 14:30:22] 192.168.1.100 GET /api/user/list?size=20 200 47ms
5.3 字符编码过滤器
解决中文乱码问题,核心逻辑:
request.setCharacterEncoding(encoding);
response.setCharacterEncoding(encoding);
response.setContentType("text/html;charset=" + encoding);
必须注意:
• 必须在request.getParameter()前调用setCharacterEncoding()
• 对于POST请求有效,GET请求需配置Tomcat URIEncoding="UTF-8"
• 建议统一使用UTF-8避免编码冲突
5.4 CORS跨域支持
添加标准跨域响应头:
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: GET,POST,PUT,DELETE
Access-Control-Allow-Headers: Content-Type,Authorization
高级配置:
• 限制源域名:Access-Control-Allow-Origin: https://example.com
• 支持预检请求:Access-Control-Max-Age: 86400
• 传递凭证:Access-Control-Allow-Credentials: true
5.5 响应缓存控制
根据资源类型设置缓存策略:
• 静态资源:设置Cache-Control: max-age=31536000
• 动态API:设置Cache-Control: no-store
• 条件缓存:配合ETag与Last-Modified
实现技巧:
使用HttpServletResponseWrapper重写setHeader(),自动注入缓存头
5.6 安全防护过滤器
实现基础安全措施:
• XSS防护:清洗请求参数中的