com.guiseframework.platform.web
Class HTTPServletGuiseSessionManager

java.lang.Object
  com.guiseframework.platform.web.HTTPServletGuiseSessionManager

public class HTTPServletGuiseSessionManager
extends java.lang.Object

Manages Guise sessions for an HTTP web application. Guise sessions are created and released in conjunction with associated HTTP servlet sessions. There may be multiple Guise applications within one web application.

A HTTP request may override any HTTP session identified by the request by exlicitly identifying the Guise session UUID using the WebPlatform.GUISE_SESSION_UUID_URI_QUERY_PARAMETER parameter.

Author:

Garret Wilson

See Also:

HTTPServletGuiseContainer

Constructor Summary

HTTPServletGuiseSessionManager()

Method Summary

protected static GuiseSession	getGuiseSession(HTTPServletGuiseContainer guiseContainer, GuiseApplication guiseApplication, HttpServletRequest httpRequest) Retrieves a session for the given HTTP request, creating a session if necessary.
protected static GuiseSession	getGuiseSession(HTTPServletGuiseContainer guiseContainer, GuiseApplication guiseApplication, HttpServletRequest httpRequest, boolean createSession) Retrieves a session for the given HTTP request.
void	sessionCreated(HttpSessionEvent httpSessionEvent) Called when an HTTP session is created.
void	sessionDestroyed(HttpSessionEvent httpSessionEvent) Called when an HTTP session is invalidated.

Methods inherited from class java.lang.Object

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

Constructor Detail

HTTPServletGuiseSessionManager

public HTTPServletGuiseSessionManager()

Method Detail

getGuiseSession

protected static GuiseSession getGuiseSession(HTTPServletGuiseContainer guiseContainer,
                                              GuiseApplication guiseApplication,
                                              HttpServletRequest httpRequest)

Retrieves a session for the given HTTP request, creating a session if necessary. If a WebPlatform.GUISE_SESSION_UUID_URI_QUERY_PARAMETER parameter is present in the HTTP request, it will be used to directly look up a Guise session, ignoring any identified HTTP session. If there is no Guise session matching a specified UUID, the Guise session will be retrieved normally.

Parameters:

guiseContainer - The Guise container that owns the application.

guiseApplication - The application to install to own the created session..

httpRequest - The HTTP request with which the Guise session is to be associated.

Returns:

The Guise session associated with the provided HTTP session.

Throws:

java.lang.IllegalArgumentException - if the provided HTTP session is not a session from this web application or the HTTP session has been invalidated, and there is therefore no corresponding Guise session.

getGuiseSession

protected static GuiseSession getGuiseSession(HTTPServletGuiseContainer guiseContainer,
                                              GuiseApplication guiseApplication,
                                              HttpServletRequest httpRequest,
                                              boolean createSession)

Retrieves a session for the given HTTP request. If a WebPlatform.GUISE_SESSION_UUID_URI_QUERY_PARAMETER parameter is present in the HTTP request, it will be used to directly look up a Guise session, ignoring any identified HTTP session. If there is no Guise session matching a specified UUID, the Guise session will be retrieved normally.

Parameters:

guiseContainer - The Guise container that owns the application.

guiseApplication - The application to install to own the created session..

httpRequest - The HTTP request with which the Guise session is to be associated.

createSession - Whether a Guise session should be created if one does not already exist.

Returns:

The Guise session associated with the provided HTTP request, or null if there is no Guise session and session creation was not requested.

Throws:

java.lang.IllegalArgumentException - if the provided HTTP session is not a session from this web application or the HTTP session has been invalidated, and there is therefore no corresponding Guise session.

sessionCreated

public void sessionCreated(HttpSessionEvent httpSessionEvent)

Called when an HTTP session is created. This implementation does nothing, as there is no way to tell with which Guise container and Guise application application a new Guise application should be associated.

Parameters:

httpSessionEvent - Information regarding the created HTTP session.

See Also:

getGuiseSession(HTTPServletGuiseContainer, GuiseApplication, HttpServletRequest)

sessionDestroyed

public void sessionDestroyed(HttpSessionEvent httpSessionEvent)

Called when an HTTP session is invalidated. This implementation removes the corresponding Guise session.

Parameters:

httpSessionEvent - Information regarding the invalidated HTTP session.