JavaWeb开发基础知识-Filter终极入门指南（曼波萌新版）

🌈 第①章什么是Filter？

@WebFilter("/*") // 拦截所有请求！
public class LogFilter implements Filter {
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) {
        System.out.println("🔔 请求进入：" + new Date());
        chain.doFilter(request, response); // 必须放行！
        System.out.println("🔔 响应返回：" + new Date());
    }
}

官方定义：可复用的请求拦截组件
核心作用：
✅ 预处理请求（安全检查）
✅ 后处理响应（数据加工）
✅ 拦截/放行请求（权限控制）
生活比喻：地铁安检（检查包裹→放行→处理异常）

🛠️ 第②章快速创建第一个Filter

步骤1：实现Filter接口

@WebFilter("/*") // 拦截所有请求！
public class LogFilter implements Filter {
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) {
        System.out.println("🔔 请求进入：" + new Date());
        chain.doFilter(request, response); // 必须放行！
        System.out.println("🔔 响应返回：" + new Date());
    }
}

步骤2：配置web.xml（传统方式）

<filter>
    <filter-name>myFilter</filter-name>
    <filter-class>com.mambo.MyFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>myFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

🔄 第③章 Filter生命周期

初始化：init() → 容器启动时调用一次
过滤处理：doFilter() → 每次匹配请求都调用
销毁：destroy() → 容器关闭时调用

📮 第④章核心应用场景

场景1：统一编码处理

public void doFilter(...) {
    request.setCharacterEncoding("UTF-8");
    response.setContentType("text/html;charset=UTF-8");
    chain.doFilter(request, response); // 先设置编码再放行
}

场景2：权限验证

public void doFilter(...) {
    HttpServletRequest req = (HttpServletRequest) request;
    HttpSession session = req.getSession();
    
    if(session.getAttribute("user") == null) {
        response.sendRedirect("/login.html");
        return; // 拦截请求
    }
    chain.doFilter(request, response); // 已登录则放行
}

场景3：请求日志记录

public void doFilter(...) {
    long start = System.currentTimeMillis();
    chain.doFilter(request, response); // 先放行
    long cost = System.currentTimeMillis() - start;
    
    String uri = ((HttpServletRequest)request).getRequestURI();
    System.out.println(uri + " 耗时：" + cost + "ms");
}

🔗 第⑤章过滤器链执行顺序

graph LR
    A[请求] --> B[Filter1]
    B --> C[Filter2]
    C --> D[Servlet]
    D --> C[后处理2]
    C --> B[后处理1]
    B --> A[响应]

执行规则：
✅ web.xml按<filter-mapping>顺序执行
✅ 注解方式按类名字母序执行
✅ 后处理按相反顺序执行

💡 第⑥章高级技巧

1. 排除特定请求

@WebFilter(urlPatterns = {"/*"}, 
           servletNames = {"myServlet"},
           dispatcherTypes = {DispatcherType.REQUEST})

2. 修改响应内容

public void doFilter(...) {
    // 包装原始response
    ResponseWrapper wrapper = new ResponseWrapper((HttpServletResponse)response);
    chain.doFilter(request, wrapper);
    
    // 修改响应内容
    String content = wrapper.getContent();
    content += "<hr/>页面脚注";
    response.getWriter().write(content);
}

3. 动态启用/禁用

@WebFilter(urlPatterns = "/*", 
           initParams = @WebInitParam(name = "active", value = "true"))
public class SwitchFilter implements Filter {
    private boolean isActive;
    
    public void init(FilterConfig config) {
        isActive = Boolean.parseBoolean(config.getInitParameter("active"));
    }
    
    public void doFilter(...) {
        if(!isActive) {
            chain.doFilter(request, response);
            return;
        }
        // 执行过滤逻辑...
    }
}

🚨 第⑦章常见问题解答

Q1：Filter和Servlet有什么区别？

	Filter 🛡️	Servlet 🛠️
作用阶段	请求前/响应后	请求处理阶段
数量	可多个链式执行	通常单例
功能	预处理/后处理	业务逻辑处理

Q2：如何跳过静态资源？

@WebFilter("/*")
public class ResourceFilter implements Filter {
    public void doFilter(...) {
        String path = ((HttpServletRequest)request).getRequestURI();
        if(path.startsWith("/static/")) {
            chain.doFilter(request, response); // 直接放行
            return;
        }
        // 其他请求处理逻辑...
    }
}

Q3：Filter能处理异常吗？

public void doFilter(...) {
    try {
        chain.doFilter(request, response);
    } catch (Exception e) {
        // 统一异常处理
        response.sendRedirect("/error.html");
    }
}