Jetty 9升级至12：兼容EE8/9/10的HandlerWrapper替代方案咨询

核心替代方案：使用Jetty 12原生HandlerWrapper #

Jetty 12重构了Handler体系，但保留了org.eclipse.jetty.server.handler.HandlerWrapper作为核心抽象类，功能与旧版一致，用于包装目标Handler并拦截请求流程，且不绑定特定EE版本，适合跨版本兼容。

代码示例 #

import org.eclipse.jetty.server.Request;
import org.eclipse.jetty.server.Response;
import org.eclipse.jetty.server.handler.HandlerWrapper;
import jakarta.servlet.ServletException;
import java.io.IOException;

public class InfoHandler extends HandlerWrapper {
    @Override
    public void handle(Request request, Response response) throws IOException, ServletException {
        // 请求处理前的自定义逻辑
        preHandle(request, response);
        
        // 调用被包装的目标Handler
        super.handle(request, response);
        
        // 请求处理后的自定义逻辑
        postHandle(request, response);
    }
    
    private void preHandle(Request request, Response response) {
        // 示例：记录请求路径信息
        System.out.println("Received request path: " + request.getPathInfo());
    }
    
    private void postHandle(Request request, Response response) {
        // 示例：记录响应状态码
        System.out.println("Response status code: " + response.getStatus());
    }
}

跨EE版本兼容配置 #

通过构建工具的依赖管理，可快速切换EE版本适配层，实现同时支持EE8、EE9、EE10：

Maven配置示例 #

用Maven属性控制EE版本，对应引入Jetty的EE适配模块：

<properties>
    <!-- 可切换版本：4.0.4(EE8) / 5.0.0(EE9) / 6.0.0(EE10) -->
    <jakarta.servlet.version>6.0.0</jakarta.servlet.version>
    <jetty.version>12.0.7</jetty.version>
</properties>

<dependencies>
    <!-- Jetty核心依赖 -->
    <dependency>
        <groupId>org.eclipse.jetty</groupId>
        <artifactId>jetty-server</artifactId>
        <version>${jetty.version}</version>
    </dependency>
    
    <!-- 对应EE版本的适配模块，切换EE版本时替换为jetty-ee8/jetty-ee9 -->
    <dependency>
        <groupId>org.eclipse.jetty</groupId>
        <artifactId>jetty-ee10</artifactId>
        <version>${jetty.version}</version>
    </dependency>
    
    <!-- Servlet API依赖，自动适配对应EE版本 -->
    <dependency>
        <groupId>jakarta.servlet</groupId>
        <artifactId>jakarta.servlet-api</artifactId>
        <version>${jakarta.servlet.version}</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

备选方案：使用Servlet Filter（跨EE规范兼容） #

如果业务逻辑更贴近Servlet规范，可改用Filter实现拦截逻辑。Jetty的EE适配模块会自动处理EE8（javax.servlet）与EE9/10（jakarta.servlet）的包名差异，无需修改代码：

兼容版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 InfoFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 初始化逻辑
    }
    
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        // 请求拦截前逻辑
        System.out.println("Filter pre-handle: " + request.getRemoteAddr());
        
        chain.doFilter(request, response);
        
        // 请求拦截后逻辑
        System.out.println("Filter post-handle: " + response.getContentType());
    }
    
    @Override
    public void destroy() {
        // 销毁逻辑
    }
}

关键注意事项 #

• Jetty 12的Request、Response类属于核心API，无需依赖EE特定包，跨版本通用。
• 兼容EE8时，引入jetty-ee8模块即可自动完成jakarta.servlet到javax.servlet的桥接，无需修改代码包名。
• 避免直接依赖旧版Jetty的嵌套包（如org.eclipse.jetty.servlet），统一使用核心API或对应EE适配模块。

内容的提问来源于stack exchange，提问作者yusen zhang