anon.util

Class LanguageMapper

java.lang.Object

anon.util.AbstractISOCodeMapper

anon.util.LanguageMapper

public class LanguageMapper
extends AbstractISOCodeMapper

Objects of this class store a language code and can translate it into the localised name of the corresponding language. The default locale of this class is bound to the locale used in JAPMessages.

Version:

ISO 639 on 27.12.05

Author:

Rolf Wendolsky

See Also:

JAPMessages, http://www.w3.org/WAI/ER/IG/ert/iso639.htm

Constructor Summary

Constructors

Constructor and Description
LanguageMapper() Constructs an empty LanguageMapper object.
LanguageMapper(int a_maxTextLength) Constructs an empty LanguageMapper object.
LanguageMapper(java.lang.String a_ISOCode) Constructs a new LanguageMapper that uses the default Locale to translate its language code.
LanguageMapper(java.lang.String a_ISOCode, int a_maxTextLength) Constructs a new LanguageMapper that uses the default Locale to translate its language code.
LanguageMapper(java.lang.String a_ISOCode, int a_maxTextLength, java.util.Locale a_locale) Constructs a new LanguageMapper that uses a specific Locale to translate its language code.
LanguageMapper(java.lang.String a_ISOCode, java.util.Locale a_locale) Constructs a new LanguageMapper that uses a specific Locale to translate its language code.

Method Summary

Modifier and Type	Method and Description
java.util.Locale	getLocale() Returns a Locale object constructed from the language code.
java.util.Locale	getLocale(java.lang.String a_countryCode) Creates a Locale object from the language code and a given country code.
static java.util.Vector	getLocalisedLanguages() Returns a Vector with LanguageMappers for all officially assigned language codes.
static java.util.Vector	getLocalisedLanguages(int a_maxTextLength) Returns a Vector with LanguageMappers for all officially assigned language codes.
static java.util.Vector	getLocalisedLanguages(int a_maxTextLength, java.util.Locale a_loc) Returns a Vector with LanguageMappers for all officially assigned language codes.
static java.util.Vector	getLocalisedLanguages(java.util.Locale a_loc) Returns a Vector with LanguageMappers for all officially assigned language codes.

Methods inherited from class anon.util.AbstractISOCodeMapper

equals, getISOCode, hashCode, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

LanguageMapper

public LanguageMapper()

Constructs an empty LanguageMapper object. Its toString() method returns a message that requests to choose a valid language code. The message is defined by the default Locale.

LanguageMapper

public LanguageMapper(int a_maxTextLength)

Constructs an empty LanguageMapper object. Its toString() method returns a message that requests to choose a valid language code. The message is defined by the default Locale.

Parameters:

a_maxTextLength - the maximum length of the toString() output

LanguageMapper

public LanguageMapper(java.lang.String a_ISOCode,
                      int a_maxTextLength)
               throws java.lang.IllegalArgumentException

Constructs a new LanguageMapper that uses the default Locale to translate its language code.

Parameters:

a_ISOCode - a two-letter language code

a_maxTextLength - the maximum length of the toString() output

Throws:

java.lang.IllegalArgumentException

See Also:

getLocalisedCountries(int)

LanguageMapper

public LanguageMapper(java.lang.String a_ISOCode)
               throws java.lang.IllegalArgumentException

Constructs a new LanguageMapper that uses the default Locale to translate its language code.

Parameters:

a_ISOCode - a two-letter language code

Throws:

java.lang.IllegalArgumentException

See Also:

getLocalisedCountries(int)

LanguageMapper

public LanguageMapper(java.lang.String a_ISOCode,
                      java.util.Locale a_locale)
               throws java.lang.IllegalArgumentException

Constructs a new LanguageMapper that uses a specific Locale to translate its language code.

Parameters:

a_ISOCode - a two-letter language code

a_locale - a Locale

Throws:

java.lang.IllegalArgumentException

See Also:

getLocalisedCountries(int, Locale)

LanguageMapper

public LanguageMapper(java.lang.String a_ISOCode,
                      int a_maxTextLength,
                      java.util.Locale a_locale)
               throws java.lang.IllegalArgumentException

Constructs a new LanguageMapper that uses a specific Locale to translate its language code.

Parameters:

a_ISOCode - a two-letter language code

a_locale - a Locale

a_maxTextLength - the maximum length of the toString() output

Throws:

java.lang.IllegalArgumentException

See Also:

getLocalisedCountries(int, Locale)

Method Detail

getLocale

public java.util.Locale getLocale()

Returns a Locale object constructed from the language code.

Returns:

a Locale object constructed from the language code

getLocale

public java.util.Locale getLocale(java.lang.String a_countryCode)

Creates a Locale object from the language code and a given country code.

Parameters:

a_countryCode - an ISO country code

Returns:

a Locale object from the language code and a given country code

See Also:

CountryMapper

getLocalisedLanguages

public static java.util.Vector getLocalisedLanguages()

Returns a Vector with LanguageMappers for all officially assigned language codes. The constructed LanguageMappers use the default locale.

Returns:

a Vector with LanguageMappers for all officially assigned language codes

getLocalisedLanguages

public static java.util.Vector getLocalisedLanguages(java.util.Locale a_loc)

Returns a Vector with LanguageMappers for all officially assigned language codes. The constructed LanguageMappers use the default locale.

Parameters:

a_loc - the locale that is used in all contructed LanguageMappers

Returns:

a Vector with LanguageMappers for all officially assigned language codes

getLocalisedLanguages

public static java.util.Vector getLocalisedLanguages(int a_maxTextLength)

Returns a Vector with LanguageMappers for all officially assigned language codes. The constructed LanguageMappers use the default locale.

Parameters:

a_maxTextLength - the maximum length of the toString() output

Returns:

a Vector with LanguageMappers for all officially assigned language codes

getLocalisedLanguages

public static java.util.Vector getLocalisedLanguages(int a_maxTextLength,
                                                     java.util.Locale a_loc)

Returns a Vector with LanguageMappers for all officially assigned language codes.

Parameters:

a_loc - the locale that is used in all constructed LanguageMappers

a_maxTextLength - the maximum length of the toString() output

Returns:

a Vector with LanguageMappers for all officially assigned language codes