com.liferay.portal.util

Class LocalizationImpl

java.lang.Object

com.liferay.portal.util.LocalizationImpl

All Implemented Interfaces:

Localization

public class LocalizationImpl
extends java.lang.Object
implements Localization

Constructor Summary

Constructors

Constructor and Description
LocalizationImpl()

Method Summary

Modifier and Type	Method and Description
java.lang.Object	deserialize(JSONObject jsonObject) Deserializes the JSON object into a map of locales and localized strings.
java.lang.String[]	getAvailableLanguageIds(Document document)
java.lang.String[]	getAvailableLanguageIds(java.lang.String xml) Returns the available locales from the localizations XML.
java.util.Locale	getDefaultImportLocale(java.lang.String className, long classPK, java.util.Locale contentDefaultLocale, java.util.Locale[] contentAvailableLocales) Returns a valid default locale for importing a localized entity.
java.util.Locale	getDefaultImportLocale(java.lang.String className, java.io.Serializable primaryKey, java.util.Locale contentDefaultLocale, java.util.Locale[] contentAvailableLocales) Returns a valid default locale for importing a localized entity.
java.lang.String	getDefaultLanguageId(Document document)
java.lang.String	getDefaultLanguageId(Document document, java.util.Locale defaultLocale)
java.lang.String	getDefaultLanguageId(java.lang.String xml) Returns the default locale from the localizations XML.
java.lang.String	getDefaultLanguageId(java.lang.String xml, java.util.Locale defaultLocale)
java.lang.String	getLocalization(java.util.function.Function<java.lang.String,java.lang.String> localizationFunction, java.lang.String requestedLanguageId, java.lang.String defaultLanguageId)
java.lang.String	getLocalization(java.lang.String xml, java.lang.String requestedLanguageId) Returns the localized string from the localizations XML in the language.
java.lang.String	getLocalization(java.lang.String xml, java.lang.String requestedLanguageId, boolean useDefault) Returns the localized string from the localizations XML in the language, optionally using the default language if no localization exists for the requested language.
java.lang.String	getLocalization(java.lang.String xml, java.lang.String requestedLanguageId, boolean useDefault, java.lang.String defaultValue) Returns the localized string from the localizations XML in the language, optionally using the default language if no localization exists for the requested language.
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(java.util.Collection<java.util.Locale> locales, java.util.Locale defaultLocale, java.lang.String key) Returns a map of locales and localized strings for the key.
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(javax.servlet.http.HttpServletRequest httpServletRequest, java.lang.String parameter) Returns a map of locales and localized strings for the parameter in the request.
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(javax.portlet.PortletPreferences preferences, java.lang.String preferenceName) Returns a map of locales and localized strings for the preference in the preferences container.
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(javax.portlet.PortletPreferences preferences, java.lang.String preferenceName, java.lang.String propertyName) Returns a map of locales and localized strings for the preference in the preferences container.
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(javax.portlet.PortletPreferences preferences, java.lang.String preferenceName, java.lang.String propertyName, java.lang.String defaultPropertyValue, java.lang.ClassLoader classLoader)
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(javax.portlet.PortletRequest portletRequest, java.lang.String parameter) Returns a map of locales and localized strings for the parameter in the portlet request.
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(javax.portlet.PortletRequest portletRequest, java.lang.String parameter, java.util.Map<java.util.Locale,java.lang.String> defaultValues)
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(java.lang.String xml) Returns a map of locales and localized strings from the localizations XML.
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(java.lang.String[] languageIds, java.lang.String[] values) Returns a map of locales and localized strings for the given languageIds and values.
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(java.lang.String xml, boolean useDefault)
java.util.Map<java.util.Locale,java.lang.String>	getLocalizationMap(java.lang.String bundleName, java.lang.ClassLoader classLoader, java.lang.String key, boolean includeBetaLocales)
java.lang.String	getLocalizationXmlFromPreferences(javax.portlet.PortletPreferences preferences, javax.portlet.PortletRequest portletRequest, java.lang.String parameter) Returns the localizations XML for the parameter from the portlet request, attempting to get data from the preferences container if it is not available in the portlet request.
java.lang.String	getLocalizationXmlFromPreferences(javax.portlet.PortletPreferences preferences, javax.portlet.PortletRequest portletRequest, java.lang.String parameter, java.lang.String defaultValue) Returns the localizations XML for the parameter from the portlet request, attempting to get data from the preferences container if it is not available in the portlet request.
java.lang.String	getLocalizationXmlFromPreferences(javax.portlet.PortletPreferences preferences, javax.portlet.PortletRequest portletRequest, java.lang.String parameter, java.lang.String prefix, java.lang.String defaultValue) Returns the localizations XML for the prefixed parameter from the portlet request, attempting to get data from the preferences container if it is not available in the portlet request.
java.lang.String	getLocalizedName(java.lang.String name, java.lang.String languageId) Returns the localized name in the language.
java.util.Map<java.util.Locale,java.lang.String>	getMap(LocalizedValuesMap localizedValuesMap)
java.lang.String	getPreferencesValue(javax.portlet.PortletPreferences preferences, java.lang.String key, java.lang.String languageId) Returns the localized preferences value for the key in the language.
java.lang.String	getPreferencesValue(javax.portlet.PortletPreferences preferences, java.lang.String key, java.lang.String languageId, boolean useDefault) Returns the localized preferences value for the key in the language, optionally using the default language if no localization exists for the requested language.
java.lang.String[]	getPreferencesValues(javax.portlet.PortletPreferences preferences, java.lang.String key, java.lang.String languageId) Returns the localized preferences values for the key in the language.
java.lang.String[]	getPreferencesValues(javax.portlet.PortletPreferences preferences, java.lang.String key, java.lang.String languageId, boolean useDefault) Returns the localized preferences values for the key in the language, optionally using the default language if no localization exists for the requested language.
java.lang.String	getSettingsValue(Settings settings, java.lang.String key, java.lang.String languageId) Returns the localized settings value for the key in the language.
java.lang.String	getSettingsValue(Settings settings, java.lang.String key, java.lang.String languageId, boolean useDefault) Returns the localized settings value for the key in the language, optionally using the default language if no localization exists for the requested language.
java.lang.String[]	getSettingsValues(Settings settings, java.lang.String key, java.lang.String languageId) Returns the localized settings values for the key in the language.
java.lang.String[]	getSettingsValues(Settings settings, java.lang.String key, java.lang.String languageId, boolean useDefault) Returns the localized settings values for the key in the language, optionally using the default language if no localization exists for the requested language.
java.lang.String	getXml(LocalizedValuesMap localizedValuesMap, java.lang.String key)
java.lang.String	getXml(java.util.Map<java.lang.String,java.lang.String> map, java.lang.String defaultLanguageId, java.lang.String key)
java.util.Map<java.util.Locale,java.lang.String>	populateLocalizationMap(java.util.Map<java.util.Locale,java.lang.String> localizationMap, java.lang.String defaultLanguageId, long groupId)
java.lang.String	removeLocalization(java.lang.String xml, java.lang.String key, java.lang.String requestedLanguageId) Removes the localization for the language from the localizations XML.
java.lang.String	removeLocalization(java.lang.String xml, java.lang.String key, java.lang.String requestedLanguageId, boolean cdata) Removes the localization for the language from the localizations XML, optionally storing the localized strings as CDATA in the XML.
java.lang.String	removeLocalization(java.lang.String xml, java.lang.String key, java.lang.String requestedLanguageId, boolean cdata, boolean localized) Removes the localization for the language from the localizations XML, optionally storing the localized strings as CDATA in the XML.
void	setLocalizedPreferencesValues(javax.portlet.PortletRequest portletRequest, javax.portlet.PortletPreferences preferences, java.lang.String parameter) Sets the localized preferences values for the parameter in the portlet request.
void	setPreferencesValue(javax.portlet.PortletPreferences preferences, java.lang.String key, java.lang.String languageId, java.lang.String value) Sets the localized preferences value for the key in the language.
void	setPreferencesValues(javax.portlet.PortletPreferences preferences, java.lang.String key, java.lang.String languageId, java.lang.String[] values) Sets the localized preferences values for the key in the language.
java.lang.String	updateLocalization(java.util.Map<java.util.Locale,java.lang.String> localizationMap, java.lang.String xml, java.lang.String key, java.lang.String defaultLanguageId) Updates the localized string for all the available languages in the localizations XML for the map of locales and localized strings and changes the default language.
java.lang.String	updateLocalization(java.lang.String xml, java.lang.String key, java.lang.String value) Updates the localized string for the system default language in the localizations XML.
java.lang.String	updateLocalization(java.lang.String xml, java.lang.String key, java.lang.String value, java.lang.String requestedLanguageId) Updates the localized string for the language in the localizations XML.
java.lang.String	updateLocalization(java.lang.String xml, java.lang.String key, java.lang.String value, java.lang.String requestedLanguageId, java.lang.String defaultLanguageId) Updates the localized string for the language in the localizations XML and changes the default language.
java.lang.String	updateLocalization(java.lang.String xml, java.lang.String key, java.lang.String value, java.lang.String requestedLanguageId, java.lang.String defaultLanguageId, boolean cdata) Updates the localized string for the language in the localizations XML and changes the default language, optionally storing the localized strings as CDATA in the XML.
java.lang.String	updateLocalization(java.lang.String xml, java.lang.String key, java.lang.String value, java.lang.String requestedLanguageId, java.lang.String defaultLanguageId, boolean cdata, boolean localized) Updates the localized string for the language in the localizations XML and changes the default language, optionally storing the localized strings as CDATA in the XML.

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalizationImpl

