Package org.sellcom.core.i18n

Class Resources

java.lang.Object

org.sellcom.core.i18n.Resources

public class Resources
extends java.lang.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	Description
static void	clearResources()	Clears the resources for the default locale.
static void	clearResources(java.util.Locale locale)	Clears the resources for the given locale.
static java.lang.String	getQuantityString(java.lang.String key, int quantity, java.lang.Object... args)	Returns the string resource with the given key for the default locale.
static java.lang.String	getQuantityString(java.util.Locale locale, java.lang.String key, int quantity, java.lang.Object... args)	Returns the string resource with the given key for the given locale.
static java.lang.String	getString(java.lang.String key, java.lang.Object... args)	Returns the string resource with the given key for the default locale.
static java.lang.String	getString(java.util.Locale locale, java.lang.String key, java.lang.Object... args)	Returns the string resource with the given key for the given locale.
static void	loadResources(java.lang.String baseName)	Loads resources from the given resource bundle.
static void	loadResources(java.lang.String baseName, java.util.Locale locale)	Loads resources from the given resource bundle.
static void	loadResources(java.lang.String baseName, java.util.Locale locale, java.lang.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(java.util.Locale locale)

Clears the resources for the given locale.

Throws:

java.lang.IllegalArgumentException - if locale is null

Since:

1.0

getQuantityString

public static java.lang.String getQuantityString(java.lang.String key,
                                                 int quantity,
                                                 java.lang.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:

java.lang.IllegalArgumentException - if key is null or empty

Since:

1.0

getQuantityString

public static java.lang.String getQuantityString(java.util.Locale locale,
                                                 java.lang.String key,
                                                 int quantity,
                                                 java.lang.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:

java.lang.IllegalArgumentException - if locale is null

java.lang.IllegalArgumentException - if key is null or empty

Since:

1.0

getString

public static java.lang.String getString(java.util.Locale locale,
                                         java.lang.String key,
                                         java.lang.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:

java.lang.IllegalArgumentException - if locale is null

java.lang.IllegalArgumentException - if key is null or empty

Since:

1.0

getString

public static java.lang.String getString(java.lang.String key,
                                         java.lang.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:

java.lang.IllegalArgumentException - if key is null or empty

Since:

1.0

loadResources

public static void loadResources(java.lang.String baseName)

Loads resources from the given resource bundle.

Throws:

java.lang.IllegalArgumentException - if baseName is null or empty

Since:

1.0

See Also:

ResourceBundle.getBundle(String)

loadResources

public static void loadResources(java.lang.String baseName,
                                 java.util.Locale locale)

Loads resources from the given resource bundle.

Throws:

java.lang.IllegalArgumentException - if baseName is null or empty

java.lang.IllegalArgumentException - if locale is null

Since:

1.0

See Also:

ResourceBundle.getBundle(String, Locale)

loadResources

public static void loadResources(java.lang.String baseName,
                                 java.util.Locale locale,
                                 java.lang.ClassLoader classLoader)

Loads resources from the given resource bundle.

Throws:

java.lang.IllegalArgumentException - if baseName is null or empty

java.lang.IllegalArgumentException - if locale is null

java.lang.IllegalArgumentException - if classLoader is null

Since:

1.0

See Also:

ResourceBundle.getBundle(String, Locale, ClassLoader)