Internationalisation API

The Internationalisation API (JSR-238) Internationalisation API 1.0 defined in JSR-238, allows MIDlets to make use of internationalisation services provided by the API.

MIDlets can use the Internationalisation API to:

  • Format data items as per given locales

  • Manage application and device resources for given base names and locales

  • Compare strings as per rules specified by given locales

Use the Internationalisation API, if you want to format data items, manage resources, and compare strings for a locale, but do not want to implement the internationalisation functionality by yourself.

API Contents

The Internationalisation API consists of the following classes:

  • Formatter

    Use the Formatter class to allow a MIDlet to create a locale-specific version of data items, like dates, times, numbers, percentages and currency amounts, on the device.

  • ResourceManager

    Use the ResourceManager class to allow a MIDlet to retrieve application resources, like string objects or byte arrays, or device resources. Both the application and the device resources are retrieved in groups using their base names.

  • StringComparator

    Use the StringComparator class to allow a MIDlet to compare two strings using locale-specific rules.

Device Compatibility

The Internationalisation API is compatible with devices running on Nokia Asha software platform 1.0 or newer.

To find out which device models support the Internationalisation API, see Nokia Developer device specifications.

The Resource Maker Tool

XML files with translated resources need to be converted to RES files. The ResourceMaker Tool converts an XML document into one or more resource files.