js.util

Class I18nPoolFactory.LocalePool<T>

java.lang.Object

js.util.I18nPoolFactory.LocalePool<T>

Type Parameters:

T - pool object type.

All Implemented Interfaces:

I18nPool<T>

Enclosing class:

I18nPoolFactory

private static class I18nPoolFactory.LocalePool<T>
extends Object
implements I18nPool<T>

Locale sensitive I18N pool implementation.

Version:

final

Author:

Iulian Rotaru

Field Summary

Fields

Modifier and Type	Field and Description
private Map<String,Map<String,T>>	localeMaps Locale sensitive cache storage.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	LocalePool()

Method Summary

Modifier and Type	Method and Description
T	get(String name, Locale... locale) Get instance identified by name and optional locale settings.
boolean	has(String name, Locale... locale) Test if cache has an instance identified by given name and optional locale settings.
private Map<String,T>	maps(Locale locale) Get named objects map bound to requested locale settings.
boolean	put(String name, T t, Locale... locale) Store an instance on this cache bound to given name and optional locale settings.

Methods inherited from class java.lang.Object

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

Field Detail

localeMaps

private final Map<String,Map<String,T>> localeMaps

Locale sensitive cache storage. On interface this pool uses locale to put and retrieve named instances but internally uses locale language tag for key, see Locale.toLanguageTag(). As requested by I18NPool interface locale should be based only on language and optional country, encoded with ISO 639 alpha-2, respective ISO 3166 alpha-2; script, variant and extension should be empty.

Implementation avoid using locale instances for map keys. Accordingly Java Locale API, ISO 639 alpha-2 language code is not stable; there are updated language codes that will render in different keys. For example Locale("he") and Locale("iw") will result in different map keys. Using locale language tag ensure always is used the new language code, in previous example he.

Constructor Detail

LocalePool

private LocalePool()

Method Detail

put

public boolean put(String name,
                   T t,
                   Locale... locale)

Description copied from interface: I18nPool

Store an instance on this cache bound to given name and optional locale settings. To later retrieve stored instance one should know both instance name and locale settings. For implementations without multiple locale support, optional locale argument is silently ignored and not even tested for validity.

Specified by:

put in interface I18nPool<T>

Parameters:

name - unique name with application scope,

t - object instance to store on cache,

locale - optional locale settings, mandatory for implementations with multiple locale support.

Returns:

true if object instance were already present.

get

public T get(String name,
             Locale... locale)

Description copied from interface: I18nPool

Get instance identified by name and optional locale settings. Returns null if no instance found with specified criteria. For implementations without multiple locale support, optional locale argument is silently ignored and not even tested for validity.

Specified by:

get in interface I18nPool<T>

Parameters:

name - unique name with application scope,

locale - optional locale settings, mandatory for implementations with multiple locale support.

Returns:

named instance or null.

has

public boolean has(String name,
                   Locale... locale)

Description copied from interface: I18nPool

Test if cache has an instance identified by given name and optional locale settings. For implementations without multiple locale support, optional locale argument is silently ignored and not even tested for validity.

Specified by:

has in interface I18nPool<T>

Parameters:

name - unique name with application scope,

locale - optional locale settings, mandatory for implementations with multiple locale support.

Returns:

true if there is an instance identified by given criteria.

maps

private Map<String,T> maps(Locale locale)

Get named objects map bound to requested locale settings.

Parameters:

locale - locale settings to retrieve objects map for.

Returns:

objects map bound to requested locale settings.

Throws:

IllegalArgumentException - if locale argument has variant, script or extension.