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/Persisting Sessions"
(7 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
{{Jetty Howto | {{Jetty Howto | ||
| introduction = | | introduction = | ||
− | |||
− | | | + | {{Jetty Redirect|http://www.eclipse.org/jetty/documentation/current/using-persistent-sessions.html}} |
− | + | ||
− | A SessionManager does just what | + | It is sometimes useful to preserve existing Sessions across restarts of Jetty. The [http://download.eclipse.org/jetty/stable-7/apidocs/org/eclipse/jetty/server/session/HashSessionManager.html HashSessionManager] supports this feature. If you enable persistence, the HashSessionManager saves all existing, valid Sessions to disk before shutdown completes. On restart, Jetty restores the saved Sessions. |
+ | |||
+ | ==Enabling Persistence== | ||
+ | |||
+ | A SessionManager does just what its name suggests–it manages the lifecycle and state of Sessions on behalf of a webapp. Each webapp must have its own unique SessionManager instance. Enabling persistence is as simple as configuring the HashSessionManager as the SessionManager for a webapp and telling it where on disk to store the sessions: | ||
<source lang="xml"> | <source lang="xml"> | ||
− | <Configure class="org. | + | <Configure class="org.eclipse.jetty.webapp.WebAppContext"> |
. | . | ||
. | . | ||
. | . | ||
<Set name="sessionHandler"> | <Set name="sessionHandler"> | ||
− | <New class="org. | + | <New class="org.eclipse.jetty.server.session.SessionHandler"> |
<Arg> | <Arg> | ||
− | <New class="org. | + | <New class="org.eclipse.jetty.server.session.HashSessionManager"> |
<Set name="storeDirectory">your/chosen/directory/goes/here</Set> | <Set name="storeDirectory">your/chosen/directory/goes/here</Set> | ||
</New> | </New> | ||
Line 28: | Line 30: | ||
</source> | </source> | ||
− | {{tip|Reminder| | + | {{tip|Reminder|If you want to persist the sessions from multiple webapps: |
+ | # Configure a separate HashSessionManager for each. | ||
+ | # Assign to each a different value for ''storeDirectory''.}} | ||
− | The above example uses a configuration file suitable for the | + | The above example uses a configuration file suitable for the [http://download.eclipse.org/jetty/stable-7/apidocs/org/eclipse/jetty/deploy/providers/ContextProvider.html ContextProvider], thus you might want to check out the [[Jetty/Feature/ContextDeployer|Context Provider]] feature guide. |
− | + | ==Delaying Session Load== | |
− | + | You might need to ensure that the sessions are loaded AFTER the servlet environment starts up (by default, Jetty eagerly loads sessions as part of the container startup, but before it initializes the servlet environment). For example, the Wicket web framework requires the servlet environment to be available when sessions are activated. | |
− | Using <tt>SessionManager.setLazyLoad(true)</tt>, sessions | + | Using <tt>SessionManager.setLazyLoad(true)</tt>, Jetty loads sessions lazily either when it receives the first request for a session, or the session scavenger runs for the first time, whichever happens first. Here's how the configuration looks in XML: |
<source lang="xml"> | <source lang="xml"> | ||
<Set name="sessionHandler"> | <Set name="sessionHandler"> | ||
− | <New class="org. | + | <New class="org.eclipse.jetty.servlet.SessionHandler"> |
<Arg> | <Arg> | ||
− | <New class="org. | + | <New class="org.eclipse.jetty.servlet.HashSessionManager"> |
<Set name="lazyLoad">true</Set> | <Set name="lazyLoad">true</Set> | ||
</New> | </New> | ||
Line 50: | Line 54: | ||
</source> | </source> | ||
− | ===Enabling Persistence for the | + | ===Enabling Persistence for the Jetty Maven Plugin=== |
− | To enable session persistence for the | + | To enable session persistence for the Jetty Maven plugin, set up the HashSessionManager in the <configuration> section like so: |
<source lang="xml"> | <source lang="xml"> | ||
<plugin> | <plugin> | ||
<groupId>org.mortbay.jetty</groupId> | <groupId>org.mortbay.jetty</groupId> | ||
− | <artifactId> | + | <artifactId>jetty-maven-plugin</artifactId> |
− | <version> | + | <version>7.4.3.v20110701</version> |
<configuration> | <configuration> | ||
− | < | + | <!-- ... --> |
− | <webAppConfig implementation="org.mortbay.jetty.plugin. | + | <webAppConfig implementation="org.mortbay.jetty.plugin.JettyWebAppContext"> |
− | < | + | <defaultsDescriptor>${project.build.outputDirectory}/META-INF/webdefault.xml</defaultsDescriptor> |
− | . | + | <contextPath>${jetty.contextRoot}</contextPath> |
− | + | <sessionHandler implementation="org.eclipse.jetty.server.session.SessionHandler"> | |
− | + | <sessionManager implementation="org.eclipse.jetty.server.session.HashSessionManager"> | |
− | <sessionHandler implementation="org. | + | <storeDirectory>${basedir}/target/jetty-sessions</storeDirectory> |
− | <sessionManager implementation="org. | + | <idleSavePeriod>1</idleSavePeriod> |
− | <storeDirectory>${basedir}/target/ | + | |
</sessionManager> | </sessionManager> | ||
</sessionHandler> | </sessionHandler> | ||
− | |||
− | |||
− | |||
</webAppConfig> | </webAppConfig> | ||
+ | <!-- ... --> | ||
</configuration> | </configuration> | ||
</plugin> | </plugin> | ||
</source> | </source> | ||
+ | | more = | ||
+ | For more information, see the [[Jetty/Tutorial/Session Clustering|Session Clustering]] tutorial. | ||
}} | }} |
Latest revision as of 14:44, 23 April 2013
Contents
Introduction
It is sometimes useful to preserve existing Sessions across restarts of Jetty. The HashSessionManager supports this feature. If you enable persistence, the HashSessionManager saves all existing, valid Sessions to disk before shutdown completes. On restart, Jetty restores the saved Sessions.
Enabling Persistence
A SessionManager does just what its name suggests–it manages the lifecycle and state of Sessions on behalf of a webapp. Each webapp must have its own unique SessionManager instance. Enabling persistence is as simple as configuring the HashSessionManager as the SessionManager for a webapp and telling it where on disk to store the sessions:
<Configure class="org.eclipse.jetty.webapp.WebAppContext"> . . . <Set name="sessionHandler"> <New class="org.eclipse.jetty.server.session.SessionHandler"> <Arg> <New class="org.eclipse.jetty.server.session.HashSessionManager"> <Set name="storeDirectory">your/chosen/directory/goes/here</Set> </New> </Arg> </New> </Set> . . . </Configure>
The above example uses a configuration file suitable for the ContextProvider, thus you might want to check out the Context Provider feature guide.
Delaying Session Load
You might need to ensure that the sessions are loaded AFTER the servlet environment starts up (by default, Jetty eagerly loads sessions as part of the container startup, but before it initializes the servlet environment). For example, the Wicket web framework requires the servlet environment to be available when sessions are activated.
Using SessionManager.setLazyLoad(true), Jetty loads sessions lazily either when it receives the first request for a session, or the session scavenger runs for the first time, whichever happens first. Here's how the configuration looks in XML:
<Set name="sessionHandler"> <New class="org.eclipse.jetty.servlet.SessionHandler"> <Arg> <New class="org.eclipse.jetty.servlet.HashSessionManager"> <Set name="lazyLoad">true</Set> </New> </Arg> </New> </Set>
Enabling Persistence for the Jetty Maven Plugin
To enable session persistence for the Jetty Maven plugin, set up the HashSessionManager in the <configuration> section like so:
<plugin> <groupId>org.mortbay.jetty</groupId> <artifactId>jetty-maven-plugin</artifactId> <version>7.4.3.v20110701</version> <configuration> <!-- ... --> <webAppConfig implementation="org.mortbay.jetty.plugin.JettyWebAppContext"> <defaultsDescriptor>${project.build.outputDirectory}/META-INF/webdefault.xml</defaultsDescriptor> <contextPath>${jetty.contextRoot}</contextPath> <sessionHandler implementation="org.eclipse.jetty.server.session.SessionHandler"> <sessionManager implementation="org.eclipse.jetty.server.session.HashSessionManager"> <storeDirectory>${basedir}/target/jetty-sessions</storeDirectory> <idleSavePeriod>1</idleSavePeriod> </sessionManager> </sessionHandler> </webAppConfig> <!-- ... --> </configuration> </plugin>
Additional Resources
For more information, see the Session Clustering tutorial.