Is there a way to use the Servlet API with Undertow?

Question

I'm just discovering how Undertow works and I was surprised by its api:

Undertow server = Undertow.builder()
                .addHttpListener(8080, "localhost")
                .setHandler(new HttpHandler() {
                    @Override
                    public void handleRequest(final HttpServerExchange exchange) throws Exception {
                        exchange.getResponseHeaders().put(Headers.CONTENT_TYPE, "text/plain");
                        exchange.getResponseSender().send("Hello World");
                    }
                }).build();
        server.start();

Is there a way to use the more convenient servlet api like this somehow?

Undertow server = Undertow.builder()
                .addHttpListener(8080, "localhost")
                .setHandler(new HttpHandler() {
                    @Override
                    public void handleRequest(final HttpServletRequest request, final HttpServletResponse response) throws Exception {
                        // ...
                    }
                }).build();
        server.start();

What I'm trying to achieve is to replace the currently working Jetty container which uses the servlet api by Undertow but after reading the docs and the source I can't seem to find a way to do so. I'm not using .war files just an embedded Jetty. Do someone has any pointers?

"Creating a Servlet Deployment" in http://undertow.io/undertow-docs/undertow-docs-1.3.0/index.html#undertow-servlet ? — BalusC, Feb 08 '16 at 12:35
As I've said I don't have .war files, I just want to integrate Undertow into an existing framework (spark web framework) which uses the servlet api classes (request and response). — Adam Arold, Feb 08 '16 at 13:53
Uh, where does it say you need a .war file? "deployment name" != "physical war file". — BalusC, Feb 08 '16 at 14:03
Be aware of the role / scope / requirements of the ServletContext in a servlet environment, then all of the documentation will start to make sense. — Joakim Erdfelt, Feb 08 '16 at 14:09

score 8 · Accepted Answer · answered Feb 08 '16 at 14:28

It's documented in section Creating a Servlet Deployment. Here's a MCVE based on the documentation provided that you've the dependencies right, along with the Servlet API.

package com.stackoverflow.q35269763;

import io.undertow.Handlers;
import io.undertow.Undertow;
import io.undertow.server.handlers.PathHandler;
import io.undertow.servlet.Servlets;
import io.undertow.servlet.api.DeploymentInfo;
import io.undertow.servlet.api.DeploymentManager;

import java.io.IOException;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class Test {

    public static void main(String... args) throws Exception {
        DeploymentInfo servletBuilder = Servlets.deployment().setClassLoader(Test.class.getClassLoader())
            .setDeploymentName("myapp").setContextPath("/myapp")
            .addServlets(Servlets.servlet("myservlet",
                new HttpServlet() {
                    @Override
                    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
                        response.getWriter().write("Hello World!");
                    }
                }.getClass()).addMapping("/myservlet"));
        DeploymentManager manager = Servlets.defaultContainer().addDeployment(servletBuilder);
        manager.deploy();
        PathHandler path = Handlers.path(Handlers.redirect("/myapp")).addPrefixPath("/myapp", manager.start());
        Undertow server = Undertow.builder().addHttpListener(8888, "localhost").setHandler(path).build();
        server.start();
    }

}

When you open http://localhost:8888/myapp/myservlet in your favourite webbrowser after copy'n'paste'n'running the above code, you'll see

Hello World!

Is there a way to use the Servlet API with Undertow?

1 Answers1