com.google.gwt.i18n.server
Class GwtLocaleImpl

java.lang.Object
  com.google.gwt.i18n.server.GwtLocaleImpl

All Implemented Interfaces:

GwtLocale, java.lang.Comparable<GwtLocale>

public class GwtLocaleImpl
extends java.lang.Object
implements GwtLocale

Class representing GWT locales and conversion to/from other formats. These locales correspond to BCP47.

compareTo

public int compareTo(GwtLocale o)

Description copied from interface: GwtLocale

The default comparison is a lexical ordering.

Specified by:

compareTo in interface GwtLocale

Specified by:

compareTo in interface java.lang.Comparable<GwtLocale>

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

getAliases

public java.util.List<GwtLocale> getAliases()

Description copied from interface: GwtLocale

Return the list of aliases for this locale. The canonical form of the current locale is always first on the list. Language/region codes have changed over time, so some systems continue to use the older codes. Aliases allow GWT to use the official Unicode CLDR locales while still interoperating with such systems.

Specified by:

getAliases in interface GwtLocale

Returns:

alias list

getAsString

public java.lang.String getAsString()

Description copied from interface: GwtLocale

Return the locale as a fixed-format string suitable for use in searching for localized resources. The format is language_Script_REGION_VARIANT, where language is a 2-8 letter code (possibly with 3-letter extensions), script is a 4-letter code with an initial capital letter, region is a 2-character country code or a 3-digit region code, and variant is a 5-8 character (may be 4 if the first character is numeric) code. If a component is missing, its preceding _ is also omitted. If this is the default locale, the empty string will be returned.

Specified by:

getAsString in interface GwtLocale

Returns:

String representing locale

getCanonicalForm

public GwtLocale getCanonicalForm()

Returns this locale in canonical form. Changes for canonical form are:

• Deprecated language/region tags are replaced with official versions

Specified by:

getCanonicalForm in interface GwtLocale

Returns:

GwtLocale instance

getCompleteSearchList

public java.util.List<GwtLocale> getCompleteSearchList()

Description copied from interface: GwtLocale

Return the complete list of locales to search for the current locale. This list will always start with the canonical form of this locale, and end with "default", and include all appropriate aliases along the way.

Specified by:

getCompleteSearchList in interface GwtLocale

Returns:

search list

getInheritanceChain

public java.util.List<GwtLocale> getInheritanceChain()

Return a list of locales to search for, in order of preference. The current locale is always first on the list. Aliases are not included in the list -- use getAliases() to expand those.

Specified by:

getInheritanceChain in interface GwtLocale

Returns:

inheritance list

getLanguage

public java.lang.String getLanguage()

Specified by:

getLanguage in interface GwtLocale

Returns:

the language portion of the locale, or null if none.

getLanguageNotNull

public java.lang.String getLanguageNotNull()

Specified by:

getLanguageNotNull in interface GwtLocale

Returns:

the language portion of the locale, or the empty string if none.

getRegion

public java.lang.String getRegion()

Specified by:

getRegion in interface GwtLocale

Returns:

the region portion of the locale, or null if none.

getRegionNotNull

public java.lang.String getRegionNotNull()

Specified by:

getRegionNotNull in interface GwtLocale

Returns:

the region portion of the locale, or the empty string if none.

getScript

public java.lang.String getScript()

Specified by:

getScript in interface GwtLocale

Returns:

the script portion of the locale, or null if none.

getScriptNotNull

public java.lang.String getScriptNotNull()

Specified by:

getScriptNotNull in interface GwtLocale

Returns:

the script portion of the locale, or the empty string if none.

getVariant

public java.lang.String getVariant()

Specified by:

getVariant in interface GwtLocale

Returns:

the variant portion of the locale, or null if none.

getVariantNotNull

public java.lang.String getVariantNotNull()

Specified by:

getVariantNotNull in interface GwtLocale

Returns:

the variant portion of the locale, or the empty string if none.

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

inheritsFrom

public boolean inheritsFrom(GwtLocale parent)

Return true if this locale inherits from the specified locale. Note that locale.inheritsFrom(locale) is false -- if you want that to be true, you should just use locale.getInheritanceChain().contains(x).

Specified by:

inheritsFrom in interface GwtLocale

Parameters:

parent - locale to test against

Returns:

true if parent is an ancestor of this locale

isDefault

public boolean isDefault()

Specified by:

isDefault in interface GwtLocale

Returns:

true if this is the default or root locale.

toString

public java.lang.String toString()

Specified by:

toString in interface GwtLocale

Overrides:

toString in class java.lang.Object

Returns:

a human readable string -- "default" or the same as getAsString().

usesSameScript

public boolean usesSameScript(GwtLocale other)

Checks if this locale uses the same script as another locale, taking into account default scripts.

Specified by:

usesSameScript in interface GwtLocale

Parameters:

other -

Returns:

true if the scripts are the same