org.broadleafcommerce.common.i18n.service
Interface TranslationService

All Known Implementing Classes:

TranslationServiceImpl

public interface TranslationService

Method Summary

void	deleteTranslationById(Long translationId) Deletes the given translations
String	getTranslatedValue(Object entity, String property, Locale locale) Returns the translated value of the property for the given entity.
Translation	getTranslation(TranslatedEntity entity, String entityId, String fieldName, String localeCode) Attempts to find the translation object for the given parameters
List<Translation>	getTranslations(String ceilingEntityClassname, String entityId, String property) Finds all current translations for the specified field
Translation	save(String entityType, String entityId, String fieldName, String localeCode, String translatedValue) Creates a new translation object for the requested parameters, saves it, and returns the saved instance.
Translation	save(Translation translation) Persists the given translation
Translation	update(Long translationId, String localeCode, String translatedValue) Updates the given translation id with the new locale code and translated value

Method Detail

save

Translation save(Translation translation)

Persists the given translation

Parameters:

translation -

Returns:

the persisted translation

save

Translation save(String entityType,
                 String entityId,
                 String fieldName,
                 String localeCode,
                 String translatedValue)

Creates a new translation object for the requested parameters, saves it, and returns the saved instance. Note: This method will overwrite a previously existing translation if it matches on entityType, entityId, fieldName, and localeCode.

Parameters:

entityType -

entityId -

fieldName -

localeCode -

translatedValue -

Returns:

the persisted translation

update

Translation update(Long translationId,
                   String localeCode,
                   String translatedValue)

Updates the given translation id with the new locale code and translated value

Parameters:

translationId -

localeCode -

translatedValue -

Returns:

the persisted translation

deleteTranslationById

void deleteTranslationById(Long translationId)

Deletes the given translations

Parameters:

translationId -

getTranslations

List<Translation> getTranslations(String ceilingEntityClassname,
                                  String entityId,
                                  String property)

Finds all current translations for the specified field

Parameters:

ceilingEntityClassname -

entityId -

property -

Returns:

the list of translations

getTranslation

Translation getTranslation(TranslatedEntity entity,
                           String entityId,
                           String fieldName,
                           String localeCode)

Attempts to find the translation object for the given parameters

Parameters:

entity -

entityId -

fieldName -

localeCode -

Returns:

the persisted translation

getTranslatedValue

String getTranslatedValue(Object entity,
                          String property,
                          Locale locale)

Returns the translated value of the property for the given entity. For example, if entity is an instance of Product and property is equal to name, this method might return "Hoppin' Hot Sauce" if we are in an English locale and "Salsa de la Muerte Saltante" if we are in a Spanish locale. If a country is set on the locale (locale code en_GB for example), we will first look for a translation that matches en_GB, and then look for a translation for en. If a translated value for the given locale is not available, it will return null.

Parameters:

entity -

property -

locale -

Returns:

the translated value of the property for the given entity