org.springframework.web.servlet.i18n

Class AcceptHeaderLocaleResolver

java.lang.Object

org.springframework.web.servlet.i18n.AcceptHeaderLocaleResolver

All Implemented Interfaces:

LocaleResolver

public class AcceptHeaderLocaleResolver
extends java.lang.Object
implements LocaleResolver

LocaleResolver implementation that simply uses the primary locale specified in the "accept-language" header of the HTTP request (that is, the locale sent by the client browser, normally that of the client's OS).

Note: Does not support setLocale, since the accept header can only be changed through changing the client's locale settings.

Since:

27.02.2003

Author:

Juergen Hoeller, Rossen Stoyanchev

See Also:

javax.servlet.http.HttpServletRequest#getLocale()

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.Locale	defaultLocale
private java.util.List<java.util.Locale>	supportedLocales

Constructor Summary

Constructors

Constructor and Description
AcceptHeaderLocaleResolver()

Method Summary

Modifier and Type	Method and Description
private java.util.Locale	findSupportedLocale(HttpServletRequest request, java.util.Locale fallback)
java.util.Locale	getDefaultLocale() The configured default locale, if any.
java.util.List<java.util.Locale>	getSupportedLocales() Return the configured list of supported locales.
private boolean	isSupportedLocale(java.util.Locale locale)
java.util.Locale	resolveLocale(HttpServletRequest request) Resolve the current locale via the given request.
void	setDefaultLocale(java.util.Locale defaultLocale) Configure a fixed default locale to fall back on if the request does not have an "Accept-Language" header.
void	setLocale(HttpServletRequest request, HttpServletResponse response, java.util.Locale locale) Set the current locale to the given one.
void	setSupportedLocales(java.util.List<java.util.Locale> locales) Configure supported locales to check against the requested locales determined via HttpServletRequest#getLocales().

Methods inherited from class java.lang.Object

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

Field Detail

supportedLocales

private final java.util.List<java.util.Locale> supportedLocales

defaultLocale

private java.util.Locale defaultLocale

Constructor Detail

AcceptHeaderLocaleResolver

public AcceptHeaderLocaleResolver()

Method Detail

setSupportedLocales

public void setSupportedLocales(java.util.List<java.util.Locale> locales)

Configure supported locales to check against the requested locales determined via HttpServletRequest#getLocales(). If this is not configured then HttpServletRequest#getLocale() is used instead.

Parameters:

locales - the supported locales

Since:

4.3

getSupportedLocales

public java.util.List<java.util.Locale> getSupportedLocales()

Return the configured list of supported locales.

Since:

4.3

setDefaultLocale

public void setDefaultLocale(java.util.Locale defaultLocale)

Configure a fixed default locale to fall back on if the request does not have an "Accept-Language" header.

By default this is not set in which case when there is "Accept-Language" header, the default locale for the server is used as defined in HttpServletRequest#getLocale().

Parameters:

defaultLocale - the default locale to use

Since:

4.3

getDefaultLocale

public java.util.Locale getDefaultLocale()

The configured default locale, if any.

Since:

4.3

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)

isSupportedLocale

private boolean isSupportedLocale(java.util.Locale locale)

findSupportedLocale

private java.util.Locale findSupportedLocale(HttpServletRequest request,
                                             java.util.Locale fallback)

setLocale

public void setLocale(HttpServletRequest request,
                      HttpServletResponse response,
                      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