org.stellarium
Class Translator

java.lang.Object
  org.stellarium.Translator

public class Translator
extends java.lang.Object

Class used to translate strings to any language. Implements a nice interface to gettext which is UTF-8 compliant and is somewhat multiplateform All its operations do not modify the global locale. The purpose of this class is to remove all non-OO C locale functions from stellarium. It could be extended for all locale management using e.g the portable IBM ICU library.

Version:

24 oct. 2006 01:07:47

Author:

Fabien Chereau for original C++ version

TODO FRED: Reimplement in Java getext, we should be quite straigth forward. Basically we need to read the .po files and make a map of language (Locale), englishMsgId, translation, Jerome Beau

Nested Class Summary

(package private) static class

Translator.POResourceBundle

Field Summary

private java.util.ResourceBundle	bundle
(package private) java.lang.String	domain The domain name
private static Translator	globalTranslator
(package private) static java.util.Map<java.lang.String,java.lang.String>	iso639codes Contains the list of all iso639 languages codes
(package private) java.lang.String	langName The two letter string defining the current language name
(package private) static Translator	lastUsed Keep in memory which one was the last used transator to prevent reloading it at each tranlate() call
private static java.lang.String	PO_COMMENT_START
private static java.lang.String	PO_KEY
private static java.lang.String	PO_VALUE
(package private) static java.lang.String	systemLangName Store the system default language name as taken from LANGUAGE environement variable

Constructor Summary

Translator()

Translator(java.lang.String language)

Method Summary

static Translator	getGlobalTranslator()
java.lang.String	getTrueLocaleName()
static void	initIso639_1LanguageCodes(java.lang.String fileName) Initialize the languages code list from the passed file
static void	initSystemLanguage() Try to determine system language from system configuration
static java.lang.String	nativeLanguageNameCodeToIso639_1(java.lang.String current)
private void	reload()
static void	setGlobalTranslator(Translator p0)
java.lang.String	translate(java.lang.String s) Translate input message.
(package private) java.lang.String	translateUTF8(java.lang.String s) Translate input message.

Methods inherited from class java.lang.Object

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

Field Detail

globalTranslator

private static Translator globalTranslator

PO_KEY

private static final java.lang.String PO_KEY

See Also:

Constant Field Values

PO_VALUE

private static final java.lang.String PO_VALUE

See Also:

Constant Field Values

PO_COMMENT_START

private static final java.lang.String PO_COMMENT_START

See Also:

Constant Field Values

bundle

private java.util.ResourceBundle bundle

domain

java.lang.String domain

The domain name

langName

java.lang.String langName

The two letter string defining the current language name

lastUsed

static Translator lastUsed

Keep in memory which one was the last used transator to prevent reloading it at each tranlate() call

systemLangName

static java.lang.String systemLangName

Store the system default language name as taken from LANGUAGE environement variable

iso639codes

static java.util.Map<java.lang.String,java.lang.String> iso639codes

Contains the list of all iso639 languages codes

Constructor Detail

Translator

public Translator()

Translator

public Translator(java.lang.String language)

Method Detail

initSystemLanguage

public static void initSystemLanguage()

Try to determine system language from system configuration

initIso639_1LanguageCodes

public static void initIso639_1LanguageCodes(java.lang.String fileName)
                                      throws StellariumException

Initialize the languages code list from the passed file

Parameters:

fileName - file containing the list of language codes

Throws:

StellariumException

getGlobalTranslator

public static Translator getGlobalTranslator()

setGlobalTranslator

public static void setGlobalTranslator(Translator p0)

translateUTF8

java.lang.String translateUTF8(java.lang.String s)

Translate input message.

Parameters:

s - input string in english.

Returns:

The translated string in UTF-8 characters.

reload

private void reload()

getTrueLocaleName

public java.lang.String getTrueLocaleName()

translate

public java.lang.String translate(java.lang.String s)

Translate input message.

Parameters:

s - input string in english.

Returns:

The translated string in wide characters.

nativeLanguageNameCodeToIso639_1

public static java.lang.String nativeLanguageNameCodeToIso639_1(java.lang.String current)