Package org.apache.sis.util.resources

Class Messages

java.lang.Object

java.util.ResourceBundle

org.apache.sis.util.resources.IndexedResourceBundle

org.apache.sis.util.resources.Messages

All Implemented Interfaces:

Localized

public final class Messages
extends IndexedResourceBundle

Locale-dependent resources for miscellaneous (often logging) messages.

Since:

0.3

Version:

0.8

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private static final class	Messages.International	The international string to be returned by formatInternational(short).
static final class	Messages.Keys	Resource keys.

Nested classes/interfaces inherited from class java.util.ResourceBundle

ResourceBundle.Control

Field Summary

Fields inherited from class org.apache.sis.util.resources.IndexedResourceBundle

FIRST, LOCALE_KEY

Fields inherited from class java.util.ResourceBundle

parent

Constructor Summary

Constructors

Constructor	Description
Messages(URL resources)	Constructs a new resource bundle loading data from the given UTF file.

Method Summary

Modifier and Type	Method	Description
static String	format(short key)	Gets a string for the given key from this resource bundle or one of its parents.
static String	format(short key, Object arg0)	Gets a string for the given key and replaces all occurrence of "{0}" with value of arg0.
static String	format(short key, Object arg0, Object arg1)	Gets a string for the given key and replaces all occurrence of "{0}", "{1}", with values of arg0, arg1.
static String	format(short key, Object arg0, Object arg1, Object arg2)	Gets a string for the given key and replaces all occurrence of "{0}", "{1}", with values of arg0, arg1, etc.
static String	format(short key, Object arg0, Object arg1, Object arg2, Object arg3)	Gets a string for the given key and replaces all occurrence of "{0}", "{1}", with values of arg0, arg1, etc.
static org.opengis.util.InternationalString	formatInternational(short key)	Gets an international string for the given key.
static org.opengis.util.InternationalString	formatInternational(short key, Object arg)	Gets an international string for the given key.
static org.opengis.util.InternationalString	formatInternational(short key, Object... args)	Gets an international string for the given key.
protected KeyConstants	getKeyConstants()	Returns the handle for the Keys constants.
static Messages	getResources(Locale locale)	Returns resources in the given locale.

Methods inherited from class org.apache.sis.util.resources.IndexedResourceBundle

appendLabel, getBundle, getKeys, getLabel, getLocale, getLogRecord, getLogRecord, getLogRecord, getLogRecord, getLogRecord, getString, getString, getString, getString, getString, getString, handleGetObject, list, toArray, toLabel, toString

Methods inherited from class java.util.ResourceBundle

clearCache, clearCache, containsKey, getBaseBundleName, getBundle, getBundle, getBundle, getBundle, getBundle, getBundle, getLocale, getObject, getString, getStringArray, handleKeySet, keySet, setParent

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.sis.util.Localized

getLocale

Constructor Details

Messages

Messages(URL resources)

Constructs a new resource bundle loading data from the given UTF file.

Parameters:

resources - the path of the binary file containing resources, or null if there are no resources. The resources may be a file or an entry in a JAR file.

Method Details

getKeyConstants

protected KeyConstants getKeyConstants()

Returns the handle for the Keys constants.

Overrides:

getKeyConstants in class IndexedResourceBundle

Returns:

a handler for the constants declared in the inner Keys class.

getResources

public static Messages getResources(Locale locale)
                             throws MissingResourceException

Returns resources in the given locale.

Parameters:

locale - the locale, or null for the default locale.

Returns:

resources in the given locale.

Throws:

MissingResourceException - if resources cannot be found.

format

public static String format(short key)
                     throws MissingResourceException

Gets a string for the given key from this resource bundle or one of its parents.

Parameters:

key - the key for the desired string.

Returns:

the string for the given key.

Throws:

MissingResourceException - if no object for the given key can be found.

format

public static String format(short key,
 Object arg0)
                     throws MissingResourceException

Gets a string for the given key and replaces all occurrence of "{0}" with value of arg0.

Parameters:

key - the key for the desired string.

arg0 - value to substitute to "{0}".

Returns:

the formatted string for the given key.

Throws:

MissingResourceException - if no object for the given key can be found.

format

public static String format(short key,
 Object arg0,
 Object arg1)
                     throws MissingResourceException

Gets a string for the given key and replaces all occurrence of "{0}", "{1}", with values of arg0, arg1.

Parameters:

key - the key for the desired string.

arg0 - value to substitute to "{0}".

arg1 - value to substitute to "{1}".

Returns:

the formatted string for the given key.

Throws:

MissingResourceException - if no object for the given key can be found.

format

public static String format(short key,
 Object arg0,
 Object arg1,
 Object arg2)
                     throws MissingResourceException

Gets a string for the given key and replaces all occurrence of "{0}", "{1}", with values of arg0, arg1, etc.

Parameters:

key - the key for the desired string.

arg0 - value to substitute to "{0}".

arg1 - value to substitute to "{1}".

arg2 - value to substitute to "{2}".

Returns:

the formatted string for the given key.

Throws:

MissingResourceException - if no object for the given key can be found.

format

public static String format(short key,
 Object arg0,
 Object arg1,
 Object arg2,
 Object arg3)
                     throws MissingResourceException

Gets a string for the given key and replaces all occurrence of "{0}", "{1}", with values of arg0, arg1, etc.

Parameters:

key - the key for the desired string.

arg0 - value to substitute to "{0}".

arg1 - value to substitute to "{1}".

arg2 - value to substitute to "{2}".

arg3 - value to substitute to "{3}".

Returns:

the formatted string for the given key.

Throws:

MissingResourceException - if no object for the given key can be found.

formatInternational

public static org.opengis.util.InternationalString formatInternational(short key)

Gets an international string for the given key. This method does not check for the key validity. If the key is invalid, then a MissingResourceException may be thrown when a InternationalString.toString(Locale) method is invoked.

Parameters:

key - the key for the desired string.

Returns:

an international string for the given key.

formatInternational

public static org.opengis.util.InternationalString formatInternational(short key,
 Object arg)

Gets an international string for the given key. This method does not check for the key validity. If the key is invalid, then a MissingResourceException may be thrown when a InternationalString.toString(Locale) method is invoked.

API note: This method is redundant with the one expecting Object..., but avoid the creation of a temporary array. There is no risk of confusion since the two methods delegate their work to the same format method anyway.

Parameters:

key - the key for the desired string.

arg - values to substitute to "{0}".

Returns:

an international string for the given key.

formatInternational

public static org.opengis.util.InternationalString formatInternational(short key,
 Object... args)

Gets an international string for the given key. This method does not check for the key validity. If the key is invalid, then a MissingResourceException may be thrown when a InternationalString.toString(Locale) method is invoked.

Parameters:

key - the key for the desired string.

args - values to substitute to "{0}", "{1}", etc.

Returns:

an international string for the given key.