【Java 进阶篇】Java Filter 执行流程及生命周期详解

在这里插入图片描述

引言

在 Java Web 开发中，Filter 是一种强大的组件，它允许我们在请求到达 Servlet 之前或者响应返回给客户端之前执行一些操作。Filter 的应用场景非常广泛，例如日志记录、权限验证、字符编码转换等。本文将深入讨论 Java Filter 的执行流程和生命周期，帮助读者更好地理解和使用 Filter。

Filter 是什么？

Filter 是 Java Web 应用中的一种组件，用于对 Servlet 请求或响应进行预处理或后处理。它可以在请求到达 Servlet 之前执行一些操作，也可以在响应返回给客户端之前执行一些操作。Filter 是基于 Java Servlet 规范的，它实现了 javax.servlet.Filter 接口。

Filter 的执行流程

Filter 的执行流程可以分为以下阶段：

初始化阶段（Initialization）：在容器启动时，Filter 会被初始化。在初始化阶段，Filter 可以读取配置参数，获取 FilterConfig 对象，并进行一些初始化的操作。
请求预处理阶段（Request Pre-processing）：在请求到达 Servlet 之前，Filter 可以对请求进行一些预处理操作，例如日志记录、权限验证等。
Servlet 的执行阶段（Servlet Execution）：请求会被传递给目标 Servlet 进行处理。
响应后处理阶段（Response Post-processing）：在 Servlet 处理完请求并生成响应之后，Filter 可以对响应进行一些后处理操作，例如添加响应头、修改响应内容等。
销毁阶段（Destruction）：在容器关闭时，Filter 会被销毁。在销毁阶段，Filter 可以执行一些清理操作，释放资源等。

下面我们将详细介绍每个阶段的执行流程和生命周期。

Filter 的生命周期

Filter 的生命周期包括初始化阶段、请求预处理阶段、Servlet 的执行阶段、响应后处理阶段和销毁阶段。

初始化阶段

在容器启动时，Filter 会被初始化。这个阶段的生命周期方法是 init(FilterConfig filterConfig)。在这个方法中，可以获取 FilterConfig 对象，通过它可以读取在 web.xml 中配置的初始化参数。

public class MyFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 在这里进行初始化操作，读取配置参数等
        String paramValue = filterConfig.getInitParameter("paramName");
        // ...
    }

    // 其他方法
}

请求预处理阶段

在请求到达 Servlet 之前，Filter 可以进行一些预处理操作。这个阶段的生命周期方法是 doFilter(ServletRequest request, ServletResponse response, FilterChain chain)。在这个方法中，可以对请求进行处理，也可以选择继续将请求传递给下一个 Filter 或目标 Servlet。

public class MyFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 在这里进行请求预处理操作
        // ...

        // 将请求传递给下一个 Filter 或目标 Servlet
        chain.doFilter(request, response);

        // 继续在这里进行请求后处理操作
        // ...
    }

    // 其他方法
}

Servlet 的执行阶段

在这个阶段，请求会被传递给目标 Servlet 进行处理。Filter 在这个阶段可以对请求进行拦截、修改或者增强。

响应后处理阶段

在目标 Servlet 处理完请求并生成响应之后，Filter 可以对响应进行一些后处理操作。这个阶段的生命周期方法同样是 doFilter(ServletRequest request, ServletResponse response, FilterChain chain)。

public class MyFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 在这里进行响应后处理操作
        // ...

        // 继续将响应传递给下一个 Filter 或客户端
        chain.doFilter(request, response);
    }

    // 其他方法
}

销毁阶段

在容器关闭时，Filter 会被销毁。这个阶段的生命周期方法是 destroy()。在这个方法中，可以进行一些清理操作，释放资源等。

public class MyFilter implements Filter {
    @Override
    public void destroy() {
        // 在这里进行销毁操作，释放资源等
        // ...
    }

    // 其他方法
}

示例：日志记录 Filter

下面通过一个简单的示例来说明 Filter 的使用，以一个日志记录的 Filter 为例。这个 Filter 会在请求到达 Servlet 之前记录请求信息，并在响应返回给客户端之前记录响应信息。

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

public class LogFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 初始化操作
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 记录请求信息
        log("Request received for " + request.getRemoteAddr());

        // 将请求传递给下一个 Filter 或目标 Servlet
        chain.doFilter(request, response);

        // 记录响应信息
        log("Response sent for " + request.getRemoteAddr());
    }

    @Override
    public void destroy() {
        // 销毁操作
    }

    // 记录日志的方法
    private void log(String message) {
        System.out.println(message);
    }
}