Class and interface support

This section lists the implementation specifics of the Personal Information Management API at package level.

The javax.microedition.pim package contains PIM API classes and interfaces.

The PIMList.getFieldLabel(), PIMList.getAttributeLabel(), and PIMList.getArrayElementLabel() methods should be used for obtaining localized labels for fields, attributes, and string array elements.

The implementation supports PIMLists as described in the following table, ordered:

Table 5: The PIMLists supported by the implementation

List name

List type

Corresponding PIM data

Contacts

ContactList

Phonebook entries in device memory

Appointments

EventList

Calendar Appointment entries

Day notes

EventList

Calendar Day Note entries

Anniversaries

EventList

Calendar Anniversary entries

To-do notes

ToDoList

To-do list entries

The list names depend on the used localization variant. For more information, see the section Runtime environment.

The Contact, Day notes and To-do notes item objects in lists are persistent so that they are read from the database during list initialization. After this, external changes are applied to the items so that there is no need to reread entire lists.

The items are refreshed from a native database whenever any of the PIMList.items() variations is called.