ALL RIGHTS RESERVED UNDER JSPA (JAVA SPECIFICATION PARTICIPATION AGREEMENT) Information Module Profile (JSR-195) JCP Specification, version 1.0 Java 2 Platform, Microedition - Final Release – © 2003 Siemens Mobile and Nokia. Portions Copyright 2003 Sun Microsystems, Inc. and Motorola, Inc. ALL RIGHTS RESERVED UNDER JSPA (JAVA SPECIFICATION PARTICIPATION AGREEMENT) Content Preface ......................................................................................................................................................................................3 Revision History.......................................................................................................................................................................3 Who Should Use This Specification.........................................................................................................................................4 How This Specification Is Organized.......................................................................................................................................4 Related Literature .....................................................................................................................................................................5 Maintenance Note.....................................................................................................................................................................5 1 Introduction and Background..........................................................................................................................................6 1.1 Introduction.............................................................................................................................................................6 1.2 Background .............................................................................................................................................................6 1.3 Document Conventions...........................................................................................................................................7 1.3.1 Definitions......................................................................................................................................................7 1.3.2 Formatting Conventions .................................................................................................................................7 2 Requirements and Scope.................................................................................................................................................8 2.1 Requirements...........................................................................................................................................................8 2.1.1 Hardware ........................................................................................................................................................8 2.1.2 Software .........................................................................................................................................................9 2.2 Scope.....................................................................................................................................................................10 2.3 IMP and Optional Packages ..................................................................................................................................10 3 Architecture...................................................................................................................................................................11 3.1 Overview...............................................................................................................................................................11 3.2 General architecture ..............................................................................................................................................11 3.3 IMlets ....................................................................................................................................................................13 4 System Functions ..........................................................................................................................................................14 4.1 Overview...............................................................................................................................................................14 4.2 System Properties..................................................................................................................................................14 4.3 Application Resource Files ...................................................................................................................................15 4.4 System.exit............................................................................................................................................................15 4.5 Runtime.exit..........................................................................................................................................................15 5 Timers ...........................................................................................................................................................................16 5.1 Overview...............................................................................................................................................................16 5.2 Timers ...................................................................................................................................................................16 6 Networking ...................................................................................................................................................................17 6.1 Overview...............................................................................................................................................................17 6.2 HttpConnection .....................................................................................................................................................18 6.2.1 HTTP Request Headers ................................................................................................................................19 6.3 DatagramConnection.............................................................................................................................................20 7 Persistent Storage..........................................................................................................................................................21 7.1 Overview...............................................................................................................................................................21 7.2 Record Store..........................................................................................................................................................21 7.3 Records..................................................................................................................................................................22 8 Applications ..................................................................................................................................................................23 8.1 Overview...............................................................................................................................................................23 8.2 IMP IMlet Suite.....................................................................................................................................................23 8.3 IMP Execution Environment.................................................................................................................................24 8.4 IMlet Suite Packaging ...........................................................................................................................................25 8.4.1 JAR Manifest................................................................................................................................................27 8.4.2 IMlet Classes ................................................................................................................................................28 8.5 Application Descriptor ..........................................................................................................................................28 8.6 Application Lifecycle............................................................................................................................................30 Appendix A Implementation Notes ..............................................................................................................................32 2 Information Module Profile (JSR-195), Final Release 10.07.03 ALL RIGHTS RESERVED UNDER JSPA (JAVA SPECIFICATION PARTICIPATION AGREEMENT) Preface This document, Information Module Profile (JSR-195) Specification, defines the Information Module Device Profile (IMP) for JavaTM 2 Platform, Micro Edition (J2METM). Revision History Date Version Description 15-Nov-2002 0.1 Initial draft presented to EG 27-Nov-2002 0.2 Changes following proposals from Motorola 11-Mar-2003 0.9 Community Review Draft 15-Apr-2003 0.95 Public Review Draft 16-May-2003 0.97 Proposed Final Draft 27-May-2003 0.99 Final Approval