JavaEE中如何Hook BeginRequest与EndRequest请求生命周期事件

选型澄清 #

首先明确三个常见方案的适用边界，纠正资料中的错误表述：

• ServletContextListener 完全不相关：该组件仅监听Web应用启动、停止的全局生命周期事件，根本无法感知单个请求的处理流程，JavaEE 5教程中提到它可以接收请求通知属于文档错误。
• ServletRequestListener 能力不足：它虽然能在请求创建、销毁时触发事件，但无法获取Response对象，也不能干预请求/响应的处理流程，仅能读取Request的基础属性，没法实现读取响应状态码、修改响应内容这类需求，这也是你实现requestInitialized方法时无法继续推进的核心原因。
• Servlet Filter（过滤器）是ASP.NET IHttpModule的等价实现：它是JavaEE Servlet规范定义的标准组件，请求进入Web处理链路时最先经过Filter，响应返回客户端前最后经过Filter，两个阶段都可以自由操作Request、Response对象，还支持按URL路径配置拦截规则，完全覆盖IHttpModule的所有能力。

实现逻辑 #

Filter的执行流和IHttpModule的事件模型完全对应：

1. Web应用启动时，容器会初始化配置好的Filter，调用其init方法，等价于IHttpModule的Init生命周期。
2. 请求匹配拦截规则后，容器先执行Filter的doFilter方法，在调用filterChain.doFilter(request, response)之前的代码段，就是请求处理开始节点，对应BeginRequest事件。
3. 调用filterChain.doFilter后，请求会被传递给后续的过滤器、目标Servlet/接口执行业务逻辑。
4. 整个业务链路执行完成、响应提交给客户端之前，会回到doFilter方法中filterChain.doFilter之后的代码段，这就是请求处理结束节点，对应EndRequest事件。
5. Web应用卸载时，容器调用Filter的destroy方法完成资源回收。

可运行代码（适配Java 8 + JavaEE 8环境） #

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

// 全局拦截所有请求，等价于IHttpModule的全局注册
@WebFilter(filterName = "globalRequestHook", urlPatterns = "/*")
public class GlobalRequestHookFilter implements Filter {

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 应用启动时执行一次的初始化逻辑
    }

    @Override
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) throws IOException, ServletException {
        // ========== BeginRequest 节点：请求处理开始 ==========
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) resp;

        // 示例逻辑：记录请求开始时间、读取请求基础信息
        long startTs = System.currentTimeMillis();
        String requestMethod = request.getMethod();
        String requestPath = request.getRequestURI();
        String userAgent = request.getHeader("User-Agent");

        // 调用下一个组件，分割请求开始/结束两个节点
        chain.doFilter(request, response);

        // ========== EndRequest 节点：请求处理完成 ==========
        // 示例逻辑：计算请求耗时、读取响应状态码
        long costMs = System.currentTimeMillis() - startTs;
        int responseStatus = response.getStatus();
        
        // 可在此处追加响应头、修改响应内容（修改响应内容需配合HttpServletResponseWrapper缓存响应体）
    }

    @Override
    public void destroy() {
        // 应用卸载时执行的资源回收逻辑
    }
}

配置方式 #

两种配置方式二选一即可：

• 注解配置：Servlet 3.0及以上版本（JavaEE 8默认支持）直接使用代码中的@WebFilter注解即可，容器启动时会自动扫描注册，不需要额外修改配置文件。
• XML配置（兼容低版本、需要明确控制拦截顺序时使用），在web.xml中添加如下配置，逻辑和ASP.NET在web.config中注册模块一致：

<filter>
    <filter-name>globalRequestHook</filter-name>
    <filter-class>com.your.package.GlobalRequestHookFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>globalRequestHook</filter-name>
    <url-pattern>/*</url-pattern>
    <!-- 覆盖所有请求场景，避免转发、异步、错误页面漏拦截 -->
    <dispatcher>REQUEST</dispatcher>
    <dispatcher>FORWARD</dispatcher>
    <dispatcher>INCLUDE</dispatcher>
    <dispatcher>ASYNC</dispatcher>
    <dispatcher>ERROR</dispatcher>
</filter-mapping>

注意事项 #

• 如果需要在结束节点修改响应内容，不要直接操作原始Response的输出流：原始输出流一旦被业务逻辑写入就会提交，无法回溯修改。需要在BeginRequest阶段用自定义的HttpServletResponseWrapper实现类包装原始Response，把响应内容缓存到内存中，等结束节点修改完缓存内容后，再统一写回原始响应。
• 多Filter场景下，web.xml配置的Filter按filter-mapping的书写顺序从上到下执行请求阶段逻辑，逆序执行响应阶段逻辑；注解配置的Filter默认按类名字母序执行，Spring环境下可通过@Order注解显式指定执行顺序。
• ServletRequestListener仅适合不需要操作Response的轻量场景，比如全局请求计数、基础属性埋点，无法替代Filter实现完整的请求Hook能力。

内容的提问来源于stack exchange，提问作者Ian Boyd