public LocalizationImpl()

Method Detail

deserialize

public java.lang.Object deserialize(JSONObject jsonObject)

Description copied from interface: Localization

Deserializes the JSON object into a map of locales and localized strings.

Specified by:

deserialize in interface Localization

Parameters:

jsonObject - the JSON object

Returns:

the locales and localized strings

getAvailableLanguageIds

public java.lang.String[] getAvailableLanguageIds(Document document)

Specified by:

getAvailableLanguageIds in interface Localization

getAvailableLanguageIds

public java.lang.String[] getAvailableLanguageIds(java.lang.String xml)

Description copied from interface: Localization

Returns the available locales from the localizations XML.

Specified by:

getAvailableLanguageIds in interface Localization

Parameters:

xml - the localizations XML

Returns:

the language IDs of the available locales

getDefaultImportLocale

public java.util.Locale getDefaultImportLocale(java.lang.String className,
                                               long classPK,
                                               java.util.Locale contentDefaultLocale,
                                               java.util.Locale[] contentAvailableLocales)

Description copied from interface: Localization

Returns a valid default locale for importing a localized entity.

Specified by:

getDefaultImportLocale in interface Localization

Parameters:

className - the class name of the entity

classPK - the primary keys of the entity

contentDefaultLocale - the default Locale of the entity

