org.sellcom.core.i18n

Class Resources

java.lang.Object

org.sellcom.core.i18n.Resources

public class Resources
extends Object

Static singleton for accessing application resources.

References

Properties can refer to other properties using the {@<property>} syntax. The referenced property must either be located in the same file (the order of the properties in the file is not important) or must already be loaded. Example:

 actions.openDocument.chooseFileDialog.title = {@actions.openDocument.title}
 actions.openDocument.menu.title = _{@actions.openDocument.title}...
 actions.openDocument.title = Open document
 

Since:

1.0

Method Summary

Modifier and Type	Method and Description
static void	clearResources() Clears the resources for the default locale.
static void	clearResources(Locale locale) Clears the resources for the given locale.
static String	getQuantityString(Locale locale, String key, int quantity, Object... args) Returns the string resource with the given key for the given locale.
static String	getQuantityString(String key, int quantity, Object... args) Returns the string resource with the given key for the default locale.
static String	getString(Locale locale, String key, Object... args) Returns the string resource with the given key for the given locale.
static String	getString(String key, Object... args) Returns the string resource with the given key for the default locale.
static void	loadResources(String baseName) Loads resources from the given resource bundle.
static void	loadResources(String baseName, Locale locale) Loads resources from the given resource bundle.
static void	loadResources(String baseName, Locale locale, ClassLoader classLoader) Loads resources from the given resource bundle.

Methods inherited from class java.lang.Object

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

Method Detail

clearResources

public static void clearResources()

Clears the resources for the default locale.

Since:

1.0

clearResources

public static void clearResources(Locale locale)

Clears the resources for the given locale.

Throws:

IllegalArgumentException - if locale is null

Since:

1.0

getQuantityString

public static String getQuantityString(String key,
                                       int quantity,
                                       Object... args)

Returns the string resource with the given key for the default locale. Selects the resource with grammatically correct pluralization for the given quantity. Interpolates the given arguments using MessageFormat.format(String, Object...) into the resource.

Throws:

IllegalArgumentException - if key is null or empty

Since:

1.0

getQuantityString

public static String getQuantityString(Locale locale,
                                       String key,
                                       int quantity,
                                       Object... args)

Returns the string resource with the given key for the given locale. Selects the resource with grammatically correct pluralization for the given quantity. Interpolates the given arguments using MessageFormat.format(String, Object...) into the resource.

Throws:

IllegalArgumentException - if locale is null

IllegalArgumentException - if key is null or empty

Since:

1.0

getString

public static String getString(Locale locale,
                               String key,
                               Object... args)

Returns the string resource with the given key for the given locale. Interpolates the given arguments using MessageFormat.format(String, Object...) into the resource.

Throws:

IllegalArgumentException - if locale is null

IllegalArgumentException - if key is null or empty

Since:

1.0

getString

public static String getString(String key,
                               Object... args)

Returns the string resource with the given key for the default locale. Interpolates the given arguments using MessageFormat.format(String, Object...) into the resource.

Throws:

IllegalArgumentException - if key is null or empty

Since:

1.0

loadResources

public static void loadResources(String baseName)

Loads resources from the given resource bundle.

Throws:

IllegalArgumentException - if baseName is null or empty

Since:

1.0

See Also:

ResourceBundle.getBundle(String)

loadResources

public static void loadResources(String baseName,
                                 Locale locale)

Loads resources from the given resource bundle.

Throws:

IllegalArgumentException - if baseName is null or empty

IllegalArgumentException - if locale is null

Since:

1.0

See Also:

ResourceBundle.getBundle(String, Locale)

loadResources

public static void loadResources(String baseName,
                                 Locale locale,
                                 ClassLoader classLoader)

Loads resources from the given resource bundle.

Throws:

IllegalArgumentException - if baseName is null or empty

IllegalArgumentException - if locale is null

IllegalArgumentException - if classLoader is null

Since:

1.0

See Also:

ResourceBundle.getBundle(String, Locale, ClassLoader)