第07章-Filter过滤器
第 07 章 Filter 过滤器
Filter 是 Servlet 规范提供的拦截组件,在请求到达目标资源之前进行统一预处理,在响应返回之前进行后处理。登录校验、编码处理、跨域配置、访问日志这类横切功能,都适合集中放在过滤器中,而不必在每个 Servlet 里重复编写。
本章学习目标
- 理解 Filter 的定位和典型应用场景
- 掌握过滤器链的执行顺序与放行机制
- 掌握 Filter 接口的三个方法和 FilterChain 的作用
- 掌握注解与 XML 两种配置方式及拦截路径规则
- 完成登录过滤、编码过滤、耗时统计三个实验
7.1 Filter 概述
7.1.1 什么是过滤器
Filter 是同时拦截请求和响应的通用组件。请求到达 Servlet 或 JSP 之前先经过过滤器,过滤器可以检查、修改请求,也可以直接拒绝放行;目标资源处理完后,响应再沿过滤器链反向返回,过滤器还能对响应做补充处理。
它的价值在于把通用逻辑从业务代码中抽离:业务 Servlet 只关心自己的功能,登录是否有效、编码是否正确等公共问题统一交给过滤器。
7.1.2 典型应用场景
请求预处理:
- 登录验证:拦截需要登录的路径,检查 Session 中是否存在登录用户
- 统一编码:一次性设置请求和响应的字符编码,避免每个 Servlet 重复书写
- 权限控制:判断当前用户是否具备访问管理路径的角色
响应后处理:
- 统一添加响应头,例如跨域允许头、缓存控制头
- 对响应内容做包装修改
日志监控:
- 记录客户端 IP、访问路径、时间
- 统计请求从进入到处理完成的耗时
7.2 过滤器链与执行流程
7.2.1 链式执行
一个请求可以同时匹配多个过滤器,它们按配置顺序组成一条链:
- 客户端请求到达,容器先交给第一个匹配的过滤器
- 过滤器完成预处理,若通过则调用放行方法,请求进入下一个过滤器
- 所有过滤器放行后,请求到达目标资源
- 目标资源生成响应
- 响应沿过滤器链的逆序返回,每个过滤器可执行后处理逻辑,最终回到浏览器
如果某个过滤器不调用放行方法而是直接写响应或重定向,请求就会在此中断,后续过滤器和目标资源都不会执行。
7.2.2 放行方法的意义
doFilter 方法是过滤器链的核心,调用 chain.doFilter 之前的代码属于请求预处理,之后的代码属于响应后处理:
// 放行前:请求预处理
chain.doFilter(request, response);
// 放行后:响应后处理
理解这一点,就能在同一个过滤器里同时处理请求和响应。
7.3 Filter API
7.3.1 Filter 接口
| 方法 | 触发时机 | 作用 |
|---|---|---|
| init(FilterConfig config) | 容器启动、过滤器创建时,执行一次 | 初始化资源,读取初始化参数 |
| doFilter(request, response, chain) | 每次匹配请求到达时执行 | 核心拦截逻辑,决定放行或中断 |
| destroy() | 容器关闭时,执行一次 | 释放资源 |
7.3.2 FilterConfig 与 FilterChain
- FilterConfig:提供过滤器名、初始化参数和 ServletContext,init 方法中通过 getInitParameter 读取配置
- FilterChain:过滤器链对象,只有一个 doFilter 方法,负责把请求交给下一环
7.3.3 请求对象的类型转换
doFilter 的参数是通用的 ServletRequest 和 ServletResponse,需要使用 HTTP 相关方法时,先强转为 Http 类型:
HttpServletRequest request = (HttpServletRequest) servletRequest;
HttpServletResponse response = (HttpServletResponse) servletResponse;
7.4 配置方式与路径规则
7.4.1 注解配置
@WebFilter(urlPatterns = "/user/*")
一个过滤器匹配多个路径:
@WebFilter(urlPatterns = {"/user/*", "/order/*"})
7.4.2 XML 配置
<filter>
<filter-name>loginFilter</filter-name>
<filter-class>com.iooi.filter.LoginFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>loginFilter</filter-name>
<url-pattern>/user/*</url-pattern>
</filter-mapping>
7.4.3 拦截路径规则
- 精确拦截:/login,只拦截这一个地址
- 目录拦截:/admin/*,拦截该目录下全部请求
- 扩展名拦截:*.do,拦截特定后缀
- 全站拦截:/*,拦截所有请求,包括 JSP
7.4.4 多个过滤器的顺序
注解配置时,容器按类名的字典排序决定执行顺序;XML 配置时,按 web.xml 中 filter-mapping 出现的先后顺序决定。需要稳定顺序时,优先使用 XML 或规范命名。
7.5 上机实操
实验一:登录过滤器
实验目的:实现未登录拦截、登录后放行的完整链路。
第一步,编写实体类 User:
package com.iooi.entity;
public class User {
private String name;
private String username;
private String password;
public User() {
}
public User(String name, String username, String password) {
this.name = name;
this.username = username;
this.password = password;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
第二步,编写登录页 login.jsp:
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<html>
<head>
<title>登录</title>
</head>
<body>
<form action="${pageContext.request.contextPath}/login" method="post">
<input type="text" name="username"/><br/>
<input type="password" name="password"/><br/>
<input type="submit" value="登录"/>
</form>
</body>
</html>
第三步,编写 LoginServlet,登录的本质是把用户信息写入 Session:
package com.iooi.servlet;
import com.iooi.entity.User;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebServlet("/login")
public class LoginServlet extends HttpServlet {
@Override
protected void doPost(HttpServletRequest request, HttpServletResponse response)
throws IOException {
request.setCharacterEncoding("UTF-8");
response.setContentType("text/html;charset=UTF-8");
String username = request.getParameter("username");
String password = request.getParameter("password");
if ("admin".equals(username) && "123456".equals(password)) {
User user = new User("张三", username, password);
request.getSession().setAttribute("loginUser", user);
response.getWriter().write("登录成功");
} else {
response.getWriter().write("账号或密码错误");
}
}
}
第四步,编写受保护的 UserInfoServlet:
package com.iooi.servlet;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebServlet("/user/info")
public class UserInfoServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws IOException {
response.setContentType("text/html;charset=UTF-8");
response.getWriter().write("这里是用户个人信息页");
}
}
第五步,编写 LoginFilter:
package com.iooi.filter;
import jakarta.servlet.Filter;
import jakarta.servlet.FilterChain;
import jakarta.servlet.FilterConfig;
import jakarta.servlet.ServletException;
import jakarta.servlet.ServletRequest;
import jakarta.servlet.ServletResponse;
import jakarta.servlet.annotation.WebFilter;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebFilter(urlPatterns = "/user/*")
public class LoginFilter implements Filter {
@Override
public void init(FilterConfig filterConfig) {
}
@Override
public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse,
FilterChain chain) throws IOException, ServletException {
HttpServletRequest request = (HttpServletRequest) servletRequest;
HttpServletResponse response = (HttpServletResponse) servletResponse;
Object loginUser = request.getSession().getAttribute("loginUser");
if (loginUser == null) {
response.sendRedirect(request.getContextPath() + "/login.jsp");
return;
}
chain.doFilter(request, response);
}
@Override
public void destroy() {
}
}
验证步骤与预期:
- 不登录直接访问 /user/info,页面被重定向到登录页,地址栏变为 login.jsp,个人信息页内容不会出现
- 输入 admin、123456 登录,页面提示登录成功
- 再次访问 /user/info,过滤器放行,显示“这里是用户个人信息页”
实验二:统一编码过滤器
实验目的:用一个过滤器替代所有 Servlet 中的编码设置。
package com.iooi.filter;
import jakarta.servlet.Filter;
import jakarta.servlet.FilterChain;
import jakarta.servlet.FilterConfig;
import jakarta.servlet.ServletException;
import jakarta.servlet.ServletRequest;
import jakarta.servlet.ServletResponse;
import jakarta.servlet.annotation.WebFilter;
import java.io.IOException;
@WebFilter(urlPatterns = "/*")
public class EncodingFilter implements Filter {
private String encoding = "UTF-8";
@Override
public void init(FilterConfig filterConfig) {
String configEncoding = filterConfig.getInitParameter("encoding");
if (configEncoding != null) {
encoding = configEncoding;
}
}
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
request.setCharacterEncoding(encoding);
response.setCharacterEncoding(encoding);
response.setContentType("text/html;charset=" + encoding);
chain.doFilter(request, response);
}
@Override
public void destroy() {
}
}
预期结果:全站所有请求的中文参数和中文响应都不再乱码,业务 Servlet 中可以删除重复的编码语句。
实验三:请求耗时过滤器
实验目的:在放行前后取时间,计算目标资源处理耗时。
package com.iooi.filter;
import jakarta.servlet.Filter;
import jakarta.servlet.FilterChain;
import jakarta.servlet.FilterConfig;
import jakarta.servlet.ServletException;
import jakarta.servlet.ServletRequest;
import jakarta.servlet.ServletResponse;
import jakarta.servlet.annotation.WebFilter;
import jakarta.servlet.http.HttpServletRequest;
import java.io.IOException;
@WebFilter(urlPatterns = "/*")
public class TimingFilter implements Filter {
@Override
public void init(FilterConfig filterConfig) {
}
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
throws IOException, ServletException {
HttpServletRequest httpRequest = (HttpServletRequest) request;
long start = System.currentTimeMillis();
chain.doFilter(request, response);
long cost = System.currentTimeMillis() - start;
System.out.println("路径 " + httpRequest.getRequestURI() + " 耗时 " + cost + " ms");
}
@Override
public void destroy() {
}
}
预期控制台输出:
路径 /user/info 耗时 12 ms
7.6 常见问题排查
| 现象 | 原因 | 解决方式 |
|---|---|---|
| 过滤器不生效 | 路径规则不匹配或类未被容器扫描 | 核对 urlPatterns 与实际请求路径 |
| 重定向后仍继续执行业务 | 重定向后没有 return | 中断分支末尾加 return |
| 过滤器死循环 | 重定向目标也被同一过滤器拦截 | 放行登录页等公共资源,缩小拦截范围 |
| 多个过滤器顺序不符预期 | 注解按类名排序 | 改用 XML 或规范类名 |
| 静态资源也被拦截 | 使用了 /* 通配 | 过滤器内对静态路径直接放行 |
7.7 本章小结
- Filter 在请求到达资源前预处理、在响应返回时后处理,适合承载横切逻辑
- 过滤器链按配置顺序执行、逆序返回,chain.doFilter 是放行与分界点
- Filter 生命周期与 Servlet 类似,init 一次、doFilter 多次、destroy 一次
- 注解和 XML 均可配置,路径支持精确、目录、扩展名和全站匹配
- 登录过滤是最核心的实战模式,下一章将学习用于监听容器事件的 Listener

