net.sourceforge.java.util.i18n
Class InternationalizationHandler

java.lang.Object
  net.sourceforge.java.util.i18n.InternationalizationHandler

public class InternationalizationHandler

extends Object

InternationalizationHandler

This class manages all language resources available in the predefined internationalization path.

Version:

0.4.1

Author:

Sebastian Machhausen

Field Summary

private static String	DEFAULT_REPLACEMENT_LANGUAGE The default language to use as replacement if the sytem native language is not supported.
private static String	DEFAULT_RESOURCE_BASE The default base name of the language resources, a fully qualified class name.
private static List	LANGUAGE_RESOURCE_CHANGE_LISTENER Stores the ILanguageResourceChangeListener registered to the in a synchronized List implementation
private static TreeMap	LANGUAGE_RESOURCES Stores the single LanguageResource objects in a sorted TreeMap data structure

Constructor Summary

InternationalizationHandler()

Method Summary

static void	addLanguageResourceChangeListener(ILanguageResourceChangeListener listener) Registers the specified ILanguageResourceChangeListener to the InternationalizationHandler notifiying it of any changes to the default LanguageResource
protected static void	fireLanguageResourceChangeEvent(Object source) Fires a LanguageResourceChangeEvent to all ILanguageResourceChangeListener registered to the InternationalizationHandler notifying them of a possible change to the default LanguageResource
static LanguageResource[]	getAvailableLanguageResources() Gets all available LanguageResources
static LanguageResource	getDefaultLanguageResource() Gets the currently set default LanguageResource This is the resource mapped to currently set default locale determined by Locale.getDefault()
static LanguageResource	getLanguageResource(String language) Gets the LanguageResource mapped to the specified ISO 639 two letter language code (e.g.
static void	removeLanguageResourceChangeListener(ILanguageResourceChangeListener listener) Unregisters the specified ILanguageResourceChangeListener from the InternationalizationHandler
static void	setDefaultLanguage(String language) Sets the default LanguageResource to the one mapped to the specified ISO 639 two letter language code.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_RESOURCE_BASE

private static final String DEFAULT_RESOURCE_BASE

The default base name of the language resources, a fully qualified class name.

Since:

0.3.0

See Also:

Constant Field Values

LANGUAGE_RESOURCES

private static final TreeMap LANGUAGE_RESOURCES

Stores the single LanguageResource objects in a sorted TreeMap data structure

Since:

0.3.0

See Also:

LanguageResource

LANGUAGE_RESOURCE_CHANGE_LISTENER

private static final List LANGUAGE_RESOURCE_CHANGE_LISTENER

Stores the ILanguageResourceChangeListener registered to the in a synchronized List implementation

Since:

0.3.0

See Also:

ILanguageResourceChangeListener

DEFAULT_REPLACEMENT_LANGUAGE

private static final String DEFAULT_REPLACEMENT_LANGUAGE

The default language to use as replacement if the sytem native language is not supported.

Since:

0.4.1

See Also:

Constant Field Values

Constructor Detail

InternationalizationHandler

public InternationalizationHandler()

Method Detail

getAvailableLanguageResources

public static LanguageResource[] getAvailableLanguageResources()

Gets all available LanguageResources

Returns:

an array of LanguageResource objects holding all available resources

Since:

0.3.0

See Also:

LanguageResource

getLanguageResource

public static LanguageResource getLanguageResource(String language)

Gets the LanguageResource mapped to the specified ISO 639 two letter language code (e.g. "de" for german, "en" for english)

Parameters:

language - the ISO 639 twoe letter language code for which to get the mapped LanguageResource

Returns:

the LanguageResource mapped to the specified ISO 639 two letter language code (e.g. "de" for german, "en" for english); null if no such LanguageResource is available for the specified language

Since:

0.3.0

See Also:

LanguageResource

getDefaultLanguageResource

public static LanguageResource getDefaultLanguageResource()

Gets the currently set default LanguageResource
This is the resource mapped to currently set default locale determined by Locale.getDefault()

Returns:

the currently set default LanguageResource; null if no resources exist all (in this case the application will not run)

Since:

0.3.0

See Also:

Locale.getDefault(), setDefaultLanguage(java.lang.String), LanguageResource

setDefaultLanguage

public static void setDefaultLanguage(String language)

Sets the default LanguageResource to the one mapped to the specified ISO 639 two letter language code.
If the LanguageResource is available and valid all registered ILanguageResourceChangeListeners get notified of that change.

Parameters:

language - the ISO 639 two letter language code identifying the LanguageResource to set as default *

Since:

0.3.0

See Also:

getDefaultLanguageResource(), LanguageResource

addLanguageResourceChangeListener

public static void addLanguageResourceChangeListener(ILanguageResourceChangeListener listener)

Registers the specified ILanguageResourceChangeListener to the InternationalizationHandler notifiying it of any changes to the default LanguageResource

Parameters:

listener - the ILanguageResourceChangeListener to register

Since:

0.3.0

See Also:

ILanguageResourceChangeListener

removeLanguageResourceChangeListener

public static void removeLanguageResourceChangeListener(ILanguageResourceChangeListener listener)

Unregisters the specified ILanguageResourceChangeListener from the InternationalizationHandler

Parameters:

listener - the ILanguageResourceChangeListener to unregister

Since:

0.3.0

See Also:

ILanguageResourceChangeListener

fireLanguageResourceChangeEvent

protected static void fireLanguageResourceChangeEvent(Object source)

Fires a LanguageResourceChangeEvent to all ILanguageResourceChangeListener registered to the InternationalizationHandler notifying them of a possible change to the default LanguageResource

Parameters:

source - the Object that triggered the change, normally the LanguageResource that has been changed

Since:

0.3.0

See Also:

LanguageResource, LanguageResourceChangeEvent, ILanguageResourceChangeListener