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 exist
Copyright (c) 2000, 2014 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.