Class AcceptHeaderLocaleContextResolver
java.lang.Object
org.springframework.web.server.i18n.AcceptHeaderLocaleContextResolver
- All Implemented Interfaces:
LocaleContextResolver
LocaleContextResolver
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 setLocaleContext(org.springframework.web.server.ServerWebExchange, org.springframework.context.i18n.LocaleContext)
, since the accept header
can only be changed through changing the client's locale settings.
- Since:
- 5.0
- Author:
- Sebastien Deleuze, Juergen Hoeller
- See Also:
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionThe configured default locale, if any.Return the configured list of supported locales.resolveLocaleContext
(ServerWebExchange exchange) Resolve the current locale context via the given exchange.void
setDefaultLocale
(Locale defaultLocale) Configure a fixed default locale to fall back on if the request does not have an "Accept-Language" header (not set by default).void
setLocaleContext
(ServerWebExchange exchange, LocaleContext locale) Set the current locale context to the given one, potentially including a locale with associated time zone information.void
setSupportedLocales
(List<Locale> locales) Configure supported locales to check against the requested locales determined viaHttpHeaders.getAcceptLanguageAsLocales()
.
-
Constructor Details
-
AcceptHeaderLocaleContextResolver
public AcceptHeaderLocaleContextResolver()
-
-
Method Details
-
setSupportedLocales
Configure supported locales to check against the requested locales determined viaHttpHeaders.getAcceptLanguageAsLocales()
.- Parameters:
locales
- the supported locales
-
getSupportedLocales
Return the configured list of supported locales. -
setDefaultLocale
Configure a fixed default locale to fall back on if the request does not have an "Accept-Language" header (not set by default).- Parameters:
defaultLocale
- the default locale to use
-
getDefaultLocale
The configured default locale, if any.This method may be overridden in subclasses.
-
resolveLocaleContext
Description copied from interface:LocaleContextResolver
Resolve the current locale context via the given exchange.The returned context may be a
TimeZoneAwareLocaleContext
, containing a locale with associated time zone information. Simply apply aninstanceof
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 interfaceLocaleContextResolver
- Parameters:
exchange
- current server exchange- Returns:
- the current locale context (never
null
)
-
setLocaleContext
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 interfaceLocaleContextResolver
- Parameters:
exchange
- current server exchangelocale
- the new locale context, ornull
to clear the locale- See Also:
-