contentAvailableLocales - the available locales of the entity

Returns:

the valid locale

getDefaultImportLocale

public java.util.Locale getDefaultImportLocale(java.lang.String className,
                                               java.io.Serializable primaryKey,
                                               java.util.Locale contentDefaultLocale,
                                               java.util.Locale[] contentAvailableLocales)

Description copied from interface: Localization

Returns a valid default locale for importing a localized entity.

Specified by:

getDefaultImportLocale in interface Localization

Parameters:

className - the class name of the entity

primaryKey - the primary keys of the entity

contentDefaultLocale - the default Locale of the entity

contentAvailableLocales - the available locales of the entity

Returns:

the valid locale

getDefaultLanguageId

public java.lang.String getDefaultLanguageId(Document document)

Specified by:

getDefaultLanguageId in interface Localization

getDefaultLanguageId

public java.lang.String getDefaultLanguageId(Document document,
                                             java.util.Locale defaultLocale)

Specified by:

getDefaultLanguageId in interface Localization

getDefaultLanguageId

public java.lang.String getDefaultLanguageId(java.lang.String xml)

Description copied from interface: Localization

Returns the default locale from the localizations XML.

Specified by:

getDefaultLanguageId in interface Localization

Parameters:

xml - the localizations XML

Returns:

the language ID of the default locale, or the system default locale if the default locale cannot be retrieved from the XML

getDefaultLanguageId

