io.undertow.server.session

Interface SessionConfig

All Known Implementing Classes:

PathParameterSessionConfig, SessionCookieConfig, SslSessionConfig

public interface SessionConfig

Interface that abstracts the process of attaching a session to an exchange. This includes both the HTTP side of attachment such as setting a cookie, as well as actually attaching the session to the exchange for use by later handlers.

Generally this will just set a cookie.

Author:

Stuart Douglas

Method Summary

Methods

Modifier and Type	Method and Description
void	clearSession(HttpServerExchange exchange, String sessionId) Clears this session from the exchange, removing the attachment and making any changes to the response necessary, such as clearing cookies.
String	findSessionId(HttpServerExchange exchange) Retrieves a session id of an existing session from an exchange.
String	rewriteUrl(String originalUrl, String sessionId)
void	setSessionId(HttpServerExchange exchange, String sessionId) Attaches the session to the exchange.

Method Detail

setSessionId

void setSessionId(HttpServerExchange exchange,
                String sessionId)

Attaches the session to the exchange. The method should attach the exchange under an attachment key, and should also modify the exchange to allow the session to be re-attached on the next request.

Generally this will involve setting a cookie

Once a session has been attached it must be possible to retrieve it via findSessionId(io.undertow.server.HttpServerExchange)

Parameters:

exchange - The exchange

session - The session

clearSession

void clearSession(HttpServerExchange exchange,
                String sessionId)

Clears this session from the exchange, removing the attachment and making any changes to the response necessary, such as clearing cookies.

Parameters:

exchange - The exchange

session - The session

findSessionId

String findSessionId(HttpServerExchange exchange)

Retrieves a session id of an existing session from an exchange.

Parameters:

exchange - The exchange

Returns:

The session id, or null

rewriteUrl

String rewriteUrl(String originalUrl,
                String sessionId)