Package io.undertow.server.session

Class SessionReferenceConfig

java.lang.Object

io.undertow.server.session.SessionReferenceConfig

All Implemented Interfaces:

SessionConfig

public class SessionReferenceConfig
extends Object
implements SessionConfig

A SessionConfig that references a specific session.

Author:

Paul Ferraro

Nested Class Summary

Nested classes/interfaces inherited from interface io.undertow.server.session.SessionConfig

SessionConfig.SessionCookieSource

Field Summary

Fields inherited from interface io.undertow.server.session.SessionConfig

ATTACHMENT_KEY

Constructor Summary

Constructors

Constructor	Description
SessionReferenceConfig(SessionReference reference)

Method Summary

Modifier and Type	Method	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)
SessionConfig.SessionCookieSource	sessionCookieSource(HttpServerExchange exchange)
void	setSessionId(HttpServerExchange exchange, String sessionId)	Attaches the session to the exchange.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

SessionReferenceConfig

public SessionReferenceConfig(SessionReference reference)

Method Details

setSessionId

public void setSessionId(HttpServerExchange exchange,
 String sessionId)

Description copied from interface: SessionConfig

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 SessionConfig.findSessionId(io.undertow.server.HttpServerExchange)

Specified by:

setSessionId in interface SessionConfig

Parameters:

exchange - The exchange

sessionId - The session

clearSession

public void clearSession(HttpServerExchange exchange,
 String sessionId)

Description copied from interface: SessionConfig

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

Specified by:

clearSession in interface SessionConfig

Parameters:

exchange - The exchange

sessionId - The session id

findSessionId

public String findSessionId(HttpServerExchange exchange)

Description copied from interface: SessionConfig

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

Specified by:

findSessionId in interface SessionConfig

Parameters:

exchange - The exchange

Returns:

The session id, or null

sessionCookieSource

public SessionConfig.SessionCookieSource sessionCookieSource(HttpServerExchange exchange)

Specified by:

sessionCookieSource in interface SessionConfig

rewriteUrl

public String rewriteUrl(String originalUrl,
 String sessionId)

Specified by:

rewriteUrl in interface SessionConfig