Package ch.tocco.nice2.textresources.impl.i18n

Class L10NCompatibleLocaleResolverServiceImpl

java.lang.Object

ch.tocco.nice2.textresources.impl.i18n.L10NCompatibleLocaleResolverServiceImpl

All Implemented Interfaces:

LocaleResolverService

@Component
public class L10NCompatibleLocaleResolverServiceImpl
extends Object
implements LocaleResolverService

Constructor Summary

Constructors

Constructor	Description
L10NCompatibleLocaleResolverServiceImpl(L10N l10n, org.slf4j.Logger log)

Method Summary

Modifier and Type	Method	Description
Locale	completeWithSystemDefaults(@Nullable String localeString)	Adds the systems defaults to empty fields of a locale string
Locale	completeWithSystemDefaults(@Nullable Locale locale)	Adds the system defaults to empty fields of a locale.
Set<String>	getAvailableLanguagesAsString()	Returns the project-specific available languages.
Locale	getBestLocale(Set<Locale> preferredLocales)	Returns the first Locale from preferredLocales that is provided by the current project.
String	getDefaultLanguage()	Returns the project-specific default language.
Locale	getDefaultLocale()
Locale	getLocaleForGui()	Returns the gui locale for the current user to be used in the gui right now.
Set<Locale>	getPreferredLocales()	Returns the preferred locales of the current user.
Iterator<Locale>	iteratePreferredLocales()	Loops the preferred locales of the current user.
void	setLocaleResolver(List<LocaleResolver> localeResolvers)

Methods inherited from class java.lang.Object

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

Constructor Details

L10NCompatibleLocaleResolverServiceImpl

public L10NCompatibleLocaleResolverServiceImpl(L10N l10n,
 org.slf4j.Logger log)

Method Details

getDefaultLocale

public Locale getDefaultLocale()

Specified by:

getDefaultLocale in interface LocaleResolverService

Returns:

the project-specific default locale

getDefaultLanguage

public String getDefaultLanguage()

Description copied from interface: LocaleResolverService

Returns the project-specific default language.

Specified by:

getDefaultLanguage in interface LocaleResolverService

Returns:

2-letter iso code in lower case eg 'fr'.

getAvailableLanguagesAsString

public Set<String> getAvailableLanguagesAsString()

Description copied from interface: LocaleResolverService

Returns the project-specific available languages.

Specified by:

getAvailableLanguagesAsString in interface LocaleResolverService

Returns:

Unmodifiable, not empty, contains at least one 2-letter iso code in lower case.

getBestLocale

public Locale getBestLocale(Set<Locale> preferredLocales)

Description copied from interface: LocaleResolverService

Returns the first Locale from preferredLocales that is provided by the current project.

Notes:

• Compares on language level only, it does not matter if and what Country/Variant the given Locales have.
• Falls back to the project default.
• //Caches the result.

Specified by:

getBestLocale in interface LocaleResolverService

Parameters:

preferredLocales - May be empty. Iteration order matters, so use a LinkedHashSet or NavigableSet.

getLocaleForGui

public Locale getLocaleForGui()

Description copied from interface: LocaleResolverService

Returns the gui locale for the current user to be used in the gui right now.

It is guaranteed to be one of the project-offered gui locales, and falls back to the default one.

Note that this may differ from the user-configured gui locale, for example when a request comes in with an overriding locale.

Specified by:

getLocaleForGui in interface LocaleResolverService

getPreferredLocales

public Set<Locale> getPreferredLocales()

Description copied from interface: LocaleResolverService

Returns the preferred locales of the current user.

Note: All locale resolvers are asked to return all their entries. Thus this call is more expensive than LocaleResolverService.iteratePreferredLocales() and stopping early.

Specified by:

getPreferredLocales in interface LocaleResolverService

See Also:

• LocaleResolverService.iteratePreferredLocales()

iteratePreferredLocales

public Iterator<Locale> iteratePreferredLocales()

Description copied from interface: LocaleResolverService

Loops the preferred locales of the current user.

Compared to LocaleResolverService.getPreferredLocales() this has the advantage that you may abort early when you've find a good match. Then not all locale resolvers must be consulted.

Specified by:

iteratePreferredLocales in interface LocaleResolverService

See Also:

• LocaleResolverService.getPreferredLocales()

completeWithSystemDefaults

public Locale completeWithSystemDefaults(@Nullable
 @Nullable String localeString)

Description copied from interface: LocaleResolverService

Adds the systems defaults to empty fields of a locale string

Specified by:

completeWithSystemDefaults in interface LocaleResolverService

Parameters:

localeString - a locale string (e.g. as received from DB)

Returns:

a locale for the localeString with added system defaults

completeWithSystemDefaults

public Locale completeWithSystemDefaults(@Nullable
 @Nullable Locale locale)

Description copied from interface: LocaleResolverService

Adds the system defaults to empty fields of a locale. This method does not overwrite any of the settings of the locale

Specified by:

completeWithSystemDefaults in interface LocaleResolverService

Parameters:

locale - a locale

Returns:

a locale with fields filled with system defaults.

setLocaleResolver

@Autowired
public void setLocaleResolver(List<LocaleResolver> localeResolvers)