This is most appropriate if the application needs user sessions anyway, - * that is, when the HttpSession does not have to be created for the locale. - * The session may optionally contain an associated time zone attribute as well; - * alternatively, you may specify a default time zone. + * i.e. when the {@code HttpSession} does not have to be created just for storing + * the user's locale. The session may optionally contain an associated time zone + * attribute as well; alternatively, you may specify a default time zone. * *
Custom controllers can override the user's locale and time zone by calling * {@code #setLocale(Context)} on the resolver, e.g. responding to a locale change * request. As a more convenient alternative, consider using * {@link org.springframework.web.servlet.support.RequestContext#changeLocale}. * + *
In contrast to {@link CookieLocaleResolver}, this strategy stores locally + * chosen locale settings in the Servlet container's {@code HttpSession}. As a + * consequence, those settings are just temporary for each session and therefore + * lost when each session terminates. + * + *
Note that there is no direct relationship with external session management + * mechanisms such as the "Spring Session" project. This {@code LocaleResolver} + * will simply evaluate and modify corresponding {@code HttpSession} attributes + * against the current {@code HttpServletRequest}. + * * @author Juergen Hoeller * @since 27.02.2003 * @see #setDefaultLocale diff --git a/src/asciidoc/web-mvc.adoc b/src/asciidoc/web-mvc.adoc index e5f2318462..af0cca72dd 100644 --- a/src/asciidoc/web-mvc.adoc +++ b/src/asciidoc/web-mvc.adoc @@ -3286,7 +3286,14 @@ maximum age. Find below an example of defining a `CookieLocaleResolver`. === SessionLocaleResolver The `SessionLocaleResolver` allows you to retrieve `Locale` and `TimeZone` from the -session that might be associated with the user's request. +session that might be associated with the user's request. In contrast to +`CookieLocaleResolver`, this strategy stores locally chosen locale settings in the +Servlet container's `HttpSession`. As a consequence, those settings are just temporary +for each session and therefore lost when each session terminates. + +Note that there is no direct relationship with external session management mechanisms +such as the Spring Session project. This `SessionLocaleResolver` will simply evaluate and +modify corresponding `HttpSession` attributes against the current `HttpServletRequest`.