public java.lang.String getDefaultLanguageId(java.lang.String xml,
                                             java.util.Locale defaultLocale)

Specified by:

getDefaultLanguageId in interface Localization

getLocalization

public java.lang.String getLocalization(java.util.function.Function<java.lang.String,java.lang.String> localizationFunction,
                                        java.lang.String requestedLanguageId,
                                        java.lang.String defaultLanguageId)

Specified by:

getLocalization in interface Localization

getLocalization

public java.lang.String getLocalization(java.lang.String xml,
                                        java.lang.String requestedLanguageId)

Description copied from interface: Localization

Returns the localized string from the localizations XML in the language. The default language is used if no localization exists for the requested language.

Specified by:

getLocalization in interface Localization

Parameters:

xml - the localizations XML

requestedLanguageId - the ID of the language

Returns:

the localized string

getLocalization

public java.lang.String getLocalization(java.lang.String xml,
                                        java.lang.String requestedLanguageId,
                                        boolean useDefault)

Description copied from interface: Localization

Returns the localized string from the localizations XML in the language, optionally using the default language if no localization exists for the requested language.

Specified by:

getLocalization in interface Localization

Parameters:

xml - the localizations XML

requestedLanguageId - the ID of the language

useDefault - whether to use the default language if no localization exists for the requested language

Returns:

the localized string, or an empty string if useDefault is false and no localization exists for the requested language

getLocalization

public java.lang.String getLocalization(java.lang.String xml,
                                        java.lang.String requestedLanguageId,
                                        boolean useDefault,
                                        java.lang.String defaultValue)

Description copied from interface: Localization

Returns the localized string from the localizations XML in the language, optionally using the default language if no localization exists for the requested language. If no localization exists, the default value is returned.

Specified by:

getLocalization in interface Localization

Parameters:

xml - the localizations XML

requestedLanguageId - the ID of the language

useDefault - whether to use the default language if no localization exists for the requested language

defaultValue - the value returned if no localization exists

Returns:

the localized string, or the defaultValue if useDefault is false and no localization exists for the requested language

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(java.util.Collection<java.util.Locale> locales,
                                                                           java.util.Locale defaultLocale,
                                                                           java.lang.String key)

Description copied from interface: Localization

Returns a map of locales and localized strings for the key. If no localization exists for a locale or the localization matches the default locale, that locale is not included in the map.

Specified by:

getLocalizationMap in interface Localization

Parameters:

locales - the locales to be used in the map

defaultLocale - the default locale

key - the language key to be translated

Returns:

the locales and localized strings for the key

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(javax.servlet.http.HttpServletRequest httpServletRequest,
                                                                           java.lang.String parameter)

Description copied from interface: Localization

Returns a map of locales and localized strings for the parameter in the request.

Specified by:

getLocalizationMap in interface Localization

Parameters:

httpServletRequest - the request

parameter - the prefix of the parameters containing the localized strings. Each localization is loaded from a parameter with this prefix, followed by an underscore, and the language ID.

Returns:

the locales and localized strings

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(javax.portlet.PortletPreferences preferences,
                                                                           java.lang.String preferenceName)

Description copied from interface: Localization

Returns a map of locales and localized strings for the preference in the preferences container.

Specified by:

getLocalizationMap in interface Localization

Parameters:

preferences - the preferences container

preferenceName - the prefix of the preference containing the localized strings. Each localization is loaded from a preference with this prefix, followed by an underscore, and the language ID.

Returns:

the locales and localized strings

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(javax.portlet.PortletPreferences preferences,
                                                                           java.lang.String preferenceName,
                                                                           java.lang.String propertyName)

Description copied from interface: Localization

Returns a map of locales and localized strings for the preference in the preferences container. If no localization exists for the preference in the default locale, the value of the property is used as the localization for it.

Specified by:

getLocalizationMap in interface Localization

Parameters:

preferences - the preferences container

preferenceName - the prefix of the preference containing the localized strings. Each localization is loaded from a preference with this prefix, followed by an underscore, and the language ID.

propertyName - the name of the property whose value is used as the localization for the default locale, if no localization exists for it

Returns:

