org.springframework.web.servlet.i18n

Class CookieLocaleResolver

java.lang.Object

org.springframework.web.util.CookieGenerator

org.springframework.web.servlet.i18n.CookieLocaleResolver

All Implemented Interfaces:

LocaleContextResolver, LocaleResolver

public class CookieLocaleResolver
extends CookieGenerator
implements LocaleContextResolver

LocaleResolver implementation that uses a cookie sent back to the user in case of a custom setting, with a fallback to the specified default locale or the request's accept-header locale.

This is particularly useful for stateless applications without user sessions. The cookie may optionally contain an associated time zone value as well; alternatively, you may specify a default time zone.

Custom controllers can override the user's locale and time zone by calling #setLocale(Context) on the resolver, e.g. responding to a locale change request. As a more convenient alternative, consider using RequestContext.changeLocale(java.util.Locale).

Since:

27.02.2003

Author:

Juergen Hoeller, Jean-Pierre Pawlak

See Also:

setDefaultLocale(java.util.Locale), setDefaultTimeZone(java.util.TimeZone)

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	DEFAULT_COOKIE_NAME The default cookie name used if none is explicitly set.
static java.lang.String	LOCALE_REQUEST_ATTRIBUTE_NAME The name of the request attribute that holds the Locale.
static java.lang.String	TIME_ZONE_REQUEST_ATTRIBUTE_NAME The name of the request attribute that holds the TimeZone.

Fields inherited from class org.springframework.web.util.CookieGenerator

DEFAULT_COOKIE_PATH, logger

Constructor Summary

Constructors

Constructor and Description
CookieLocaleResolver() Create a new instance of the CookieLocaleResolver class using the default cookie name.

Method Summary

Modifier and Type	Method and Description
protected java.util.Locale	determineDefaultLocale(HttpServletRequest request) Determine the default locale for the given request, Called if no locale cookie has been found.
protected java.util.TimeZone	determineDefaultTimeZone(HttpServletRequest request) Determine the default time zone for the given request, Called if no TimeZone cookie has been found.
protected java.util.Locale	getDefaultLocale() Return the fixed Locale that this resolver will return if no cookie found, if any.
protected java.util.TimeZone	getDefaultTimeZone() Return the fixed TimeZone that this resolver will return if no cookie found, if any.
boolean	isLanguageTagCompliant() Return whether this resolver's cookies should be compliant with BCP 47 language tags instead of Java's legacy locale specification format.
protected java.util.Locale	parseLocaleValue(java.lang.String localeValue) Parse the given locale value coming from an incoming cookie.
java.util.Locale	resolveLocale(HttpServletRequest request) Resolve the current locale via the given request.
LocaleContext	resolveLocaleContext(HttpServletRequest request) Resolve the current locale context via the given request.
void	setDefaultLocale(java.util.Locale defaultLocale) Set a fixed Locale that this resolver will return if no cookie found.
void	setDefaultTimeZone(java.util.TimeZone defaultTimeZone) Set a fixed TimeZone that this resolver will return if no cookie found.
void	setLanguageTagCompliant(boolean languageTagCompliant) Specify whether this resolver's cookies should be compliant with BCP 47 language tags instead of Java's legacy locale specification format.
void	setLocale(HttpServletRequest request, HttpServletResponse response, java.util.Locale locale) Set the current locale to the given one.
void	setLocaleContext(HttpServletRequest request, HttpServletResponse response, LocaleContext localeContext) Set the current locale context to the given one, potentially including a locale with associated time zone information.
protected java.lang.String	toLocaleValue(java.util.Locale locale) Render the given locale as a text value for inclusion in a cookie.

Methods inherited from class org.springframework.web.util.CookieGenerator

addCookie, createCookie, getCookieDomain, getCookieMaxAge, getCookieName, getCookiePath, isCookieHttpOnly, isCookieSecure, removeCookie, setCookieDomain, setCookieHttpOnly, setCookieMaxAge, setCookieName, setCookiePath, setCookieSecure

Methods inherited from class java.lang.Object

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

Field Detail

LOCALE_REQUEST_ATTRIBUTE_NAME

public static final java.lang.String LOCALE_REQUEST_ATTRIBUTE_NAME

The name of the request attribute that holds the Locale.

Only used for overriding a cookie value if the locale has been changed in the course of the current request!

Use RequestContext(Utils).getLocale() to retrieve the current locale in controllers or views.

See Also:

RequestContext.getLocale(), RequestContextUtils.getLocale(javax.servlet.http.HttpServletRequest)

TIME_ZONE_REQUEST_ATTRIBUTE_NAME

public static final java.lang.String TIME_ZONE_REQUEST_ATTRIBUTE_NAME

The name of the request attribute that holds the TimeZone.

Only used for overriding a cookie value if the locale has been changed in the course of the current request!

Use RequestContext(Utils).getTimeZone() to retrieve the current time zone in controllers or views.

See Also:

RequestContext.getTimeZone(), RequestContextUtils.getTimeZone(javax.servlet.http.HttpServletRequest)

DEFAULT_COOKIE_NAME

public static final java.lang.String DEFAULT_COOKIE_NAME

The default cookie name used if none is explicitly set.

Constructor Detail

CookieLocaleResolver

public CookieLocaleResolver()

Create a new instance of the CookieLocaleResolver class using the default cookie name.

Method Detail

setLanguageTagCompliant

public void setLanguageTagCompliant(boolean languageTagCompliant)

