Skip Headers
Oracle® Java Micro Edition Software Development Kit Developer's Guide
Release 3.4 for NetBeans on Windows
  Go To Table Of Contents
Go To Index


16 JSR 75: PDA Optional Packages

The Oracle Java ME SDK supports JSR 75, the PDA Optional Packages (PDAP) for the J2ME Platform. JSR 75 includes two independent APIs:

This chapter describes how the Oracle Java ME SDK implements the FileConnection and PIM APIs.

16.1 FileConnection API

On an external device, the FileConnection API typically provides access to files stored in the device's memory or on a memory card.

In the Oracle Java ME SDK emulator, the FileConnection API enables MIDlets to access files stored on your computer's hard disk.

The files that can be accessed using the FileConnection optional package are stored in the following subdirectory:


For example, the JavaMEPhone1 emulator instance comes with a root directory installed named root1. Each subdirectory of filesystem is called a root. The Oracle Java ME SDK provides a mechanism for managing roots.

While the emulator is running, click the Tools menu and select Manage File System. The Manage File System dialog box opens.

In the Mounted File System Root Directories panel you can mount, unmount, or unmount and delete filesystem roots. Mounted roots are displayed in the top list, and unmounted roots are listed in the Unmounted File System Root Directories panel. You can remount or delete a selected directory. Mounted root directories and their subdirectories are available to applications using the FileConnection API. Unmounted roots can be remounted in the future.

16.2 PIM API

The Oracle Java ME SDK emulator stores contact, calendar, and to-do information in standard files on your desktop computer's hard disk. All information is stored in:


Each device instance has its own data. Lists are stored in subdirectories of the contacts, events, and todo directories. For example, a contact list called Contacts is contained in installdir\appdb\PIM\contacts\Contacts.

Inside the list directory, items are stored in vCard (.vcf) or vCalendar (.vcs) format (see Contacts are stored in vCard format, while calendar and to-do items are both stored in vCalendar format.

16.3 Running PDAPDemo

PDAPDemo shows how to use the PIM and FileConnection APIs that are part of the JSR 75 specification.

16.3.1 Browsing Files

The default emulators have one directory, root1. This directory is located at:


For test purposes, copy files or even directories into root1. You can also add other directories at the same level as root1.

Now open and run the PDAPDemo project.

  • Launch the FileBrowser MIDlet. You see a directory listing, and you can browse through the directories and files you have placed there.

  • Select a directory and press the View soft button to enter it.

  • Using the Menu commands you can view a file or see its properties. Try selecting the file and choosing Properties or View from the menu.

    You can view the content of text files in the browser.

  • Try using the External Events Generator to unmount and mount directories. Unmounted directories are not visible in the application running on the emulator.

16.3.2 The PIM API

The JSR75 PIM APIs example demonstrates how to access personal information, such as contact lists, calendars, and to-do lists.

  • After you launch the example, select a type of list from the main menu.

    In this example each type of list works the same way and each list type contains a single list. For example, if you select Contact Lists, there is a single contact list called Contacts. Event Lists contains a single list called Events, and To-Do Lists contains a single list named To Do.

  • After you have selected a list type and chosen the specific list, you can view all the items in the list. If this is the first time you have run the example, the list might be empty.

  • To add an item, select New from the menu. The application prompts you for a Formatted Name for the item.

    To add more data fields to this item select Add Field. You see a list of field names. Pick as many as you like. You can fill in the fields at any time.

  • To save the new item, select Commit from the menu.

    To return to the list, select the Back command. You see the item you just created in the list.

    The items that you create are stored in standard vCard or vCalendar format in this directory:


The PIM API allows for exporting contact, calender, and to-do items in a standard format. The exact format depends on the list type. When you are viewing an item in any list, the menu contains a command for viewing the exported item.

For example, when you are viewing a contact list item, the menu contains Show vCard. When you select this command, the exported item is shown on the screen. Calendar items and to-do items both get exported as vCalendar.