es.situm.sdk.model

Class I18nString

java.lang.Object

es.situm.sdk.model.I18nString

All Implemented Interfaces:

android.os.Parcelable

public final class I18nString
extends Object
implements android.os.Parcelable

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.

Nested classes/interfaces inherited from interface android.os.Parcelable

android.os.Parcelable.ClassLoaderCreator<T>, android.os.Parcelable.Creator<T>

Field Summary

Fields

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

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

Constructors

Constructor and Description
I18nString(Map<String,String> values)

Method Summary

Modifier and Type	Method and Description
String	defaultValue()
int	describeContents()
boolean	equals(Object o)
String	get(Locale locale) Obtains the string in the provided Locale's language Wraps get(String), using Locale.getISO3Language() to take language code.
String	get(String language) Obtains the string in the provided language.
boolean	has(String language) Check if the language is supported by this I18nString
int	hashCode()
String	toString()
void	writeToParcel(android.os.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 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 android.os.Parcelable.Creator<I18nString> CREATOR

Constructor Detail

I18nString

public I18nString(Map<String,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 String get(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 String get(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:

IllegalArgumentException - if locale is null

defaultValue

public String defaultValue()

has

public boolean has(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(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

describeContents

public int describeContents()

Specified by:

describeContents in interface android.os.Parcelable

writeToParcel

public void writeToParcel(android.os.Parcel dest,
                          int flags)

Specified by:

writeToParcel in interface android.os.Parcelable