Supported APIs

The following tables list the core and additional Java™ APIs supported by the Series 40 platforms. The tables also list which API version is supported since which Series 40 release. The API names link to the corresponding Series 40 implementation notes, if available, while the Java Specification Request (JSR) numbers link to the corresponding API specifications ("Javadocs").

For information about new APIs which are supported on Nokia Asha software platform 1.0 APIs, see section Nokia Asha software platform 1.0 APIs at the end of this page.

For older API specification versions, see Java API Specifications on Nokia Developer.

For information about which APIs are not supported on Series 40 Lite platforms, see section Support for additional Java APIs on Series 40 Lite at the end of this page.

Core Java APIs

The Series 40 platforms support the following core Java APIs.

Table: Core Java APIs supported by the Series 40 platforms

Java API

JSR

Description

In Series 40

Connected Limited Device Configuration (CLDC)

139 (CLDC 1.1)

30 (CLDC 1.0)

CLDC specifies the low-level Java APIs on which MIDP is implemented.

CLDC 1.1

Series 40 2nd Edition

CLDC 1.0

Series 40 1st Edition

Mobile Information Device Profile (MIDP)

118 (MIDP 2.1)

118 (MIDP 2.0)

37 (MIDP 1.0)

MIDP specifies the basic Java APIs for Java ME applications running on mobile devices. These APIs include, for example, the LCDUI API for creating GUIs and the RMS API for storing application data.

Java ME applications that use MIDP are called MIDlets.

The MIDP 2.1 specification is only available as a PDF download on the Java Community Process (JCP) website. The Java Developer's Library includes the MIDP 2.0 specification. For detailed information about the MIDP 2.1 implementation on Series 40 devices, see section Developer's guides and the MIDP 2.1 implementation notes.

MIDP 2.1

Series 40 5th Edition

MIDP 2.0

Series 40 2nd Edition

MIDP 1.0

Series 40 1st Edition

Additional Java APIs

The Series 40 platforms support the following additional Java APIs.

Table: Additional Java APIs supported by the Series 40 platforms

Java API

JSR

Description

In Series 40

Advanced Multimedia Supplements API (AMMS API)

234

The AMMS API allows you to build MIDlets with advanced multimedia features. You can access camera-specific controls such as brightness, contrast, flash, lighting modes, and zoom. You can also access radio and advanced audio processing capabilities.

For instructions on using this API, see section Using advanced multimedia features.

Version 1.1

Series 40 6th Edition

Version 1.0

Series 40 5th Edition

Bluetooth API

82

The Bluetooth API allows you to use Bluetooth connections in your MIDlet.

For instructions on using this API, see section Bluetooth connections.

Version 1.1

Series 40 5th Edition

Version 1.0

Series 40 2nd Edition

Content Handler API (CHAPI)

211

The Content Handler API allows MIDlets to invoke registered Java ME and non-Java applications for content handling.

For instructions on using this API, see section Content handling.

Version 1.0.1

Java Runtime 1.0.0 for Series 40

Version 1.0

Series 40 5th Edition Feature Pack 1

Location API

179

179 Appendix

The Location API allows MIDlets to access location information and services through GPS.

Version 1.0

Series 40 6th Edition

Mobile 3D Graphics API (M3G API)

184

The Mobile 3D Graphics API allows MIDlets to use 3D graphics in their UI. The API implementation is based on OpenGL ES 1.0.

For instructions on using this API, see section Mobile 3D graphics.

Version 1.1

Series 40 3rd Edition Feature Pack 1

Version 1.0

Series 40 2nd Edition

Mobile Media API (MMAPI)

135

The Mobile Media API allows MIDlets to display images and play back audio and video.

Version 1.2

Series 40 6th Edition

Version 1.1

Series 40 5th Edition

Version 1.0

Series 40 3rd Edition

Mobile Sensor API

256

The Mobile Sensor API allows you to develop MIDlets that use input from embedded or external sensors.

For instructions on using this API, see section Mobile sensors.

Version 1.2

Java Runtime 2.0.0 for Series 40

Nokia UI API

Nokia UI API

The Nokia UI API is a Nokia-proprietary extension to MIDP. It provides additional functionality, especially for game developers, in the form of audio and graphics capabilities.

