如何从Vert.x context.request()获取javax.servlet.http.HttpServletRequest？

Vert.x的HttpServerRequest与Servlet规范的HttpServletRequest属于完全独立的API体系，二者没有继承或实现关系，因此直接强转必然失败，也无法通过@Context直接注入（@Context是JAX-RS注解，Vert.x的JAX-RS集成默认不会自动转换为Servlet请求对象）。针对你的场景（第三方Jar仅操作请求头、不想重写Jar），推荐两种可行方案：

方案一：手动实现HttpServletRequest适配器 #

因为第三方Jar仅需要操作请求头，我们可以只实现HttpServletRequest中与请求头相关的核心方法，其他非必要方法按需抛出异常或返回默认值，轻量适配Vert.x请求。

适配器代码示例 #

import io.vertx.ext.web.HttpServerRequest;
import javax.servlet.http.HttpServletRequest;
import java.util.Enumeration;
import java.util.HashSet;
import java.util.Set;

public class VertxServletRequestAdapter implements HttpServletRequest {
    private final HttpServerRequest vertxRequest;

    public VertxServletRequestAdapter(HttpServerRequest vertxRequest) {
        this.vertxRequest = vertxRequest;
    }

    // 第三方Jar需要的请求头方法
    @Override
    public String getHeader(String name) {
        return vertxRequest.getHeader(name);
    }

    @Override
    public Enumeration<String> getHeaders(String name) {
        return vertxRequest.headers().getAll(name).elements();
    }

    @Override
    public Enumeration<String> getHeaderNames() {
        Set<String> headerNames = new HashSet<>(vertxRequest.headers().names());
        return headerNames.elements();
    }

    // 按需实现其他必要方法（比如请求方法、URI）
    @Override
    public String getMethod() {
        return vertxRequest.method().name();
    }

    @Override
    public String getRequestURI() {
        return vertxRequest.uri();
    }

    // 非必要方法抛出UnsupportedOperationException
    @Override
    public String getProtocol() {
        throw new UnsupportedOperationException("该方法未实现");
    }

    @Override
    public String getScheme() {
        throw new UnsupportedOperationException("该方法未实现");
    }

    // 剩余HttpServletRequest方法可按需补充或抛出异常
}

使用方式 #

// 从Vert.x Context获取请求
HttpServerRequest vertxRequest = context.request();
// 包装为HttpServletRequest
HttpServletRequest servletRequest = new VertxServletRequestAdapter(vertxRequest);
// 传给第三方Jar
thirdPartyService.processRequest(servletRequest);

方案二：使用Vert.x Web Servlet桥接器 #

如果第三方Jar需要更多Servlet规范的功能（不止请求头），可以使用Vertx官方提供的vertx-web-servlet模块，将Vert.x请求桥接为标准Servlet请求，底层依赖Jetty容器。

步骤1：引入依赖（Maven） #

<dependency>
    <groupId>io.vertx</groupId>
    <artifactId>vertx-web-servlet</artifactId>
    <version>你的Vert.x版本</version>
</dependency>
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>4.0.1</version>
    <scope>provided</scope>
</dependency>

步骤2：封装第三方逻辑为Servlet #

import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

@WebServlet("/third-party/*")
public class ThirdPartyProxyServlet extends HttpServlet {
    @Override
    protected void service(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        // 调用第三方Jar的处理逻辑
        thirdPartyService.processRequest(req);
        resp.setStatus(200);
    }
}

步骤3：在Vert.x中部署Servlet桥接器 #

import io.vertx.core.Vertx;
import io.vertx.ext.web.servlet.VertxServletHandler;
import org.eclipse.jetty.servlet.ServletContextHandler;
import org.eclipse.jetty.servlet.ServletHolder;

public class VertxServletBridge {
    public static void main(String[] args) {
        Vertx vertx = Vertx.vertx();
        
        // 创建Jetty Servlet上下文
        ServletContextHandler servletContext = new ServletContextHandler(ServletContextHandler.SESSIONS);
        servletContext.setContextPath("/");
        // 注册第三方代理Servlet
        servletContext.addServlet(new ServletHolder(new ThirdPartyProxyServlet()), "/third-party/*");
        
        // 创建Vertx与Servlet的桥接处理器
        VertxServletHandler handler = VertxServletHandler.create(vertx, servletContext);
        
        // 启动Vertx HTTP服务器，将请求转发给桥接处理器
        vertx.createHttpServer().requestHandler(handler).listen(8080);
    }
}

方案对比 #

• 手动适配器：轻量、无额外依赖，适合仅需请求头等少量Servlet功能的场景，代码可控性高。
• Servlet桥接器：完整兼容Servlet规范，适合第三方Jar依赖更多Servlet特性的场景，但引入Jetty依赖，部署复杂度稍高。

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