Package com.google.gwt.i18n.server

Class GwtLocaleFactoryImpl

java.lang.Object

com.google.gwt.i18n.server.GwtLocaleFactoryImpl

All Implemented Interfaces:

GwtLocaleFactory

public class GwtLocaleFactoryImpl
extends Object
implements GwtLocaleFactory

Creates server-side GwtLocale instances. Thread-safe.

Constructor Summary

Constructors

Constructor	Description
GwtLocaleFactoryImpl()

Method Summary

Modifier and Type	Method	Description
void	clear()	Clear an embedded cache of instances when they are no longer needed.
GwtLocale	fromComponents(String language, String script, String region, String variant)	Construct a GWT locale from its component parts.
GwtLocale	fromString(String localeName)	Get a GWT locale from a string conforming to a subset of BCP47 (specifically assuming extension tags are not present, at most one variant is present, and grandfathered tags are not supported; also private-use tags are only supported for the entire tag).
GwtLocale	getDefault()	Returns an instance of the default locale.

Methods inherited from class java.lang.Object

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

Constructor Details

GwtLocaleFactoryImpl

public GwtLocaleFactoryImpl()

Method Details

clear

public void clear()

Clear an embedded cache of instances when they are no longer needed.

Note that GwtLocale instances constructed after this is called will not maintain identity with instances constructed before this call.

fromComponents

public GwtLocale fromComponents(String language,
 String script,
 String region,
 String variant)

Description copied from interface: GwtLocaleFactory

Construct a GWT locale from its component parts. Null or empty strings are accepted for parts not present.

Specified by:

fromComponents in interface GwtLocaleFactory

Returns:

GwtLocale instance, unique for a given set of values

fromString

public GwtLocale fromString(String localeName)

Description copied from interface: GwtLocaleFactory

Get a GWT locale from a string conforming to a subset of BCP47 (specifically assuming extension tags are not present, at most one variant is present, and grandfathered tags are not supported; also private-use tags are only supported for the entire tag). Only minimal validation of BCP47 tags is performed, and will continue with what it is able to parse if unexpected input is encountered. A null or empty string is treated as the default locale.

Specified by:

fromString in interface GwtLocaleFactory

Returns:

a locale instance, always the same one for a given localeName

Throws:

IllegalArgumentException - if the supplied locale does not match BCP47 structural requirements.

getDefault

public GwtLocale getDefault()

Description copied from interface: GwtLocaleFactory

Returns an instance of the default locale.

Specified by:

getDefault in interface GwtLocaleFactory