org.gomoob.model.translation

Class AbstractTranslatableEntity<IDT extends Serializable>

java.lang.Object

org.gomoob.model.AbstractEntity<IDT>

org.gomoob.model.translation.AbstractTranslatableEntity<IDT>

Type Parameters:

IDT - the type of the technical identifier associated to this entity.

All Implemented Interfaces:

IEntity<IDT>, ITranslatableEntity<IDT>

Direct Known Subclasses:

AbstractTranslatableEntityWithCreationDate

public abstract class AbstractTranslatableEntity<IDT extends Serializable>
extends AbstractEntity<IDT>
implements ITranslatableEntity<IDT>

Abstract class to be extended by Translatable Business entities.

Author:

Simon BAUDRY (simon.baudry@gomoob.com)

Field Summary

Fields inherited from class org.gomoob.model.AbstractEntity

id

Constructor Summary

Constructors

Constructor and Description
AbstractTranslatableEntity()

Method Summary

Modifier and Type	Method and Description
void	applyTranslation(String languageCode) Apply an existing translation on this translatable entity.
void	deleteTranslation(String languageCode) Deletes an existing translation from this translatable entity.
void	deleteTranslations(List<String> languageCodes) Function used to delete one or multiple existing translations from the entity.
String	getDefaultLanguageCode() Gets the language code which was used when the entity was created.
ITranslation	getTranslation(String languageCode) Gets a translation (corresponding to a specified language code) for the entity.
String	getTranslationLanguageCode() Gets the language code associated to translations which have been applied to the entity.
Map<String,ITranslation>	getTranslations() Gets multiple translations in multiple languages for this translatable entity.
Boolean	isTranslated() Function used to indicate if the entity has been translated of if its fields are in its default language.
void	setDefaultLanguageCode(String defaultLanguageCode) Sets the language code which was used when the entity was created.
void	setTranslation(ITranslation translation) Adds a new translation or update an existing one for the entity.
void	setTranslationLanguageCode(String translationLanguageCode) Sets the language code associated to the translations which have been applied to the entity.
void	setTranslations(Map<String,ITranslation> translations) Sets multiple translations in multiple languages for this translatable entity.

Methods inherited from class org.gomoob.model.AbstractEntity

get, getId, set, setId

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.gomoob.model.IEntity

get, getId, set, setId

Constructor Detail

AbstractTranslatableEntity

public AbstractTranslatableEntity()

Method Detail

applyTranslation

public void applyTranslation(String languageCode)

Apply an existing translation on this translatable entity.

Specified by:

applyTranslation in interface ITranslatableEntity<IDT extends Serializable>

Parameters:

languageCode - The code of the targeted language translation.

deleteTranslation

public void deleteTranslation(String languageCode)

Deletes an existing translation from this translatable entity.

WARNING: The provided language code is not case sensitive, but, internally the language code which is used and stored is ALWAYS converted in uppercase.

Specified by:

deleteTranslation in interface ITranslatableEntity<IDT extends Serializable>

Parameters:

languageCode - The code of the language for which one to delete a translation.

deleteTranslations

public void deleteTranslations(List<String> languageCodes)

Function used to delete one or multiple existing translations from the entity.

WARNING: The provided language codes are not case sensitive, but, internally the language codes which are used and stored are ALWAYS converted in uppercase.

Specified by:

deleteTranslations in interface ITranslatableEntity<IDT extends Serializable>

Parameters:

languageCodes - An array with language codes associated to translations to be deleted, if this parameter is `null` then all the translations are deleted.

getDefaultLanguageCode

public String getDefaultLanguageCode()

Gets the language code which was used when the entity was created. In most cases this is the language which was used by the user who created the entity.

WARNING: The language code returned by this function is always expressed in uppercase even if you provided a language code to the entity using a lower case syntax. Internally translatable entities always store language codes in upper case.

Specified by:

getDefaultLanguageCode in interface ITranslatableEntity<IDT extends Serializable>

Returns:

The default language code, the returned string is compliant with the ISO639-1 standard.

getTranslation

public ITranslation getTranslation(String languageCode)

Gets a translation (corresponding to a specified language code) for the entity. This function picks on of the translation returned by the `getTranslations()` function.

WARNING: The provided language code is not case sensitive, but, internally the language code which is used and stored is ALWAYS converted in uppercase.

Specified by:

getTranslation in interface ITranslatableEntity<IDT extends Serializable>

Parameters:

languageCode - The language code for which one to get a translation.

Returns:

The found translation.

getTranslationLanguageCode

public String getTranslationLanguageCode()

