public abstract class NLS extends Object
The #bind
methods perform string substitution and should be considered a
convenience and not a full substitute replacement for MessageFormat#format
method calls.
Text appearing within curly braces in the given message, will be interpreted
as a numeric index to the corresponding substitution object in the given array. Calling
the #bind
methods with text that does not map to an integer will result in an
IllegalArgumentException
.
Text appearing within single quotes is treated as a literal. A single quote is escaped by a preceeding single quote.
Clients who wish to use the full substitution power of the MessageFormat
class should
call that class directly and not use these #bind
methods.
Clients may subclass this type.
Modifier | Constructor and Description |
---|---|
protected |
NLS()
Creates a new NLS instance.
|
Modifier and Type | Method and Description |
---|---|
static String |
bind(String message,
Object binding)
Bind the given message's substitution locations with the given string value.
|
static String |
bind(String message,
Object[] bindings)
Bind the given message's substitution locations with the given string values.
|
static String |
bind(String message,
Object binding1,
Object binding2)
Bind the given message's substitution locations with the given string values.
|
static void |
initializeMessages(String baseName,
Class<?> clazz)
Initialize the given class with the values from the message properties specified by the
base name.
|
public static String bind(String message, Object binding)
message
- the message to be manipulatedbinding
- the object to be inserted into the messageIllegalArgumentException
- if the text appearing within curly braces in the given message does not map to an integerpublic static String bind(String message, Object binding1, Object binding2)
message
- the message to be manipulatedbinding1
- An object to be inserted into the messagebinding2
- A second object to be inserted into the messageIllegalArgumentException
- if the text appearing within curly braces in the given message does not map to an integerpublic static String bind(String message, Object[] bindings)
message
- the message to be manipulatedbindings
- An array of objects to be inserted into the messageIllegalArgumentException
- if the text appearing within curly braces in the given message does not map to an integerpublic static void initializeMessages(String baseName, Class<?> clazz)
For example, if the locale is set to en_US and org.eclipse.example.nls.messages
is used as the base name then the following resources will be searched using the class
loader of the specified class:
org/eclipse/example/nls/messages_en_US.properties org/eclipse/example/nls/messages_en.properties org/eclipse/example/nls/messages.properties
baseName
- the base name of a fully qualified message properties file.clazz
- the class where the constants will existCopyright © 2007–2018 The Apache Software Foundation. All rights reserved.