es.situm.sdk.model

Class I18nString

java.lang.Object

es.situm.sdk.model.I18nString

public final class I18nString
extends java.lang.Object

A string with a different value depending of the language. It's recommended to support a default value defaultValue() (optional) for non supported languages.

ISO 639-2 is used to identify the languages.

See Also:

Locale.getISO3Language()

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	I18nString.Builder Allows creating a I18nString in a handier way.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ANY_LANGUAGE Special code, non ISO 693-2, to denote value to use by default.
static <any>	CREATOR
static I18nString	EMPTY

Constructor Summary

Constructors

Constructor and Description
I18nString(java.util.Map<java.lang.String,java.lang.String> values)

Method Summary

Modifier and Type	Method and Description
java.lang.String	defaultValue()
int	describeContents()
boolean	equals(java.lang.Object o)
java.lang.String	get(java.util.Locale locale) Obtains the string in the provided Locale's language Wraps get(String), using Locale.getISO3Language() to take language code.
java.lang.String	get(java.lang.String language) Obtains the string in the provided language.
boolean	has(java.lang.String language) Check if the language is supported by this I18nString
int	hashCode()
java.lang.String	toString()
void	writeToParcel(Parcel dest, int flags)

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Field Detail

EMPTY

public static final I18nString EMPTY

ANY_LANGUAGE

public static final java.lang.String ANY_LANGUAGE

Special code, non ISO 693-2, to denote value to use by default.

See Also:

Constant Field Values

CREATOR

public static final <any> CREATOR

Constructor Detail

I18nString

public I18nString(java.util.Map<java.lang.String,java.lang.String> values)

Parameters:

values - non null map, with non null keys and values. Keys should be language's ISO 693-2 codes

Method Detail

get

public java.lang.String get(java.lang.String language)

Obtains the string in the provided language. If there is no value for that language, return value for ANY_LANGUAGE

Parameters:

language - ISO 639-2 language name representation, or ANY_LANGUAGE. If is null, will check for ANY_LANGUAGE

Returns:

String. Empty if there is no value for this language, or if provided language is null or empty.

get

public java.lang.String get(java.util.Locale locale)

Obtains the string in the provided Locale's language Wraps get(String), using Locale.getISO3Language() to take language code.

Parameters:

locale - its Locale.getISO3Language() stands for the language.

Returns:

String. Empty if there is no value for this language.

Throws:

java.lang.IllegalArgumentException - if locale is null

defaultValue

public java.lang.String defaultValue()

has

public boolean has(java.lang.String language)

Check if the language is supported by this I18nString

Parameters:

language - ISO 639-2 language name representation. Not null.

Returns:

true if there is some value for this string, false otherwise.

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

describeContents

public int describeContents()

writeToParcel

public void writeToParcel(Parcel dest,
                          int flags)