Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "Jetty/Howto/SessionIds"
(fix incorrect param name to change jsessionid url-rewriting) |
(fix incorrect param name to change jsessionid url-rewriting) |
||
Line 44: | Line 44: | ||
... | ... | ||
<context-param> | <context-param> | ||
− | <param-name>org. | + | <param-name>org.eclipse.jetty.servlet.SessionCookie</param-name> |
<param-value>XSESSIONID</param-value> | <param-value>XSESSIONID</param-value> | ||
</context-param> | </context-param> | ||
<context-param> | <context-param> | ||
− | <param-name>org. | + | <param-name>org.eclipse.jetty.servlet.SessionIdPathParameterName</param-name> |
<param-value>xsessionid</param-value> | <param-value>xsessionid</param-value> | ||
</context-param> | </context-param> | ||
Line 67: | Line 67: | ||
<Map> | <Map> | ||
<Entry> | <Entry> | ||
− | <Item>org. | + | <Item>org.eclipse.jetty.servlet.SessionCookie</Item> |
<Item>XSESSIONID</Item> | <Item>XSESSIONID</Item> | ||
</Entry> | </Entry> | ||
<Entry> | <Entry> | ||
− | <Item>org. | + | <Item>org.eclipse.jetty.servlet.SessionIdPathParameterName</Item> |
<Item>xsessionid</Item> | <Item>xsessionid</Item> | ||
</Entry> | </Entry> |
Revision as of 05:43, 27 September 2010
Introduction
The following configuration can be applied to modify the session characteristics of a web application:
Steps
Init Parameters
Context Parameter Name | Default Value | Description |
org.mortbay.jetty.servlet.SessionCookie | JSESSIONID | Session cookie name.efaults to JSESSIONID, but can be set for a particular webapp with this context param. |
org.eclipse.jetty.servlet.SessionIdPathParameterName | jsessionid | Session URL parameter name. Defaults to jsessionid, but can be set for a particular webapp with this context param. Set to "none" to disable URL rewriting. |
org.mortbay.jetty.servlet.SessionDomain | - | Session Domain. If this property is set as a ServletContext param, then it is used as the domain for session cookies.If it is not set, then no domain is specified for the session cookie. |
org.mortbay.jetty.servlet.SessionPath | - | Session Path. If this property is set as a ServletContext param, then it is used as the path for the session cookie. If it is not set, then the context path is used as the path for the cookie. |
org.mortbay.jetty.servlet.MaxAge | -1 | Session Max Age. If this property is set as a ServletContext param, then it is used as the max age for the session cookie. If it is not set, then a max age of -1 is used. |
Example
The above can either be set as <context-param>s in a web application's WEB-INF/web.xml file like so:
<?xml version="1.0" encoding="ISO-8859-1"?> <web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5"> ... <context-param> <param-name>org.eclipse.jetty.servlet.SessionCookie</param-name> <param-value>XSESSIONID</param-value> </context-param> <context-param> <param-name>org.eclipse.jetty.servlet.SessionIdPathParameterName</param-name> <param-value>xsessionid</param-value> </context-param> ... </web-app>
or, they can be set in a Jetty context xml file that configures a web application:
<Configure class="org.mortbay.jetty.webapp.WebAppContext"> <Set name="contextPath">/test</Set> <Set name="war"><SystemProperty name="jetty.home" default="."/>/webapps/test</Set> ... <Set name="initParams"> <Map> <Entry> <Item>org.eclipse.jetty.servlet.SessionCookie</Item> <Item>XSESSIONID</Item> </Entry> <Entry> <Item>org.eclipse.jetty.servlet.SessionIdPathParameterName</Item> <Item>xsessionid</Item> </Entry> </Map> </Set> </Configure>
Additional Resources
For more information, please see the Session Clustering tutorial.