Undertow Documentation

Undertow is a high-performance Java web server built on non-blocking IO. It provides three primary components:

• Core HTTP Server: Supports both blocking and non-blocking IO.
• Servlet Implementation: Supports Servlet 4.0, 5.0, and 6.0 specifications.
• WebSocket Implementation: JSR-356/Jakarta 2.0 compliant.

For more information, visit the official website at http://undertow.io.

Undertow benchmarks are implemented using the JMH harness. To run them, you must first build the project using Maven and then execute the generated benchmark JAR file.

mvn install
java -jar benchmarks/target/undertow-benchmarks.jar

The AuthenticatedSessionManager interface is used to manage persistent authenticated user sessions within an Undertow HttpServerExchange.

To access the manager associated with a specific exchange, use the ATTACHMENT_KEY constant. This allows you to retrieve or attach a manager to the exchange's attachments.

Key methods:

• lookupSession(HttpServerExchange exchange): Retrieves the current AuthenticatedSession associated with the provided exchange.
• clearSession(HttpServerExchange exchange): Clears/invalidates the authenticated session for the provided exchange.

The AuthenticatedSession class represents a persistent authenticated session. It contains the user's Account and the authentication mechanism used to establish the session.

Methods:

• getAccount(): Returns the Account associated with the session.
• getMechanism(): Returns the String representing the authentication mechanism.