com.edorasware.one.i18n

Class I18nUtils

java.lang.Object

com.edorasware.one.i18n.I18nUtils

public final class I18nUtils
extends Object

i18n utility class.

Method Summary

Modifier and Type	Method and Description
static String	extractLanguageCode(String languageString, String defaultLanguageCode) Extracts the two letter language code defined in ISO 639 from a specified string.
static com.google.common.collect.ImmutableMap<String,String>	flattenMap(Map<String,Map<String,String>> i18nMap, String propertyPrefix, String propertySeparator) Flattens an i18n map to a map with a key based on the keys of the nested maps and a value of the defined property.
static <T extends Localizable<T>> com.google.common.collect.ImmutableList<T>	localize(Collection<T> localizableCollection, org.springframework.context.MessageSource messageSource, Locale locale) Localizes a list of localizable classes and returns the localized versions of the specified instances.

Methods inherited from class java.lang.Object

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

Method Detail

flattenMap

public static com.google.common.collect.ImmutableMap<String,String> flattenMap(Map<String,Map<String,String>> i18nMap,
                                                                               String propertyPrefix,
                                                                               String propertySeparator)

Flattens an i18n map to a map with a key based on the keys of the nested maps and a value of the defined property. For example we have a nested i18n map as following: { "de": { "name":"Name", "description","Beschreibung" }, "en": { "name":"name", "description","description" } } The resulting map looks like this (given that the property prefix is 'i18n' and the property separator is '.'): { "i18n.de.name:"Name", "i18n.de.description:"Beschreibung", "i18n.en.name:"Name", "i18n.en.description:"description" }

Parameters:

i18nMap - the i18n map to flatten

propertyPrefix - the prefix which is added before each key in the new map

propertySeparator - the separator which is added between the map keys

Returns:

the flattened map

localize

public static <T extends Localizable<T>> com.google.common.collect.ImmutableList<T> localize(Collection<T> localizableCollection,
                                                                                             org.springframework.context.MessageSource messageSource,
                                                                                             Locale locale)

Localizes a list of localizable classes and returns the localized versions of the specified instances.

Type Parameters:

T - the localizable class which implements the Localizable interface

Parameters:

localizableCollection - the instances which needs to be localized

messageSource - the message source which translates the i18n codes for the localization

locale - the specified locale to which the i18n codes are translated

Returns:

a list of the localized version of the specified instances

extractLanguageCode

public static String extractLanguageCode(String languageString,
                                         String defaultLanguageCode)

Extracts the two letter language code defined in ISO 639 from a specified string. The following formats are supported:

• en-US,en;;q=0.5 -> HTTP header Accept Language
• en-US -> two letter language code with locale
• en -> two letter language code

Parameters:

languageString - the string to get the two letter language code

defaultLanguageCode - the default code which is returned if the languageString is null

Returns:

the two letter language code defined in ISO 639