|
|
|
|
Add localization support to a MIDlet
In this section, you will learn how to use the localization support
available in MTJ.
Enabling localization support
- In the Package Explorer view, right click the Project folder and
select the Mobile tools for java > Enable Localization
option.
- On the Localization wizard, select the appropriate
information on where to generate the localization *.properties
files and the package where Localization API classes will must be generated.
If you have completed the above steps, the Package
Explorer view will now contain 3 new files:
- L10nConstants.java
- L10nResources.java
- Localization Data
Adding new locales and entries
- In the Package Explorer view, double click the Localization
Data file to open the Localization Data editor.
- On the Localization Data Section, click on the Add
Locale button. This will add a new locale (The default locale is en-US).
- Save the Localization Data file.
The L10nConstants.java file will be recreated with a new
constant mapping the new added locale.
The file messages_en-US.properties will be created in the
folder you specified in the Localization Wizard.
- Now, click on the Add Entry button. This will add a
new entry to the selected Locale.
- Save the
Localization Data file.
The L10nConstants.java file will be recreated with a new
constant mapping the new locale entry.
The file messages_en-US.properties will be will be update
with the value you added through the editor.
Using the Localization API
- The localization API consists of two classes the L10nResources and the
L10nConstants.
-
L10nResources
L10nResources class manages localized resources by it's utility methods. A
list of available methods is show below:
public void setLocale(String locale) throws IOException;
Sets the locale of the L10nResources instance.
public String getString(String key, String[] params);
Gets the value for the specified key. For every
parameter on the params argument there must be an entry in the key value in
the format {x} where x is the index of the value to be replaced on the
formated string.
public String getString(String key);
Gets the value for the specified key.
public byte[] getData(String key) throws IOException;
Gets the binary data associated to the path set as
value of the specified key.
-
L10nConstants
L10nConstants must NOT be changed by the developer since it is auto generated
every time the Localization Data file changes.
|
|
|