ariba.util.i18n
Class I18NUtil

java.lang.Object
  ariba.util.i18n.I18NUtil

public class I18NUtil
extends Object

Class I18NUtil provides I18N related constants and utility functions

Field Summary

static Locale	Arabic
static String	EncodingASCII We use the standard ASCII encoding for table files because the FormattingSerializer code already converts from Unicode escapes.
static String	EncodingBig5 We use Big5 encoding for the traditional chinese HTML client.
static String	EncodingCp1251 Cp1251 encoding
static String	EncodingCp1252 Cp1252 encoding
static String	EncodingGB2312 We use GB2312 encoding for the simplified chinese HTML client.
static String	EncodingISO8859_1 We use the standard ISO 8859-1 encoding for the old HTML client while it still lives.
static String	EncodingKorean We use GB2312 encoding for the korean HTML client.
static String	EncodingShiftJIS We use the non-standard Shift_JIS encoding for the japanese HTML client.
static String	EncodingUTF_8
static String	EncodingUTF8 We use the standard UTF8 encoding for XML files as well as doing CGI posts to our own server.
static Locale	Hebrew Languages that are not defined in java.util.Locale
static String	Left
static String	LeftToRight HTML direction parameter value
static String	Right
static String	RightToLeft

Constructor Summary

I18NUtil()
Class constructor.

Method Summary

static boolean	enableTooltips(boolean isBrowserNetscape, String encodingString, Locale locale) Returns boolean on whether to enable Tooltips
static Locale	getLocale(String language, String country) Create a Locale object from given language, country, variant
static Locale	getLocale(String language, String country, String localeVariant) Create a Locale object from given language, country, variant
static Locale	getLocaleFromString(String locale) Create a Locale object for the locale specified by a String.
static Locale	getParent(Locale locale) Returns the parent Locale of locale.
static boolean	isBidirectional(Locale locale) Returns true if locale is Hebrew/Arabic
static boolean	isCJK(Locale locale) Returns true if locale is Chinese/Japanese/Korean
static boolean	isLatin1(Locale locale) Returns true if locale is Latin-1: English, Danish, Dutch, French, German, Finnish, Icelandic, Irish, Italian, Spanish, Norwegian, Brazilian, Portuguese.
static String	javaEncodingToIANACharset(String encoding) call this to get the correct CHARSET string to embed in MIME, HTML, or XML.
static String	languageDirection(Locale locale) Returns value for HTML direction attribute according to the locale
static String	languageLeft(Locale locale) Returns value for HTML direction attribute according to the locale
static String	languageRight(Locale locale) Returns value for HTML direction attribute according to the locale
static String	mimeEncoding(String charset) Returns either B or Q mime encoding for the given charset B encoding is BASE64.
static int	stringLengthBytes(String string, String encoding) Deprecated. see LocaleSupport.widthInBytes(String, Locale)
static int	stringWidthWhenPrinted(String string, String encoding) Deprecated. see LocaleSupport.widthInBytes(String, Locale)

Methods inherited from class java.lang.Object

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

Field Detail

Hebrew

public static final Locale Hebrew

Languages that are not defined in java.util.Locale

Arabic

public static final Locale Arabic

LeftToRight

public static final String LeftToRight

HTML direction parameter value

See Also:

Constant Field Values

RightToLeft

public static final String RightToLeft

See Also:

Constant Field Values

Right

public static final String Right

See Also:

Constant Field Values

Left

public static final String Left

See Also:

Constant Field Values

EncodingUTF8

public static final String EncodingUTF8

We use the standard UTF8 encoding for XML files as well as doing CGI posts to our own server.

See Also:

Constant Field Values

EncodingUTF_8

public static final String EncodingUTF_8

See Also:

Constant Field Values

EncodingASCII

public static final String EncodingASCII

We use the standard ASCII encoding for table files because the FormattingSerializer code already converts from Unicode escapes.

See Also:

Constant Field Values

EncodingISO8859_1

public static final String EncodingISO8859_1

We use the standard ISO 8859-1 encoding for the old HTML client while it still lives. Also, we use it as a stop gap for the CSV and File editors...

See Also:

Constant Field Values

EncodingShiftJIS

public static final String EncodingShiftJIS

We use the non-standard Shift_JIS encoding for the japanese HTML client. Because it is super set of standard SJIS.

See Also:

Constant Field Values

EncodingGB2312

public static final String EncodingGB2312

We use GB2312 encoding for the simplified chinese HTML client.

See Also:

Constant Field Values

EncodingBig5

public static final String EncodingBig5

We use Big5 encoding for the traditional chinese HTML client.

See Also:

Constant Field Values

EncodingKorean

public static final String EncodingKorean

We use GB2312 encoding for the korean HTML client.

See Also:

Constant Field Values

EncodingCp1252

public static final String EncodingCp1252

