| Handler for creating browser sessions using cookies.
This handler provides a single cookie-id that may be used by
other handlers.
The intent is to require only one cookie per server.
(See also
sunlabs.brazil.filter.SessionFilter , which
manages sessions with or without cookies).
The following server properties are used:
- prefix
- url prefix
- cookie
- the name of the cookie to use (defaults to "cookie").
-
map
- If specified, the
ident argument to
SessionManager.getSession to get the table of valid
cookies, used to map the cookie value to a Session ID. By default,
the Session ID stored in the request is the cookie value itself.
-
exist
- If specified, this means that the Session ID corresponding to the
cookie value must already exist in the
SessionManager.
Normally, if the cookie was not present, a new cookie is
automatically created.
- persist
- If set, cookies persist across browser sessions
-
session
- The name of the request property that the Session ID will be stored
in, to be passed to downstream handler. The default value is
"SessionID".
If a cookie was returned from the browser, the property:
gotCookie is set to the cookie name. Otherwise it is left unset.
author:
Stephen Uhler
version:
1.12, 00/12/11 |
