Package org.apache.struts2.interceptor.i18n

Class AcceptLanguageLocaleHandler

java.lang.Object

org.apache.struts2.interceptor.i18n.AbstractLocaleHandler

org.apache.struts2.interceptor.i18n.RequestLocaleHandler

org.apache.struts2.interceptor.i18n.AcceptLanguageLocaleHandler

All Implemented Interfaces:

LocaleHandler

Direct Known Subclasses:

AbstractStoredLocaleHandler

public abstract class AcceptLanguageLocaleHandler
extends RequestLocaleHandler

Resolves locale by first checking the request-only parameter and then falling back to the browser's Accept-Language header.

When a supportedLocale set is configured, only Accept-Language values present in that set are accepted. When the set is empty (the default), the first locale advertised by the browser is returned as-is.

See Also:

• RequestLocaleHandler
• AbstractStoredLocaleHandler

Field Summary

Fields inherited from class org.apache.struts2.interceptor.i18n.AbstractLocaleHandler

actionInvocation

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AcceptLanguageLocaleHandler(ActionInvocation invocation, String requestOnlyParameterName, Set<Locale> supportedLocale)

Method Summary

Modifier and Type	Method	Description
Locale	find()	Looks for an explicit locale override in request-scoped sources.
protected Locale	findAcceptLanguageLocale()
Locale	read(ActionInvocation invocation)	Reads locale from persistent/context sources when LocaleHandler.find() did not resolve one.

Methods inherited from class org.apache.struts2.interceptor.i18n.RequestLocaleHandler

findRequestOnlyParamLocale, store

Methods inherited from class org.apache.struts2.interceptor.i18n.AbstractLocaleHandler

disableStore, findLocaleParameter, getLocaleFromParam, isLocaleSupported, shouldStore

Methods inherited from class java.lang.Object

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

Constructor Details

AcceptLanguageLocaleHandler

protected AcceptLanguageLocaleHandler(ActionInvocation invocation,
 String requestOnlyParameterName,
 Set<Locale> supportedLocale)

Method Details

find

public Locale find()

Description copied from interface: LocaleHandler

Looks for an explicit locale override in request-scoped sources.

Specified by:

find in interface LocaleHandler

Overrides:

find in class RequestLocaleHandler

Returns:

a locale override or null when no explicit override is present

read

public Locale read(ActionInvocation invocation)

Description copied from interface: LocaleHandler

Reads locale from persistent/context sources when LocaleHandler.find() did not resolve one.

Specified by:

read in interface LocaleHandler

Overrides:

read in class RequestLocaleHandler

Parameters:

invocation - current action invocation

Returns:

resolved locale or null when no locale could be resolved

findAcceptLanguageLocale

protected Locale findAcceptLanguageLocale()