Module org.apache.wicket.core

Package org.apache.wicket.protocol.http

Class WebSession

java.lang.Object

org.apache.wicket.Session

org.apache.wicket.protocol.http.WebSession

All Implemented Interfaces:

Serializable, IEventSink, IFeedbackContributor, IMetadataContext<Serializable,Session>, IClusterable

Direct Known Subclasses:

AbstractAuthenticatedWebSession

public class WebSession
extends Session

A session subclass for the HTTP protocol.

Author:

Jonathan Locke

See Also:

• Serialized Form

Field Summary

Fields inherited from class org.apache.wicket.Session

clientInfo, SESSION_ATTRIBUTE_NAME

Constructor Summary

Constructors

Constructor	Description
WebSession(Request request)	Constructor.

Method Summary

Modifier and Type	Method	Description
protected String	generateNewSessionId()	Change the id of the underlying (Web)Session.
static WebSession	get()
WebClientInfo	getClientInfo()	Gets the client info object for this session.
void	invalidate()	Call signOut() and remove the logon data from whereever they have been persisted (e.g.
protected WebPage	newBrowserInfoPage()	Override this method if you want to use a custom page for gathering the client's browser information. The easiest way is just to extend BrowserInfoPage and provide your own markup file

Methods inherited from class org.apache.wicket.Session

bind, changeSessionId, clear, debug, detach, dirty, dirty, endRequest, error, exists, fatal, getApplication, getAttribute, getAttributeNames, getAuthorizationStrategy, getClassResolver, getFeedbackMessages, getId, getLocale, getMetaData, getPageFactory, getPageManager, getSessionStore, getSizeInBytes, getStyle, info, internalDetach, invalidateNow, isRtlLanguage, isRtlLocale, isSessionInvalidated, isTemporary, newPageAccessSynchronizer, nextPageId, nextSequenceValue, onEvent, onInvalidate, removeAttribute, replaceSession, setAttribute, setClientInfo, setLocale, setMetaData, setStyle, success, warn

Methods inherited from class java.lang.Object

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

Constructor Details

WebSession

public WebSession(Request request)

Constructor. Note that RequestCycle is not available until this constructor returns.

Parameters:

request - The current request

Method Details

get

public static WebSession get()

invalidate

public void invalidate()

Call signOut() and remove the logon data from whereever they have been persisted (e.g. Cookies)

Overrides:

invalidate in class Session

See Also:

• Session.invalidate()

getClientInfo

public WebClientInfo getClientInfo()

Gets the client info object for this session. This method lazily gets the new agent info object for this session. It uses any cached or set (Session.setClientInfo(ClientInfo)) client info object.

To gather the client information this implementation redirects temporarily to a special page (BrowserInfoPage).

Note: Do not call this method from your custom Session constructor because the temporary page needs a constructed Session to be able to work.

If you need to set a default client info property then better use Session.setClientInfo(org.apache.wicket.core.request.ClientInfo) directly.

Specified by:

getClientInfo in class Session

Returns:

the client info object based on this request

newBrowserInfoPage

protected WebPage newBrowserInfoPage()

Override this method if you want to use a custom page for gathering the client's browser information.
The easiest way is just to extend BrowserInfoPage and provide your own markup file

Returns:

the WebPage which should be used while gathering browser info

generateNewSessionId

protected String generateNewSessionId()

Description copied from class: Session

Change the id of the underlying (Web)Session.

Specified by:

generateNewSessionId in class Session

Returns:

the new session id value.