Cp1252 encoding

See Also:

Constant Field Values

EncodingCp1251

public static final String EncodingCp1251

Cp1251 encoding

See Also:

Constant Field Values

Constructor Detail

I18NUtil

public I18NUtil()

Class constructor.

Method Detail

isLatin1

public static boolean isLatin1(Locale locale)

Returns true if locale is Latin-1: English, Danish, Dutch, French, German, Finnish, Icelandic, Irish, Italian, Spanish, Norwegian, Brazilian, Portuguese. The Locale language for Icelanic and Irish is unknown, need to update later.

Parameters:

locale - the locale to decide on

Returns:

boolean

isCJK

public static boolean isCJK(Locale locale)

Returns true if locale is Chinese/Japanese/Korean

Parameters:

locale - the locale to decide on

Returns:

boolean

isBidirectional

public static boolean isBidirectional(Locale locale)

Returns true if locale is Hebrew/Arabic

Parameters:

locale - the locale to get the encoding string of

Returns:

boolean

languageDirection

public static String languageDirection(Locale locale)

Returns value for HTML direction attribute according to the locale

Parameters:

locale - the locale to get the encoding string of

Returns:

String [RTL|LTR]

languageLeft

public static String languageLeft(Locale locale)

Returns value for HTML direction attribute according to the locale

Parameters:

locale - the locale to get the encoding string of

Returns:

String [Right|Left]

languageRight

public static String languageRight(Locale locale)

Returns value for HTML direction attribute according to the locale

Parameters:

locale - the locale to get the encoding string of

Returns:

String [Right|Left]

javaEncodingToIANACharset

public static String javaEncodingToIANACharset(String encoding)

call this to get the correct CHARSET string to embed in MIME, HTML, or XML. These are the preferred names as specified in the IANA registry which is referrenced by these standards. For example: mime charset Content-Type: content=text/html charset="CHARSET" encoded words in header =?CHARSET?encoding?text?= html xml

Parameters:

encoding - the encoding string in java form

Returns:

the encoding string in IANA form

mimeEncoding

public static String mimeEncoding(String charset)

Returns either B or Q mime encoding for the given charset B encoding is BASE64. Q is almost identical to quoted printable. That is, ASCII except for certain characters such as space the have to be escaped. For the full descrition, see rfc.2047 All text can be represented as B. Q is somewhat more legible for Latin scripts since it preserves ASCII

Parameters:

charset - the charset string

Returns:

B or Q mime encoding

getLocale

public static Locale getLocale(String language,
                               String country)

Create a Locale object from given language, country, variant

Parameters:

language - locale language

country - locale country

Returns:

a new Locale object for the given language & country strings.

getLocale

public static Locale getLocale(String language,
                               String country,
                               String localeVariant)

Create a Locale object from given language, country, variant

Parameters:

language - locale language

country - locale country

localeVariant - locale variant

Returns:

a new Locale object for the given language, country, and variant strings.

getLocaleFromString

public static Locale getLocaleFromString(String locale)

Create a Locale object for the locale specified by a String.

Parameters:

locale - Locale description string in the form of Locale.toString() (e.g. "en_US").

Returns:

a new Locale object for the given locale string.

getParent

public static Locale getParent(Locale locale)

Returns the parent Locale of locale.

By parent we mean the Locale that logically contains the passed-in Locale (where language is deemed to contain country which is deemed to contain variant.

Thus 'en' is the parent of 'en_US' and 'fr_FR' is the parent of 'fr_FR_var'. Top-level Locales (those that specify languages only) do not have a parent and null is returned.

Parameters:

locale - the Locale, whose parent we wish to find; may not be null

Returns:

the parent Locale or null if there is no parent

enableTooltips

public static boolean enableTooltips(boolean isBrowserNetscape,
                                     String encodingString,
                                     Locale locale)

Returns boolean on whether to enable Tooltips

Parameters:

isBrowserNetscape - someone's still using Netscape?

encodingString - the HTML encoding

locale - the user's Locale

Returns:

enable Tooltips?

stringWidthWhenPrinted

public static int stringWidthWhenPrinted(String string,
                                         String encoding)

Deprecated. see LocaleSupport.widthInBytes(String, Locale)

Calculate string width in ASCII character when printed. 8859_1 chacaters occupies same width when printed. Japanese Kanji-charcter occupies twice of ASCII character's width. Currentry used in BaseObjectOnServer. and TextUtil.

Parameters:

string - printed string

encoding - string encoding

Returns:

printed width of string

stringLengthBytes

public static int stringLengthBytes(String string,
                                    String encoding)

Deprecated. see LocaleSupport.widthInBytes(String, Locale)

Calculate byte count of String in specified encoding.

Parameters:

string - string

encoding - encoding

Returns:

byte count of string when string is converted with specified encoding.