Gets the language code associated to translations which have been applied to the entity. The translation language code is only set if the entity is translated (that's to say its fields are translated in a different language than the default language code).

The translation language code should only be used when you have to translate an entity in one language to display informations on a GUI (also in one language). If you have to create a GUI for persons responsible of the translations (i.e the translators) then you'll need to attach all the available translations in all languages to you entities. In this cas you should used the `getTranslations()` and `setTranslations()` functions to manage a list of all the translations in all languages attached to the entity. WARNING: The provided language code is not case sensitive, but, internally the language code which is used and stored is ALWAYS converted in uppercase.

Specified by:

getTranslationLanguageCode in interface ITranslatableEntity<IDT extends Serializable>

Returns:

The translation language code, the returned string is compliant with ISO639-1 standard.

getTranslations

public Map<String,ITranslation> getTranslations()

Gets multiple translations in multiple languages for this translatable entity. This function is used when you have to display multiple translations in multiple languages on a GUI, in most cases thoses GUIs are dedicated to persons responsible of the translations (i.e the translators). When you use multiple translations in multiple languages attached to an entity the metadata attached to the entity stays in the default language specified by the default language code. The returned multiple translations should not contain translations for the default language.

If you have to display an entity in only one language then do not use the `getTranslations()` and `setTranslations()` function but prefer the `getTranslationLanguageCode()` and `setTranslationLanguageCode()` functions which are used to manage only one translation (i.e in only one language), that's to say to translate the entity in one target language only.

Specified by:

getTranslations in interface ITranslatableEntity<IDT extends Serializable>

Returns:

The translations in multiple languages attached to this translatable entity.

isTranslated

public Boolean isTranslated()

Function used to indicate if the entity has been translated of if its fields are in its default language. An entity is translated when its `translationLanguageCode` is not `null` or if its associated to at least one translation (i.e the `getTranslations()` function returns a not empty array. This function is convenient when, after having trying to translate an entity you want to know if translations for this entity have been found. If no translations have been found the entity should stay intact and should not be modified.

Specified by:

isTranslated in interface ITranslatableEntity<IDT extends Serializable>

Returns:

`true` if the entity is translated, `false` otherwise.

setDefaultLanguageCode

public void setDefaultLanguageCode(String defaultLanguageCode)

Sets the language code which was used when the entity was created. In most cases this is the language which was used by the user who created the entity.

WARNING: The provided language code is not case sensitive, but, internally the language code which is used and stored is ALWAYS converted in uppercase.

Specified by:

setDefaultLanguageCode in interface ITranslatableEntity<IDT extends Serializable>

Parameters:

defaultLanguageCode - The default language code to set, this string must be compliant with the ISO639-1 standard.

setTranslationLanguageCode

public void setTranslationLanguageCode(String translationLanguageCode)

Sets the language code associated to the translations which have been applied to the entity. The translation language code must only be set if the entity is translated (that's to say its fields have been translated in a different language than the default language code).

The translation language code should only be used when you have to translate an entity in one language to display informations on a GUI (also in one language). If you have to create a GUI for persons responsible of the translations (i.e the translators) then you'll need to attach all the available translations in all languages to you entities. In this cas you should used the `getTranslations()` and `setTranslations()` functions to manage a list of all the translations in all languages attached to the entity. WARNING: The provided language code is not case sensitive, but, internally the language code which is used and stored is ALWAYS converted in uppercase.

Specified by:

setTranslationLanguageCode in interface ITranslatableEntity<IDT extends Serializable>

Parameters:

translationLanguageCode - The translation language code to set, this string must be compliant with the ISO639-1 standard.

setTranslation

public void setTranslation(ITranslation translation)

Adds a new translation or update an existing one for the entity.

Specified by:

setTranslation in interface ITranslatableEntity<IDT extends Serializable>

Parameters:

translation - The new translation to add or an existing translation to update.

setTranslations

public void setTranslations(Map<String,ITranslation> translations)

Sets multiple translations in multiple languages for this translatable entity. This function is used when you have to display multiple translations in multiple languages on a GUI, in most cases thoses GUIs are dedicated to persons responsible of the translations (i.e the translators). When you use multiple translations in multiple languages attached to an entity the metadata attached to the entity stays in the default language specified by the default language code. The returned multiple translations should not contain translations for the default language.

If you have to display an entity in only one language then do not use the `getTranslations()` and `setTranslations()` function but prefer the `getTranslationLanguageCode()` and `setTranslationLanguageCode()` functions which are used to manage only one translation (i.e in only one language), that's to say to translate the entity in one target language only.

Specified by:

setTranslations in interface ITranslatableEntity<IDT extends Serializable>

Parameters:

translations - The translations to set.