How to check if a specific API is supported in Java ME

Template:KBCS

Article Metadata

---

Tested with

Devices(s): Nokia N95 8GB

---

Compatibility

Platform(s): S60 3rd Edition, FP1

---

Article

Keywords: java.lang.System, javax.microedition.lcdui.Alert, javax.microedition.lcdui.AlertType, java.lang.System.getProperty()

Created: (14 May 2008)

Last edited: extkbeditor1 (09 Oct 2008)

Overview

This code snippet demonstrates how to check whether a specific Java ME API is supported on the device and also what version is supported. In this snippet, the API to be checked is the Wireless Messaging API.

Note: The method System.getProperty() can also be used for obtaining several other properties than API versions. See TSJ000306 - MIDP: System properties for a list of possibilities.

Source

import javax.microedition.lcdui.Alert;
import javax.microedition.lcdui.AlertType;
import javax.microedition.lcdui.Display;

String wmVersion = System.getProperty("wireless.messaging.version");
if (wmVersion != null) {
    // Wireless messaging is supported. Inform the user.
    Alert alert = new Alert("Supported",
        "Wireless messaging is supported. Version is: " + wmVersion,
        null, AlertType.INFO);
    Display.getDisplay(this).setCurrent(alert);
} else {
    // Wireless messaging is not supported. Inform the user.
    Alert alert = new Alert("Not supported",
        "Wireless messaging is not supported.", null,
        AlertType.INFO);
    Display.getDisplay(this).setCurrent(alert);
}

Postconditions

The MIDlet displays an alert which shows whether the Wireless Messaging API is supported and if yes, which version is supported.

See also

• TSJ000306 - MIDP: System properties, for a list of system properties.