the locales and localized strings

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(javax.portlet.PortletPreferences preferences,
                                                                           java.lang.String preferenceName,
                                                                           java.lang.String propertyName,
                                                                           java.lang.String defaultPropertyValue,
                                                                           java.lang.ClassLoader classLoader)

Specified by:

getLocalizationMap in interface Localization

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(javax.portlet.PortletRequest portletRequest,
                                                                           java.lang.String parameter)

Description copied from interface: Localization

Returns a map of locales and localized strings for the parameter in the portlet request.

Specified by:

getLocalizationMap in interface Localization

Parameters:

portletRequest - the portlet request

parameter - the prefix of the parameters containing the localized strings. Each localization is loaded from a parameter with this prefix, followed by an underscore, and the language ID.

Returns:

the locales and localized strings

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(javax.portlet.PortletRequest portletRequest,
                                                                           java.lang.String parameter,
                                                                           java.util.Map<java.util.Locale,java.lang.String> defaultValues)

Specified by:

getLocalizationMap in interface Localization

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(java.lang.String xml)

Description copied from interface: Localization

Returns a map of locales and localized strings from the localizations XML.

Specified by:

getLocalizationMap in interface Localization

Parameters:

xml - the localizations XML

Returns:

the locales and localized strings

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(java.lang.String xml,
                                                                           boolean useDefault)

Specified by:

getLocalizationMap in interface Localization

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(java.lang.String bundleName,
                                                                           java.lang.ClassLoader classLoader,
                                                                           java.lang.String key,
                                                                           boolean includeBetaLocales)

Specified by:

getLocalizationMap in interface Localization

getLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> getLocalizationMap(java.lang.String[] languageIds,
                                                                           java.lang.String[] values)

Description copied from interface: Localization

Returns a map of locales and localized strings for the given languageIds and values.

Specified by:

getLocalizationMap in interface Localization

Parameters:

languageIds - the languageIds of the localized Strings

values - the localized strings for the different languageId

Returns:

the map of locales and values for the given parameters

getLocalizationXmlFromPreferences

public java.lang.String getLocalizationXmlFromPreferences(javax.portlet.PortletPreferences preferences,
                                                          javax.portlet.PortletRequest portletRequest,
                                                          java.lang.String parameter)

Description copied from interface: Localization

Returns the localizations XML for the parameter from the portlet request, attempting to get data from the preferences container if it is not available in the portlet request.

Specified by:

getLocalizationXmlFromPreferences in interface Localization

Parameters:

preferences - the preferences container

portletRequest - the portlet request

parameter - the prefix of the parameters containing the localized strings. Each localization is loaded from a parameter with this prefix, followed by an underscore, and the language ID.

Returns:

the locales and localized strings

getLocalizationXmlFromPreferences

public java.lang.String getLocalizationXmlFromPreferences(javax.portlet.PortletPreferences preferences,
                                                          javax.portlet.PortletRequest portletRequest,
                                                          java.lang.String parameter,
                                                          java.lang.String defaultValue)

Description copied from interface: Localization

Returns the localizations XML for the parameter from the portlet request, attempting to get data from the preferences container if it is not available in the portlet request. If no localization exists in the default locale, the default value is used as the localization for it.

Specified by:

getLocalizationXmlFromPreferences in interface Localization

Parameters:

preferences - the preferences container

portletRequest - the portlet request

parameter - the prefix of the parameters containing the localized strings. Each localization is loaded from a parameter with this prefix, followed by an underscore, and the language ID.

defaultValue - the value used as the localization for the default locale, if no localization exists for it

Returns:

the locales and localized strings

getLocalizationXmlFromPreferences

public java.lang.String getLocalizationXmlFromPreferences(javax.portlet.PortletPreferences preferences,
                                                          javax.portlet.PortletRequest portletRequest,
                                                          java.lang.String parameter,
                                                          java.lang.String prefix,
                                                          java.lang.String defaultValue)

Description copied from interface: Localization

Returns the localizations XML for the prefixed parameter from the portlet request, attempting to get data from the preferences container if it is not available in the portlet request. If no localization exists for the the default locale, the default value is used as the localization for it.

Specified by:

getLocalizationXmlFromPreferences in interface Localization

Parameters:

preferences - the preferences container

portletRequest - the portlet request

parameter - the prefix of the parameters containing the localized strings. Each localization is loaded from a parameter with this prefix, followed by an underscore, and the language ID.

prefix - the value used in the request to prefix the parameter name

defaultValue - the value used as the localization for the default locale, if no localization exists for it

Returns:

the locales and localized strings, or the defaultValue if no localization exists

getLocalizedName

public java.lang.String getLocalizedName(java.lang.String name,
                                         java.lang.String languageId)

Description copied from interface: Localization

Returns the localized name in the language. The localized name is the name, followed by an underscore, and the language ID.

Specified by:

getLocalizedName in interface Localization

Parameters:

name - the name to be localized

languageId - the ID of the language

Returns:

the localized name for the language

getMap

public java.util.Map<java.util.Locale,java.lang.String> getMap(LocalizedValuesMap localizedValuesMap)

Specified by:

getMap in interface Localization

getPreferencesValue

public java.lang.String getPreferencesValue(javax.portlet.PortletPreferences preferences,
                                            java.lang.String key,
                                            java.lang.String languageId)

Description copied from interface: Localization

Returns the localized preferences value for the key in the language. The default language is used if no localization exists for the requested language.

Specified by:

getPreferencesValue in interface Localization

Parameters:

preferences - the preferences container

key - the preferences key

languageId - the ID of the language

Returns:

the localized preferences value

getPreferencesValue

public java.lang.String getPreferencesValue(javax.portlet.PortletPreferences preferences,
                                            java.lang.String key,
                                            java.lang.String languageId,
                                            boolean useDefault)

Description copied from interface: Localization

Returns the localized preferences value for the key in the language, optionally using the default language if no localization exists for the requested language.

Specified by:

getPreferencesValue in interface Localization

Parameters:

preferences - the preferences container

key - the preferences key

languageId - the ID of the language

useDefault - whether to use the default language if no localization exists for the requested language

Returns:

the localized preferences value, or an empty string if useDefault is false and no localization exists for the requested language

getPreferencesValues

public java.lang.String[] getPreferencesValues(javax.portlet.PortletPreferences preferences,
                                               java.lang.String key,
                                               java.lang.String languageId)

Description copied from interface: Localization

Returns the localized preferences values for the key in the language. The default language is used if no localization exists for the requested language.

Specified by:

getPreferencesValues in interface Localization

Parameters:

preferences - the preferences container

key - the preferences key

languageId - the ID of the language

Returns:

the localized preferences values

getPreferencesValues

public java.lang.String[] getPreferencesValues(javax.portlet.PortletPreferences preferences,
                                               java.lang.String key,
                                               java.lang.String languageId,
                                               boolean useDefault)

Description copied from interface: Localization

Returns the localized preferences values for the key in the language, optionally using the default language if no localization exists for the requested language.

Specified by:

getPreferencesValues in interface Localization

Parameters:

preferences - the preferences container

key - the preferences key

languageId - the ID of the language

useDefault - whether to use the default language if no localization exists for the requested language

Returns:

the localized preferences values, or an empty string if useDefault is false and no localization exists for the requested language

getSettingsValue

public java.lang.String getSettingsValue(Settings settings,
                                         java.lang.String key,
                                         java.lang.String languageId)

Description copied from interface: Localization

Returns the localized settings value for the key in the language. The default language is used if no localization exists for the requested language.

Specified by:

getSettingsValue in interface Localization

Parameters:

settings - the settings

key - the settings key

languageId - the ID of the language

Returns:

the localized settings value

getSettingsValue

public java.lang.String getSettingsValue(Settings settings,
                                         java.lang.String key,
                                         java.lang.String languageId,
                                         boolean useDefault)

Description copied from interface: Localization

Returns the localized settings value for the key in the language, optionally using the default language if no localization exists for the requested language.

Specified by:

getSettingsValue in interface Localization

Parameters:

settings - the settings

key - the settings key

languageId - the ID of the language

useDefault - whether to use the default language if no localization exists for the requested language

Returns:

the localized settings value. If useDefault is false and no localization exists for the requested language, an empty string is returned.

