org.exoplatform.commons.utils

Class I18N

java.lang.Object

org.exoplatform.commons.utils.I18N

public class I18N
extends Object

Various I18N utility methods.

Author:

Julien Viet

Constructor Summary

Constructors

Constructor and Description
I18N()

Method Summary

Modifier and Type	Method and Description
static Locale	getParent(Locale locale) Returns the parent locale of a locale or null when it does not have one.
static Locale	parseJavaIdentifier(String s) Parse the java string representation and returns a locale.
static Locale	parseTagIdentifier(String s) Parse the http://www.ietf.org/rfc/rfc1766.txt string representation and returns a locale.
static String	toJavaIdentifier(Locale locale) Provide a string representation of the locale argument to the Locale.toString() method.
static String	toTagIdentifier(Locale locale) Provide a string representation of the locale argument according to the http://www.ietf.org/rfc/rfc1766.txt : locale with a language only will return the language string otherwise it returns the language and country separated by an hyphen '-'

Methods inherited from class java.lang.Object

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

Constructor Detail

I18N

public I18N()

Method Detail

toJavaIdentifier

public static String toJavaIdentifier(Locale locale)
                               throws NullPointerException

Provide a string representation of the locale argument to the Locale.toString() method.

Parameters:

locale - the locale

Returns:

the java representation

Throws:

NullPointerException - if the locale argument is null

parseJavaIdentifier

public static Locale parseJavaIdentifier(String s)
                                  throws NullPointerException,
                                         IllegalArgumentException

Parse the java string representation and returns a locale. See toJavaIdentifier(java.util.Locale) method for more details.

Parameters:

s - the java representation to parse

Returns:

the corresponding locale

Throws:

NullPointerException - if the locale argument is null

IllegalArgumentException - if the string cannot be parsed to a locale

toTagIdentifier

public static String toTagIdentifier(Locale locale)
                              throws NullPointerException

Provide a string representation of the locale argument according to the http://www.ietf.org/rfc/rfc1766.txt :

• locale with a language only will return the language string
• otherwise it returns the language and country separated by an hyphen '-'

Parameters:

locale - the locale

Returns:

the RFC1766 representation

Throws:

NullPointerException - if the locale argument is null

parseTagIdentifier

public static Locale parseTagIdentifier(String s)
                                 throws NullPointerException,
                                        IllegalArgumentException

Parse the http://www.ietf.org/rfc/rfc1766.txt string representation and returns a locale. See toTagIdentifier(java.util.Locale) method for more details.

Parameters:

s - the RFC1766 representation to parse

Returns:

the corresponding locale

Throws:

NullPointerException - if the locale argument is null

IllegalArgumentException - if the string cannot be parsed to a locale

getParent

public static Locale getParent(Locale locale)
                        throws NullPointerException

Returns the parent locale of a locale or null when it does not have one.

Parameters:

locale - the locale

Returns:

the parent locale

Throws:

NullPointerException - if the specified locale is null