Supported Java APIs

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

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

For more information about Series 40 and Symbian platform releases and Java Runtime for Symbian versions, see section Java ME on Series 40 and Symbian platforms.

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 and Symbian platforms support the following core Java APIs.

Table: Core Java APIs supported by the Series 40 and Symbian platforms

Java API

JSR

Description

In Series 40

In Symbian

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

CLDC 1.1

S60 2nd Edition FP2

CLDC 1.0

S60 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) Web site. The Java Developer's Library includes the MIDP 2.0 specification. For detailed information about the MIDP 2.1 implementation on Series 40 and Symbian devices, see section Application framework 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

MIDP 2.1

S60 3rd Edition FP2

MIDP 2.0

S60 2nd Edition

MIDP 1.0

S60 1st Edition

Additional Java APIs

The Series 40 and Symbian platforms support the following additional Java APIs.

Table: Additional Java APIs supported by the Series 40 and Symbian platforms

Java API

JSR

Description

In Series 40

In Symbian

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

Version 1.1

S60 5th Edition

Version 1.0

S60 3rd Edition FP1

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

Version 1.1

S60 3rd Edition FP2

Version 1.0

S60 2nd Edition FP2

Contactless Communication API

257

The Contactless Communication API allows MIDlets to use the NFC capabilities of the device to communicate with contactless targets. Specifically, MIDlets can read and write small amounts of data to and from the tags in contactless targets.

Note: The Contactless Communication API is also included in the Nokia 6131 NFC and Nokia 6212 Classic devices, which are based on the Series 40 platform.

For instructions on using this API, see section Near Field Communication.

 

Version 1.0

Java Runtime 2.2 for Symbian

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 Handler.

Version 1.0.1

Java Runtime 1.0.0 for Series 40

Version 1.0

Series 40 5th Edition FP1

Version 1.0.1

Java Runtime 2.3 for Symbian

embedded Standard Widget Toolkit API (eSWT API)

eSWT API

eSWT API Appendix

The eSWT API is an alternative to the LCDUI for developing MIDlet UIs. The eSWT API allows you to build MIDlets that use the platform's native UI components.

For instructions on using this API, see section eSWT.

 

Version 1.0.3

S60 3rd Edition FP2

In-App Purchase API (IAP API)

IAP API

The In-App Purchase API allows you to integrate a Nokia Store purchasing feature into your MIDlet in a simple and seamless manner.

For instructions on using this API, see section In-app purchase.

Version 1.0

Java Runtime 1.0.0 for Series 40

 

Internet Access Point Info API (IAP Info API)

IAP Info API

The IAP Info API allows MIDlets to access information related to Internet Access Points and Destination Networks.

For instructions on using this API, see section IAP Info connections.

 

Version 1.0

S60 3rd Edition FP2

Location API

179

179 Appendix

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

For instructions on using this API, see section Location services.

Version 1.0

Series 40 6th Edition

Version 1.0.1

Java Runtime 2.1 for Symbian

Version 1.0

S60 3rd 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 FP1

Version 1.0

Series 40 2nd Edition

Version 1.1

S60 3rd Edition FP1

Version 1.0

S60 2nd Edition FP2

Mobile Broadcast Service API

272

The Mobile Broadcast Service API provides interactive broadcast services, such as Mobile TV, for mobile terminals.

For instructions on using this API, see section Mobile broadcasting (DVB-H).

 

Version 1.0

Java Runtime 2.2 for Symbian

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

Version 1.2

S60 3rd Edition FP2

Version 1.1

S60 3rd Edition FP1

Version 1.0

S60 1st 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

Version 1.2

Newer S60 3rd Edition FP2 devices and devices with Java Runtime 1.4 for S60

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.

For instructions on using this API, see section Nokia UI API.

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 FP1

Version 1.1a

Series 40 6th Edition (Navi Key devices)

Version 1.1

Series 40 2nd Edition

Version 1.0

Series 40 1st Edition

Version 1.4

Java Runtime 2.1 for Symbian

Version 1.3

Java Runtime 1.4 for S60

Version 1.2

S60 3rd Edition FP2

Version 1.1

S60 3rd Edition FP1

Version 1.0

S60 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

Version 1.0

S60 2nd Edition FP2

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

Version 1.0

S60 2nd Edition FP2

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 FP2

Version 1.0

Series 40 3rd Edition FP1

Version 1.1

S60 3rd Edition FP1

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 FP2

Version 1.0

S60 3rd Edition

Session Initiation Protocol API (SIP API)

180

The SIP API allows MIDlets to initiate, modify, and terminate an interactive user session involving elements such as video, voice, instant messaging, and online gaming.

The SIP API is only supported on S60 3rd Edition, S60 3rd Edition FP1, and S60 3rd Edition FP2 devices. Earlier devices and S60 5th Edition and newer Symbian devices do not support this API.

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

 

Version 1.0.1

S60 3rd Edition

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 FP1

Version 1.0

S60 3rd Edition

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 FP1

Version 1.0

Series 40 1st Edition

Version 2.0

S60 3rd Edition

Version 1.0

S60 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 FP1 Lite does not support the following APIs supported by Series 40 5th Edition FP1:

  • 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.