getSettingsValues

public java.lang.String[] getSettingsValues(Settings settings,
                                            java.lang.String key,
                                            java.lang.String languageId)

Description copied from interface: Localization

Returns the localized settings values for the key in the language. The default language is used if no localization exists for the requested language.

Specified by:

getSettingsValues in interface Localization

Parameters:

settings - the settings

key - the settings key

languageId - the ID of the language

Returns:

the localized settings values

getSettingsValues

public java.lang.String[] getSettingsValues(Settings settings,
                                            java.lang.String key,
                                            java.lang.String languageId,
                                            boolean useDefault)

Description copied from interface: Localization

Returns the localized settings values for the key in the language, optionally using the default language if no localization exists for the requested language.

Specified by:

getSettingsValues in interface Localization

Parameters:

settings - the settings

key - the settings key

languageId - the ID of the language

useDefault - whether to use the default language if no localization exists for the requested language

Returns:

the localized settings values. If useDefault is false and no localization exists for the requested language, an empty array is returned.

getXml

public java.lang.String getXml(LocalizedValuesMap localizedValuesMap,
                               java.lang.String key)

Specified by:

getXml in interface Localization

getXml

public java.lang.String getXml(java.util.Map<java.lang.String,java.lang.String> map,
                               java.lang.String defaultLanguageId,
                               java.lang.String key)

Specified by:

getXml in interface Localization

populateLocalizationMap

public java.util.Map<java.util.Locale,java.lang.String> populateLocalizationMap(java.util.Map<java.util.Locale,java.lang.String> localizationMap,
                                                                                java.lang.String defaultLanguageId,
                                                                                long groupId)

Specified by:

populateLocalizationMap in interface Localization

removeLocalization

public java.lang.String removeLocalization(java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String requestedLanguageId)

Description copied from interface: Localization

Removes the localization for the language from the localizations XML. The localized strings are stored as characters in the XML.

Specified by:

removeLocalization in interface Localization

Parameters:

xml - the localizations XML

key - the name of the localized string, such as "Title"

requestedLanguageId - the ID of the language

Returns:

the localizations XML with the language removed

removeLocalization

public java.lang.String removeLocalization(java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String requestedLanguageId,
                                           boolean cdata)

Description copied from interface: Localization

Removes the localization for the language from the localizations XML, optionally storing the localized strings as CDATA in the XML.

Specified by:

removeLocalization in interface Localization

Parameters:

xml - the localizations XML

key - the name of the localized string, such as "Title"

requestedLanguageId - the ID of the language

cdata - whether to store localized strings as CDATA in the XML

Returns:

the localizations XML with the language removed

removeLocalization

public java.lang.String removeLocalization(java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String requestedLanguageId,
                                           boolean cdata,
                                           boolean localized)

Description copied from interface: Localization

Removes the localization for the language from the localizations XML, optionally storing the localized strings as CDATA in the XML.

Specified by:

removeLocalization in interface Localization

Parameters:

xml - the localizations XML

key - the name of the localized string, such as "Title"

requestedLanguageId - the ID of the language

cdata - whether to store localized strings as CDATA in the XML

localized - whether there is a localized field

Returns:

the localizations XML with the language removed

setLocalizedPreferencesValues

public void setLocalizedPreferencesValues(javax.portlet.PortletRequest portletRequest,
                                          javax.portlet.PortletPreferences preferences,
                                          java.lang.String parameter)
                                   throws java.lang.Exception

Description copied from interface: Localization

Sets the localized preferences values for the parameter in the portlet request.

Specified by:

setLocalizedPreferencesValues in interface Localization

Parameters:

portletRequest - the portlet request

preferences - the preferences container

parameter - the prefix of the parameters containing the localized strings. Each localization is loaded from a parameter with this prefix, followed by an underscore, and the language ID.

Throws:

java.lang.Exception - if an exception occurred

setPreferencesValue

public void setPreferencesValue(javax.portlet.PortletPreferences preferences,
                                java.lang.String key,
                                java.lang.String languageId,
                                java.lang.String value)
                         throws java.lang.Exception

Description copied from interface: Localization

Sets the localized preferences value for the key in the language.

