Resources and API’s Available | Motorola C381P specification

2

J2ME Introduction

Resources and API’s Available

MIDP 2.0 will provide support to the following functional areas on the Motorola C381p handset:

MIDP 2.0

•Application delivery and billing

•Application lifecycle

•Application signing model and privileged security model

•End-to-end transactional security (HTTPS)

•Networking

•Persistent storage

•Sounds

•Timers

•User Interface

•File Image Support (.PNG, .JPEG, .GIF)

Additional Functionality

•WMA (JSR 120)

•MMA (JSR 135)

•Phonebook API

•Telephony API

17

Image 17

Motorola C381P technical manual Resources and API’s Available

Contents

Motorola C381p Handset J2ME Developer Guide Table of Contents Network Apis GET URL from Flex API Java System Menu Java Platform Table of Figures MIDlet Attributes, descriptions, and JAD and/or JAR Index of Tables Actions performed upon completion of signer certificate Table of Code Samples Purpose IntroductionAudience Disclaimer Reference References Definitions, Abbreviations, Acronyms Revision HistoryDate Name Reason November 09 S.A.R Initial Draft Description Document Overview Background Applications this chapter describes Java 2 Platform, Micro Edition J2ME J2ME Introduction Midp Motorola J2ME Platform Resources and API’s Available Introduction to Development Developing and Packaging J2ME ApplicationsGuide to Development in J2ME Developing and Packaging J2ME Applications Method of Downloading Downloading Applications Error Logs Error Logs OTA and Download Contents JAD file information Downloading a JAR file without a JAD MIDlet UpgradeApplication Management System Menu Installation and Deletion Status Reports Action JAD / Manifest Attribute Implementations JAD Attributes JAD Java.lang support Java.lang Implementation Network Connections Network APIs Socket Connection Https Connection User Permission Network APIs Code Sample 3 Https Connection JSR 135 Mobile Media API JSR 135 Mobile Media API ToneControl GUIControl VolumeControl Manager Class StopTimeControlAudio Media Description Mime Type Tone Sequences JSR 135 Mobile Media API SMS Client Mode and Server Mode Connection JSR 120 Wireless MessagingWireless Messaging API WMA SMS Port Numbers MessageConnectionConnector.opensms//6000 SMS Notification SMS Message TypesSMS Message Structure Messaging features/classes supported Setting of address with port number Setting of payload text for text messageCreation of server connection Creation of client connection with port number Sending of message Setting of address without port numberReceiving of message Getting of address JSR 120 Wireless Messaging API Code Sample 5 JSR 120 Wireless Messaging API Phonebook Access API Permissions Phonebook Access API Sample of code for calling of ‘addint sortOrder’ method Int num = PhoneBookRecord.getNumberRecordsByNamename Sample of code for calling of ‘getMaxEmailLength ’ method Code Sample 6 Phonebook API Class DialerEvent Dialer Class Detail Definition Summary Method Summary Class Dialer Parameters SetDialerListener Throws StartCallSendExtNo EndCall Interface DialerListenerSample DialerListener Implementation Asynchronous callback for receive phone call event Interface Hierarchy Class HierarchyNotifyDialerEvent Public void notifyDialerEventDialer dialer, byte event Serial Port Access Sending a Message SMS Messaging as GSM ExtensionCreating a Message Deleting a Message Viewing a Message Canvas Functionality User Display Interface User Display Interface End Key Hardware MappingSend Key Left, Right and Menu Soft Keys Soft Key Position Priority Global Command Active Global Commands Back, Cancel, OK, Help & Stop Power Key Game Key Mapping Volume Key Application Icons Application ResourcesApplication Keys Deleting the MIDlet/Application Effect of Master Clear or Master ResetSoftkey Labels Download MIDlet Through Browser Find a location with J2ME Application Star Active Browser Session from Main Menu Downloading MIDlets Downloading and Installing J2ME Application MIDlets Download MIDlet Through Browser Memory Full Different Error Checks Download MIDlet Through Browser Memory full error Memory Full during installation process Application version already exists Memory Full help message during installation process Same Version of Application already exists on the handset Newer Application Version Exists Latest Newer Version of Application exists Lightweight Windowing Toolkit UDP Support Tell-A-Friend Option Shared JAD URLsOverview Accessing Tell-A-Friend from SMM Downloading from PC Via serial/USB Downloading through Browser Downloading through MMS Flexible URL for downloading functionality Get URL from Flex API Security Policy Implementation Multiple Key Press Key Intelligent Keypad Text Entry API ITAP Lcdui Refer to for Lcdui feature/class support for Midp Supported Text in forms is wrapped and scrolled Lcdui Lcdui feature/class Scenarios involved in launching midlet Auto Launch of Midlets Background Attribute Background ApplicationsBackground Java Application Lifecycle Background MIDlet Flip Behaviors Java service menu for a MIDlet with background attributes MIDlet Manager Menu Java System Menu View MIDlet Suite Information 105 106 J2ME Invisible NET Options Invisible Net for J2MEIntroduction 108 J2ME Context-Sensitive Menu Options Backward Compatibility/Flexing Establishing Connection Download Midlet through PC Operator Apps Provisioning Midp 2.0 Security Model Untrusted Domain Untrusted MIDlet Suites Permission Types concerning the Handset User Permission Interaction ModeTrusted MIDlet Suites Top Line of Prompt Implementation based on Recommended Security PolicyTrusted 3rd Party Domain Dialog Prompts Trusted MIDlet Suites Using x.509 PKISigning a MIDlet Suite Creating the Signing Certificate Signer of MIDlet SuitesMIDlet Attributes Used in Signing MIDlet Suites Inserting Certificates into JAD Authenticating a MIDlet SuiteCreating the RSA SHA-1 signature of the JAR Verifying the Signer Certificate Verifying the MIDlet Suite JAR Initial State Verification Result Appendix a Audio Mix Table Key Mapping for the C381p Appendix B Key Mapping 124 Available Memory Appendix C Memory Management Calculation Appendix D Online FAQ Graphic Description Appendix E Http Range C381p Spec Sheet Appendix F Spec Sheet Motorola C381p 130