Version 1.7

Java Runtime for Nokia Asha software platform (1.0)

Version 1.6

Java Runtime 2.0.0 for Series 40

Version 1.1c

Java Runtime 1.0.0 for Series 40

Version 1.1b

Series 40 6th Edition Feature Pack 1

Version 1.1a

Series 40 6th Edition (Navi Key devices)

Version 1.1

Series 40 2nd Edition

Version 1.0

Series 40 1st Edition

PDA Optional Package: FileConnection API (FC API)

75 (FC)

The FileConnection API allows MIDlets to access the device file system.

For instructions on using this API, see section File access.

Version 1.0

Series 40 2nd Edition

PDA Optional Package: Personal Information Management API (PIM API)

75 (PIM)

The PIM API allows MIDlets to access personal data stored by users, including contact lists, calendars, and to-do lists.

For instructions on using this API, see section Personal information management.

Version 1.0

Series 40 2nd Edition

Scalable 2D Vector Graphics API (M2G API)

226

The Scalable 2D Vector Graphics API allows MIDlets to load and render external 2D vector images stored in the W3C SVG Tiny format. The API can be extend to support other formats.

For instructions on using this API, see section Scalable 2D vector graphics.

Version 1.1

Series 40 3rd Edition Feature Pack 2

Version 1.0

Series 40 3rd Edition Feature Pack 1

Security and Trust Services API (SATSA API)

177

The SATSA API allows MIDlets to use PKI certificates, private data storage, cryptographic operations, and secure environment services for authentication, authorization, and identification. The API consists of the following optional packages:

  • SATSA-PKI

  • SATSA-APDU

  • SATSA-CRYPTO

For instructions on using this API, see section Security.

Version 1.0

Series 40 3rd Edition Feature Pack 2

Web Services API

172 (RPC)

172 (XML Parser)

The Web Services API provides an infrastructure for the web services client/server architecture. The API consists of the following independent, optional packages:

  • RPC Package

  • XML Parser Package

The packages provide basic XML processing capabilities and allow the reuse of web service concepts when designing Java ME clients for enterprise services.

For instructions on using this API, see section Web Services.

Version 1.0

Series 40 3rd Edition Feature Pack 1

Wireless Messaging API (WMA)

205 (WMA 2.0)

120 (WMA 1.0)

The Wireless Messaging API allows MIDlets to compose, send, and receive SMS and MMS messages.

For instructions on using this API, see section Wireless Messaging API 2.0.

Version 2.0

Series 40 3rd Edition Feature Pack 1

Version 1.0

Series 40 1st Edition

Support for additional Java APIs on Series 40 Lite

The Series 40 Lite platforms support a subset of the additional Java APIs supported by the corresponding regular Series 40 platform release. The Series 40 Lite platforms support the JSR-185 Java Technology for the Wireless Industry (JTWI) specification and not the JSR-248 Mobile Service Architecture (MSA) Subset specification.

Series 40 5th Edition Lite does not support the following APIs supported by Series 40 5th Edition:

  • JSR-172 Web Services API

  • JSR-177 Security and Trust Services API

  • JSR-184 Mobile 3D Graphics API

  • JSR-226 Scalable 2D Vector Graphics API

  • JSR-234 Advanced Multimedia Supplements API

Series 40 5th Edition Feature Pack 1 Lite does not support the following APIs supported by Series 40 5th Edition Feature Pack 1:

  • JSR-172 Web Services

  • JSR-184 Mobile 3D Graphics API

  • JSR-211 Content Handler API

  • JSR-226 Scalable 2D Vector Graphics API

  • JSR-234 Advanced Multimedia Supplements API

Series 40 6th Edition Lite does not support the following APIs supported by Series 40 6th Edition:

  • JSR-179 Location API

  • JSR-226 Scalable 2D Vector Graphics API

  • JSR-234 Advanced Multimedia Supplements API

Otherwise, the Series 40 Lite platforms support the same APIs and API versions as the corresponding regular Series 40 platform release.

For information about other features supported by a regular Series 40 platform release but not supported by its Lite release, see article Series 40: Editions and Feature Packs in the Nokia Developer Wiki.

Nokia Asha software platform 1.0 APIs

Nokia Asha software platform 1.0 supports the following new APIs: