编程自学指南：java程序设计开发，过滤器（Filter）与监听器（Listener）基础全解析 ， Listener 的事件监听机制，Filter 实现编码统一、权限控制

编程自学指南：java程序设计开发，过滤器（Filter）与监听器（Listener）基础

一、课程信息

学习目标

1. 理解 Filter 的核心作用：请求预处理与响应后处理
2. 掌握 Listener 的事件监听机制
3. 能通过 Filter 实现编码统一、权限控制
4. 能通过 Listener 监控应用状态

二、课程导入：生活中的过滤器与监听

🌰 场景类比

• Filter：像机场的安检（请求进入前检查）
• Listener：像商场的客流量统计系统（监听人员进出）

三、过滤器（Filter）详解

🔍 1. 核心概念

• 定义：
  Filter 是 JavaWeb中用于拦截请求的组件，可在请求到达 Servlet 前预处理，或在响应返回客户端前进行后处理
• 应用场景：
  ✅ 统一字符编码
  ✅ 权限验证（登录状态检查）
  ✅ 日志记录

🔧 2. 快速入门案例：字符编码过滤器

步骤 1：实现 Filter 接口

import javax.servlet.*;
import java.io.IOException;

public class EncodingFilter implements Filter {
    @Override
    public void init(FilterConfig config) throws ServletException {
        // 初始化（仅执行一次）
    }

    @Override
    public void doFilter(ServletRequest req, ServletResponse res, 
                        FilterChain chain) throws IOException, ServletException {
        // 预处理：设置编码
        req.setCharacterEncoding("UTF-8");
        res.setContentType("text/html;charset=UTF-8");
        
        // 放行请求
        chain.doFilter(req, res);
        
        // 后处理（可选）
    }

    @Override
    public void destroy() {
        // 销毁（仅执行一次）
    }
}

步骤 2：配置 Filter（两种方式）

方式 1：注解配置（Servlet 3.0+）

@WebFilter(urlPatterns = "/*", initParams = {
    @WebInitParam(name = "encoding", value = "UTF-8")
})
public class EncodingFilter implements Filter { ... }

方式 2：web.xml 配置

<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>com.example.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>

🔧 3. 案例：权限验证过滤器

@WebFilter(urlPatterns = {"/admin/*"})
public class AuthFilter implements Filter {
    @Override
    public void doFilter(ServletRequest req, ServletResponse res, 
                        FilterChain chain) throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) res;
        
        // 检查 session 中是否有用户信息
        if (request.getSession().getAttribute("user") == null) {
            response.sendRedirect("/login.jsp"); // 未登录则跳转
            return;
        }
        
        chain.doFilter(req, res); // 放行请求
    }
}

四、监听器（Listener）详解

🔍 1. 核心概念

• 定义：
  Listener 用于监听Web 应用中的事件，如 ServletContext、Session、Request 的创建与销毁
• 三大类型：
  ✅ ServletContextListener：监听应用启动 / 停止
  ✅ HttpSessionListener：监听会话创建 / 销毁
  ✅ ServletRequestListener：监听请求创建 / 销毁

🔧 2. 案例：统计在线用户数

步骤 1：实现 HttpSessionListener

import javax.servlet.http.HttpSessionEvent;
import javax.servlet.http.HttpSessionListener;

public class OnlineUserListener implements HttpSessionListener {
    private static int onlineCount = 0;

    @Override
    public void sessionCreated(HttpSessionEvent se) {
        onlineCount++;
        System.out.println("新用户登录，在线人数：" + onlineCount);
    }

    @Override
    public void sessionDestroyed(HttpSessionEvent se) {
        onlineCount--;
        System.out.println("用户退出，在线人数：" + onlineCount);
    }
}

步骤 2：配置监听器（web.xml）

<listener>
    <listener-class>com.example.OnlineUserListener</listener-class>
</listener>

🔧 3. 案例：应用启动初始化数据

import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;

public class AppInitListener implements ServletContextListener {
    @Override
    public void contextInitialized(ServletContextEvent sce) {
        // 应用启动时加载配置文件
        System.out.println("应用启动，加载配置...");
    }

    @Override
    public void contextDestroyed(ServletContextEvent sce) {
        // 应用停止时释放资源
        System.out.println("应用停止，释放资源...");
    }
}

五、Filter 与 Listener 对比

特性	Filter	Listener
核心功能	拦截请求 / 响应	监听事件
触发时机	请求到达 Servlet 前后	事件发生时（如会话创建）
常用场景	编码处理、权限控制	统计、资源管理

六、课堂练习

练习 1：日志过滤器

任务：

1. 实现一个 Filter，记录所有请求的路径和时间
2. 格式：[2025-03-25 10:00:00] GET /user/list

练习 2：会话超时监听

任务：

1. 当会话超时时，输出提示信息
2. 在 web.xml 中设置会话超时时间为 1 分钟

七、课程总结

知识图谱：

Filter & Listener  
   ↳ Filter：预处理→放行→后处理（init→doFilter→destroy）  
   ↳ Listener：监听三大域的事件（Context/Session/Request）  
   ↳ 核心案例：编码统一、权限控制、在线人数统计  

口诀记忆：

“Filter 是拦截器，请求响应两边欺，
Listener 是监听者，事件触发不放过，
编码权限靠 Filter，统计监控找 Listener！”

八、课后作业

必做 1：敏感词过滤

要求：

1. 实现 Filter，将请求参数中的敏感词（如 “暴力”）替换为 “***”
2. 测试路径：/comment?content=暴力内容

必做 2：统计网站总访问量

任务：

1. 使用 ServletContextListener 记录总访问量
2. 在首页显示：您是第 1234 位访客