Specify whether this resolver's cookies should be compliant with BCP 47 language tags instead of Java's legacy locale specification format.

The default is true, as of 5.1. Switch this to false for rendering Java's legacy locale specification format. For parsing, this resolver leniently accepts the legacy Locale.toString() format as well as BCP 47 language tags in any case.

Since:

4.3

See Also:

parseLocaleValue(String), toLocaleValue(Locale), Locale.forLanguageTag(String), Locale.toLanguageTag()

isLanguageTagCompliant

public boolean isLanguageTagCompliant()

Return whether this resolver's cookies should be compliant with BCP 47 language tags instead of Java's legacy locale specification format.

Since:

4.3

setDefaultLocale

public void setDefaultLocale(@Nullable
                             java.util.Locale defaultLocale)

Set a fixed Locale that this resolver will return if no cookie found.

getDefaultLocale

@Nullable
protected java.util.Locale getDefaultLocale()

Return the fixed Locale that this resolver will return if no cookie found, if any.

setDefaultTimeZone

public void setDefaultTimeZone(@Nullable
                               java.util.TimeZone defaultTimeZone)

Set a fixed TimeZone that this resolver will return if no cookie found.

Since:

4.0

getDefaultTimeZone

@Nullable
protected java.util.TimeZone getDefaultTimeZone()

Return the fixed TimeZone that this resolver will return if no cookie found, if any.

Since:

4.0

resolveLocale

public java.util.Locale resolveLocale(HttpServletRequest request)

Description copied from interface: LocaleResolver

Resolve the current locale via the given request. Can return a default locale as fallback in any case.

Specified by:

resolveLocale in interface LocaleResolver

Parameters:

request - the request to resolve the locale for

Returns:

the current locale (never null)

resolveLocaleContext

public LocaleContext resolveLocaleContext(HttpServletRequest request)

Description copied from interface: LocaleContextResolver

Resolve the current locale context via the given request.

This is primarily intended for framework-level processing; consider using RequestContextUtils or RequestContext for application-level access to the current locale and/or time zone.

The returned context may be a TimeZoneAwareLocaleContext, containing a locale with associated time zone information. Simply apply an instanceof check and downcast accordingly.

Custom resolver implementations may also return extra settings in the returned context, which again can be accessed through downcasting.

Specified by:

resolveLocaleContext in interface LocaleContextResolver

Parameters:

request - the request to resolve the locale context for

Returns:

the current locale context (never null

See Also:

LocaleResolver.resolveLocale(HttpServletRequest), RequestContextUtils.getLocale(javax.servlet.http.HttpServletRequest), RequestContextUtils.getTimeZone(javax.servlet.http.HttpServletRequest)

setLocale

public void setLocale(HttpServletRequest request,
                      @Nullable
                      HttpServletResponse response,
                      @Nullable
                      java.util.Locale locale)

Description copied from interface: LocaleResolver

Set the current locale to the given one.

Specified by:

setLocale in interface LocaleResolver

Parameters:

request - the request to be used for locale modification

response - the response to be used for locale modification

locale - the new locale, or null to clear the locale

setLocaleContext

public void setLocaleContext(HttpServletRequest request,
                             @Nullable
                             HttpServletResponse response,
                             @Nullable
                             LocaleContext localeContext)

Description copied from interface: LocaleContextResolver

Set the current locale context to the given one, potentially including a locale with associated time zone information.

Specified by:

setLocaleContext in interface LocaleContextResolver

Parameters:

request - the request to be used for locale modification

response - the response to be used for locale modification

localeContext - the new locale context, or null to clear the locale

See Also:

LocaleResolver.setLocale(HttpServletRequest, HttpServletResponse, Locale), SimpleLocaleContext, SimpleTimeZoneAwareLocaleContext

parseLocaleValue

@Nullable
protected java.util.Locale parseLocaleValue(java.lang.String localeValue)

Parse the given locale value coming from an incoming cookie.

The default implementation calls StringUtils.parseLocale(String), accepting the Locale.toString() format as well as BCP 47 language tags.

Parameters:

localeValue - the locale value to parse

Returns:

the corresponding Locale instance

Since:

4.3

See Also:

StringUtils.parseLocale(String)

toLocaleValue

protected java.lang.String toLocaleValue(java.util.Locale locale)

Render the given locale as a text value for inclusion in a cookie.

The default implementation calls Locale.toString() or JDK 7's Locale.toLanguageTag(), depending on the "languageTagCompliant" configuration property.

Parameters:

locale - the locale to stringify

Returns:

a String representation for the given locale

Since:

4.3

See Also:

isLanguageTagCompliant()

determineDefaultLocale

@Nullable
protected java.util.Locale determineDefaultLocale(HttpServletRequest request)

Determine the default locale for the given request, Called if no locale cookie has been found.

The default implementation returns the specified default locale, if any, else falls back to the request's accept-header locale.

Parameters:

request - the request to resolve the locale for

Returns:

the default locale (never null)

See Also:

setDefaultLocale(java.util.Locale), ServletRequest.getLocale()

determineDefaultTimeZone

@Nullable
protected java.util.TimeZone determineDefaultTimeZone(HttpServletRequest request)

Determine the default time zone for the given request, Called if no TimeZone cookie has been found.

The default implementation returns the specified default time zone, if any, or null otherwise.

Parameters:

request - the request to resolve the time zone for

Returns:

the default time zone (or null if none defined)

See Also:

setDefaultTimeZone(java.util.TimeZone)