3
0
1

第07章-Filter过滤器

2026-11-13
2026-11-13

第 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 链式执行

一个请求可以同时匹配多个过滤器,它们按配置顺序组成一条链:

  1. 客户端请求到达,容器先交给第一个匹配的过滤器
  2. 过滤器完成预处理,若通过则调用放行方法,请求进入下一个过滤器
  3. 所有过滤器放行后,请求到达目标资源
  4. 目标资源生成响应
  5. 响应沿过滤器链的逆序返回,每个过滤器可执行后处理逻辑,最终回到浏览器

如果某个过滤器不调用放行方法而是直接写响应或重定向,请求就会在此中断,后续过滤器和目标资源都不会执行。

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() {
    }
}

验证步骤与预期:

  1. 不登录直接访问 /user/info,页面被重定向到登录页,地址栏变为 login.jsp,个人信息页内容不会出现
  2. 输入 admin、123456 登录,页面提示登录成功
  3. 再次访问 /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

支持与分享

如果这篇文章对你有帮助,欢迎分享给更多人或者给予支持!

第07章-Filter过滤器
/archives/post-1794499612553
作者
Bam
发布于
2026-11-13
许可协议
CC BY-NC-SA 4.0

评论