Specified by:

setPreferencesValue in interface Localization

Parameters:

preferences - the preferences container

key - the preferences key

languageId - the ID of the language

value - the localized value

Throws:

java.lang.Exception - if an exception occurred

setPreferencesValues

public void setPreferencesValues(javax.portlet.PortletPreferences preferences,
                                 java.lang.String key,
                                 java.lang.String languageId,
                                 java.lang.String[] values)
                          throws java.lang.Exception

Description copied from interface: Localization

Sets the localized preferences values for the key in the language.

Specified by:

setPreferencesValues in interface Localization

Parameters:

preferences - the preferences container

key - the preferences key

languageId - the ID of the language

values - the localized values

Throws:

java.lang.Exception - if an exception occurred

updateLocalization

public java.lang.String updateLocalization(java.util.Map<java.util.Locale,java.lang.String> localizationMap,
                                           java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String defaultLanguageId)

Description copied from interface: Localization

Updates the localized string for all the available languages in the localizations XML for the map of locales and localized strings and changes the default language. The localized strings are stored as characters in the XML.

Specified by:

updateLocalization in interface Localization

Parameters:

localizationMap - the locales and localized strings

xml - the localizations XML

key - the name of the localized string, such as "Title"

defaultLanguageId - the ID of the default language

Returns:

the updated localizations XML

updateLocalization

public java.lang.String updateLocalization(java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String value)

Description copied from interface: Localization

Updates the localized string for the system default language in the localizations XML. The localized strings are stored as characters in the XML.

Specified by:

updateLocalization in interface Localization

Parameters:

xml - the localizations XML

key - the name of the localized string, such as "Title"

value - the localized string

Returns:

the updated localizations XML

updateLocalization

public java.lang.String updateLocalization(java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String value,
                                           java.lang.String requestedLanguageId)

Description copied from interface: Localization

Updates the localized string for the language in the localizations XML. The localized strings are stored as characters in the XML.

Specified by:

updateLocalization in interface Localization

Parameters:

xml - the localizations XML

key - the name of the localized string, such as "Title"

value - the localized string

requestedLanguageId - the ID of the language

Returns:

the updated localizations XML

updateLocalization

public java.lang.String updateLocalization(java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String value,
                                           java.lang.String requestedLanguageId,
                                           java.lang.String defaultLanguageId)

Description copied from interface: Localization

Updates the localized string for the language in the localizations XML and changes the default language. The localized strings are stored as characters in the XML.

Specified by:

updateLocalization in interface Localization

Parameters:

xml - the localizations XML

key - the name of the localized string, such as "Title"

value - the localized string

requestedLanguageId - the ID of the language

defaultLanguageId - the ID of the default language

Returns:

the updated localizations XML

updateLocalization

public java.lang.String updateLocalization(java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String value,
                                           java.lang.String requestedLanguageId,
                                           java.lang.String defaultLanguageId,
                                           boolean cdata)

Description copied from interface: Localization

Updates the localized string for the language in the localizations XML and changes the default language, optionally storing the localized strings as CDATA in the XML.

Specified by:

updateLocalization in interface Localization

Parameters:

xml - the localizations XML

key - the name of the localized string, such as "Title"

value - the localized string

requestedLanguageId - the ID of the language

defaultLanguageId - the ID of the default language

cdata - whether to store localized strings as CDATA in the XML

Returns:

the updated localizations XML

updateLocalization

public java.lang.String updateLocalization(java.lang.String xml,
                                           java.lang.String key,
                                           java.lang.String value,
                                           java.lang.String requestedLanguageId,
                                           java.lang.String defaultLanguageId,
                                           boolean cdata,
                                           boolean localized)

Description copied from interface: Localization

Updates the localized string for the language in the localizations XML and changes the default language, optionally storing the localized strings as CDATA in the XML.

Specified by:

updateLocalization in interface Localization

Parameters:

xml - the localizations XML

key - the name of the localized string, such as "Title"

value - the localized string

requestedLanguageId - the ID of the language

defaultLanguageId - the ID of the default language

cdata - whether to store localized strings as CDATA in the XML

localized - whether there is a localized field

Returns:

the updated localizations XML