Using the PIM and FileConnection APIs | Sun Microsystems J2ME

8.4Well-Behaved MIDlets 66

9. Working With Mobile 3D Graphics 67

9.1 JSR 184 Overview 67

9.2Immediate Mode 67

9.3Retained Mode 68

9.4	Trading Quality for Speed 68
9.5	Creating Mobile 3D Graphics Content		69
10. Using the PIM and FileConnection APIs			71
10.1	The FileConnection API	71
10.2	The PIM API 72
11. Using the Bluetooth and OBEX APIs 73
11.1	Bluetooth Simulation Environment		73
11.2	OBEX Over Infrared 73
11.3	Setting OBEX and Bluetooth Preferences 74
	11.3.1 OBEX Preferences	74

11.3.2 Bluetooth Discovery Timeout 75

11.3.3 Bluetooth System Properties 75

11.3.4 Bluetooth BCC Properties 75

12. Using Web Services			77
A. Application Demonstrations 79
A.1	Overview	79
A.2	General Instructions 81
A.3	BluetoothDemo		82
A.4	Demo3D	83


	A.4.1	Life3D 83
	A.4.2	PogoRoo 84
	A.4.3	retainedmode 85
A.5	JSR172Demo		86
A.6	mmademo		86

vi J2ME Wireless Toolkit User’s Guide • October 2004

Image 6

Sun Microsystems J2ME manual Using the PIM and FileConnection APIs

Contents

User’s Guide Please Recycle Contents Using the Emulator Security and MIDlet Signing Using the PIM and FileConnection APIs Command Line Reference 103 Index Preface Who Should Use This BookRelated Documentation How This Book Is Organized Preface Accessing Documentation Online Typographic ConventionsWe Welcome Your Comments Introduction Quick Start Tools in the Toolkit KToolbar window Toolkit Features Supported JCP APIs in the J2ME Wireless ToolkitSupported Technology Mmapi Developing MIDlet Suites About Projects Creating a new project Simple Development Cycle Edit Source Code Build 3 Run Messages about building List of project MIDlets Full Development Cycle Package Install Emulator AMS welcome screen URL prompt Application menu, again Using an Obfuscator Launching the installed application Obfuscate.script.name scriptfile Using a Debugger Deploying Applications on a Web Server From the command line, run Working With Projects Selecting APIs Project settings window Changing MIDlet Suite Attributes Editing MIDlet suite attributes Manipulating MIDlets List of MIDlets in a project Using the Push Registry Project push registry settings Using Third-Party Libraries Project Directory StructureProject directory structure Configuring KToolbar Third-Party Libraries for One ProjectThird-Party Libraries for All Projects Setting the Application Directory Setting the javac Encoding PropertyWorking with Revision Control Systems 28 J2ME Wireless Toolkit User’s Guide October Using the Emulator Emulator SkinsEmulator skins Using the Emulator DefaultColorPhone emulator skin Setting Emulator Preferences Network ProxiesKeyboard shortcuts Storage and Cleaning Heap Size Adjusting Emulator Performance Choose Edit Preferences... and click on the Performance tab Pausing and Resuming Adjusting the emulator’s performance Using Third Party Emulators Running the Emulator Solo Emulators 38 J2ME Wireless Toolkit User’s Guide October Using the Profiler Monitoring Applications Turning on the profiler Call Graph Execution Time and Number of Calls Using the Memory Monitor Saving and Loading Profiler Information You’ll see a table with the following columns Using the Network Monitor Saving and Loading Memory Monitor Information Filtering Messages Network monitor Network monitor filter settings Sorting MessagesSaving and Loading Network Monitor Information Clearing the Message Tree 48 J2ME Wireless Toolkit User’s Guide October Security and MIDlet Signing Permissions Protection Domains MIDlet suite permissions Signing a MIDlet Suite Managing Keys Creating a New Key Pair Getting Real Keys Creating a new key pair Managing Certificates Importing an Existing Key PairRemoving a Key Pair Importing Certificates Certificate manager Removing Certificates Using the Wireless Messaging API Setting Emulator Phone Numbers Setting WMA preferences Simulating an Unreliable Network Sending Messages With the WMA Console Sending a Text SMS Message Sending a Binary SMS Message Sending a text message Sending Text or Binary CBS Messages Sending a binary message Sending MMS Messages Sending CBS messages Adding recipients for an MMS message Using the Network Monitor with WMA Receiving Messages in the WMA Console Using the Mobile Media API Supported Formats and ProtocolsSupported Mmapi media formats Using MediaControlSkin Media CaptureWell-Behaved MIDlets Immediate Mode Working With Mobile 3D GraphicsJSR 184 Overview Retained Mode Trading Quality for Speed Creating Mobile 3D Graphics Content 70 J2ME Wireless Toolkit User’s Guide October Using the PIM and FileConnection APIs FileConnection API PIM API Managing filesystem roots Using the Bluetooth and Obex APIs Bluetooth Simulation EnvironmentObex Over Infrared Setting Obex and Bluetooth Preferences Obex Preferences Bluetooth BCC Properties Bluetooth Discovery TimeoutBluetooth System Properties BCC properties 76 J2ME Wireless Toolkit User’s Guide October Using Web Services Web services stub generator 78 J2ME Wireless Toolkit User’s Guide October Application Demonstrations Overview \WTK22\apps\WMADemo\src\example\sms\SMSSend.java Application demonstrations General Instructions KToolbar BluetoothDemo Opening a demonstration application project Running the Bluetooth Demo server Demo3D Life3D PogoRoo Controls for Life3D Retainedmode Bouncing kangaroo JSR172Demo Mmademo Simple Tones Simple Player Player commands PausingAudioTest Video ObexDemo Attributes for mmademoDescriptions of MMAPI-specific MIDlet attributes Waiting for an Obex connection Prompting to accept a connection PDAPDemo Browsing Files Contents of the root1 directory PIM API Choosing a list type To actually save the list item, choose Commit from the menu WMADemo Saving an item Sending a text message Push registry springs to life Addressing an MMS message WMADemo receives the image Command Line Reference PrerequisitesDevelopment Cycle Preverify options files directories Jar cfm MyApp.jar MANIFEST.MF -C classes . -C res Run=storagename storagenumber Debugging Remove=storagename storagenumber all Toolkit component commands Launching Toolkit GUI ComponentsEmulator Preferences Properties List Monitor Enable memory monitor Using Security Features Changing the Emulator’s Default Protection Domain Signing MIDlet Suites Managing Certificates Using the Stub Generator Options for the wscompile CommandOptions Command Supported Features -f for wscompile Example Locale Setting Internationalization Emulated Locale Character Encodings Font Support in the Default Emulator Java Compiler Encoding Setting 118 J2ME Wireless Toolkit User’s Guide October Index Ktools.properties, 27 ktools.properties ﬁle Index 122 J2ME Wireless Toolkit User’s Guide October