Troubleshooting guide

175
11: Using PIM applications
Code sample: Displaying a screen that lets BlackBerry device users add new
contacts
The following code sample demonstrates how to display a screen that lets BlackBerry® device users add new
contacts to their address books.
Example: ContactsDemo.java
/**
* ContactsDemo.java
* Copyright (C) 2002-2005 Research In Motion Limited.
*/
package com.rim.samples.docs.contactsdemo;
import java.io.*;
import java.util.*;
import javax.microedition.pim.*;
import net.rim.device.api.ui.*;
import net.rim.device.api.ui.component.*;
import net.rim.device.api.ui.container.*;
import net.rim.device.api.i18n.*;
import net.rim.device.api.system.*;
import net.rim.device.api.util.*;
import net.rim.blackberry.api.pdap.*;
public final class ContactsDemo extends UiApplication
Import a contact. 1. To return an array of PIM items, invoke fromSerialFormat().
ByteArrayInputStream is = new
ByteArrayInputStream(outputStream.toByteArray());
PIMItem[] pi = PIM.getInstance().fromSerialFormat(istream,
"UTF8");
2. To create a new contact using the PIM item, invoke
C
ontactList.importContact();
ContactList contactList =
(ContactList)PIM.getInstance().openPIMList(PIM.CONTACT_LIST,
PIM.READ_WRITE);
Contact contact2 = contactList.importContact((Contact)pi[0]);
contact2.commit();
3. To specify the character encoding to use when writing to the output stream, use the enc
parameter.
Delete a contact. >Invoke removeContact() on a contacts list.
contactList.removeContact(contact);
Close a contacts list. >Invoke close().
try {
contactList.close();
} catch(PIMException e) {
Dialog.alert(e.toString());
}
Task Steps