org.ametys.core.util

Class I18nUtils

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.ametys.core.util.I18nUtils

All Implemented Interfaces:

Disposable, Initializable, Component, Contextualizable, LogEnabled, Serviceable

Direct Known Subclasses:

I18nUtils

public class I18nUtils
extends AbstractLogEnabled
implements Component, Serviceable, Contextualizable, Initializable, Disposable

Utils for i18n

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private class	I18nUtils.BufferHandler
protected class	I18nUtils.Location Class representing an i18n location

Field Summary

Fields

Modifier and Type	Field and Description
private BundleFactory	_bundleFactory
private Map<String,Map<I18nizableText,String>>	_cache
protected Context	_context The avalon context
private static I18nUtils	_instance
protected Map<String,I18nUtils.Location>	_locations I18n catalogues
static String	ROLE The avalon role

Constructor Summary

Constructors

Constructor and Description
I18nUtils()

Method Summary

Modifier and Type	Method and Description
protected void	_configure() Configure the i18n catalogue
protected String	_translate(I18nizableText text, String language, boolean rawValue) Get the translation of the key.
void	clearCache() Clear the i18n cache.
void	contextualize(Context context)
void	dispose()
static I18nUtils	getInstance() Get the unique instance
protected Map<I18nizableText,String>	getLangCache(String language) Get the translation cache for a language.
void	initialize()
void	reloadCatalogues() Reload the i18n catalogues and clear cache.
void	service(ServiceManager manager)
String	translate(I18nizableText text) Get the translation of the key.
String	translate(I18nizableText text, String language) Get the translation of the key.
String	translate(I18nizableText text, String language, boolean rawValue) Get the translation of the key.

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

enableLogging, getLogger, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

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

Field Detail

ROLE

public static final String ROLE

The avalon role

_instance

private static I18nUtils _instance

_locations

protected Map<String,I18nUtils.Location> _locations

I18n catalogues

_context

protected Context _context

The avalon context

_bundleFactory

private BundleFactory _bundleFactory

_cache

private Map<String,Map<I18nizableText,String>> _cache

Constructor Detail

I18nUtils

public I18nUtils()

Method Detail

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

service

public void service(ServiceManager manager)
             throws ServiceException

Specified by:

service in interface Serviceable

Throws:

ServiceException

initialize

public void initialize()
                throws Exception

Specified by:

initialize in interface Initializable

Throws:

Exception

_configure

protected void _configure()

Configure the i18n catalogue

reloadCatalogues

public void reloadCatalogues()

Reload the i18n catalogues and clear cache. This method should be called as soon as the list of i18n catalogue was changed, when adding a new catalogue for example.

getInstance

public static I18nUtils getInstance()

Get the unique instance

Returns:

the unique instance

translate

public String translate(I18nizableText text)

Get the translation of the key. This method is slow. Only use in very specific cases (send mail for example)

Parameters:

text - The i18n key to translate

Returns:

The translation or null if there's no available translation

Throws:

IllegalStateException - if an error occured

translate

public String translate(I18nizableText text,
                        String language)
                 throws IllegalStateException

Get the translation of the key. Only use in very specific cases (send mail for example)

Parameters:

text - The i18n key to translate

language - The language code to use for translation. Can be null.

Returns:

The translation or null if there's no available translation

Throws:

IllegalStateException - if an error occurred

translate

public String translate(I18nizableText text,
                        String language,
                        boolean rawValue)
                 throws IllegalStateException

Get the translation of the key. Only use in very specific cases (send mail for example)

Parameters:

text - The i18n key to translate

language - The language code to use for translation. Can be null.

rawValue - Set true to get the value corresponding strictly to the specified Locale, without escalading to parent Locale if not found. Note that there is no cache for strict values.

Returns:

The translation or null if there's no available translation

Throws:

IllegalStateException - if an error occurred

clearCache

public void clearCache()

Clear the i18n cache.

getLangCache

protected Map<I18nizableText,String> getLangCache(String language)

Get the translation cache for a language.

Parameters:

language - the language.

Returns:

the translation cache for the given language.

_translate

protected String _translate(I18nizableText text,
                            String language,
                            boolean rawValue)
                     throws IllegalStateException

Get the translation of the key. Only use in very specific cases (send mail for example)

Parameters:

text - The i18n key to translate

language - The language code to use for translation. Can be null.

rawValue - Set true to get the value corresponding strictly to the specified Locale, without escalading to parent Locale if not found

Returns:

The translation or null if there's no available translation

Throws:

IllegalStateException - if an error occured

dispose

public void dispose()

Specified by:

dispose in interface Disposable