Package com.helger.commons.text

Class AbstractMapBasedMultilingualText

java.lang.Object

com.helger.commons.text.AbstractHasText

com.helger.commons.text.AbstractReadOnlyMapBasedMultilingualText

com.helger.commons.text.AbstractMapBasedMultilingualText

All Implemented Interfaces:

IClearable, IHasText, IHasTextWithArgs, IMultilingualText, IMutableMultilingualText, Serializable

Direct Known Subclasses:

MultilingualText

@NotThreadSafe
public abstract class AbstractMapBasedMultilingualText
extends AbstractReadOnlyMapBasedMultilingualText
implements IMutableMultilingualText

A Map based implementation of IMultilingualText that does also provide writing methods to the outside and is only to be used as a non-abstract base class.

Author:

Philip Helger

See Also:

• Serialized Form

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractMapBasedMultilingualText()
protected	AbstractMapBasedMultilingualText(ICommonsOrderedMap<Locale,String> aMapToUse)	Protected constructor that specifies the underlying Map to use.

Method Summary

Modifier and Type	Method	Description
final EChange	addText(Locale aContentLocale, String sText)	Add a text in the specified locale.
final EChange	assignFrom(IMultilingualText aMLT)	Assign all fields from the passed object.
final CallbackList<IChangeCallback<IMutableMultilingualText>>	changeNotifyCallbacks()
boolean	equals(Object o)
int	hashCode()
final EChange	removeAll()	Reset the contents of the element to the after-construction state.
final EChange	removeText(Locale aContentLocale)	Remove the text with the specified locale.
final EChange	setText(Locale aContentLocale, String sText)	Set a text in the specified locale.
String	toString()

Methods inherited from class com.helger.commons.text.AbstractReadOnlyMapBasedMultilingualText

containsLocaleWithFallback, internalAddText, internalAddText, internalGetLocaleToUseWithFallback, internalGetText, internalSetText, isPerformConsistencyChecks, setPerformConsistencyChecks, texts

Methods inherited from class com.helger.commons.text.AbstractHasText

getText

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.helger.commons.text.IHasText

getAsHasDisplayText, getText

Methods inherited from interface com.helger.commons.text.IHasTextWithArgs

getAsHasDisplayTextWithArgs, getTextWithArgs, getTextWithArgs

Methods inherited from interface com.helger.commons.text.IMultilingualText

containsLocaleWithFallback, texts

Constructor Details

AbstractMapBasedMultilingualText

protected AbstractMapBasedMultilingualText()

AbstractMapBasedMultilingualText

protected AbstractMapBasedMultilingualText(@Nonnull
 ICommonsOrderedMap<Locale,String> aMapToUse)

Protected constructor that specifies the underlying Map to use. Use this constructor to e.g. provide a concurrent HashMap or similar.

Parameters:

aMapToUse - The map to use. Must not be null and must be writable.

Method Details

addText

@Nonnull
public final EChange addText(@Nonnull
 Locale aContentLocale,
 @Nullable
 String sText)

Description copied from interface: IMutableMultilingualText

Add a text in the specified locale. If a text with the same locale is already present, false is returned.

Specified by:

addText in interface IMutableMultilingualText

Parameters:

aContentLocale - The locale in which the text should be set. May not be null.

sText - The text to be set. May be null.

Returns:

EChange.CHANGED if the text was added, EChange.UNCHANGED otherwise.

setText

@Nonnull
public final EChange setText(@Nonnull
 Locale aContentLocale,
 @Nullable
 String sText)

Description copied from interface: IMutableMultilingualText

Set a text in the specified locale. If a text with the same locale is already present, the old value is overwritten.

Specified by:

setText in interface IMutableMultilingualText

Parameters:

aContentLocale - The locale in which the text should be set. May not be null .

sText - The text to be set. May be null.

Returns:

EChange.CHANGED if the text was set, EChange.UNCHANGED otherwise.

removeText

@Nonnull
public final EChange removeText(@Nonnull
 Locale aContentLocale)

Description copied from interface: IMutableMultilingualText

Remove the text with the specified locale.

Specified by:

removeText in interface IMutableMultilingualText

Parameters:

aContentLocale - The locale to be removed. May not be null.

Returns:

EChange.CHANGED if the text was remove, EChange.UNCHANGED otherwise.

removeAll

@Nonnull
public final EChange removeAll()

Description copied from interface: IClearable

Reset the contents of the element to the after-construction state.

Specified by:

removeAll in interface IClearable

Returns:

EChange.CHANGED if at least one element was cleared, EChange.UNCHANGED otherwise.

assignFrom

@Nonnull
public final EChange assignFrom(@Nonnull
 IMultilingualText aMLT)

Description copied from interface: IMutableMultilingualText

Assign all fields from the passed object. All existing texts are removed!

Specified by:

assignFrom in interface IMutableMultilingualText

Parameters:

aMLT - The object to read the content from. May not be null.

Returns:

EChange.CHANGED if the assignment changed anything, EChange.UNCHANGED otherwise.

changeNotifyCallbacks

@Nonnull
@ReturnsMutableObject("design")
public final CallbackList<IChangeCallback<IMutableMultilingualText>> changeNotifyCallbacks()

Specified by:

changeNotifyCallbacks in interface IMutableMultilingualText

Returns:

The change notify callbacks. Never null.

equals

public boolean equals(Object o)

Overrides:

equals in class AbstractReadOnlyMapBasedMultilingualText

hashCode

public int hashCode()

Overrides:

hashCode in class AbstractReadOnlyMapBasedMultilingualText

toString

@OverridingMethodsMustInvokeSuper
public String toString()

Overrides:

toString in class AbstractReadOnlyMapBasedMultilingualText