È possibile creare elenchi contatti su un dispositivo BlackBerry. Prendere nota delle seguenti informazioni sugli elenchi contatti creati:

• Ogni elenco contatti dispone di un ID univoco, che corrisponde al valore restituito da createPIMList().
• Gli elenchi contatti non dispongono di record di servizio e non supportano la sincronizzazione wireless.
• Le applicazioni possono effettuare registrazioni per rilevare le modifiche all'elenco contatti richiamando BlackBerryPIMList.addListener().

1. Importare le classi e le interfacce richieste.

   import javax.microedition.pim.Contact;
   import javax.microedition.pim.PIM;
   import javax.microedition.pim.PIMException;
   import javax.microedition.pim.PIMItem;
   import net.rim.blackberry.api.pdap.BlackBerryContact;
   import net.rim.blackberry.api.pdap.BlackBerryContactList;
   import net.rim.blackberry.api.pdap.BlackBerryPIM;
   import net.rim.blackberry.api.pdap.BlackBerryPIMList;

2. Recuperare un oggetto BlackBerryPIM.

   BlackBerryPIM myPIM = (BlackBerryPIM) PIM.getInstance();

3. Creare l'elenco contatti.

   long listUID = myPIM.createPIMList(PIM.CONTACT_LIST, "test");

   L'elenco contatti viene denominato utilizzando il nome fornito dall'utente ("test" nell'esempio precedente), a meno che non esista un altro elenco contatti con lo stesso nome nel dispositivo, nel qual caso viene aggiunto un numero al nome per renderlo univoco. Per fare riferimento all'elenco contatti in seguito, è necessario utilizzare l'UID dell'elenco, che corrisponde al valore restituito da createPIMList().
4. In alternativa, compilare l'elenco contatti.

   BlackBerryContactList contactList = 
      (BlackBerryContactList) myPIM.openPIMList(PIM.CONTACT_LIST, 
       PIM.READ_WRITE, listUID);
   Contact contact = contactList.createContact();
   String[] name = new String[contactList.stringArraySize(Contact.NAME)];
   name[Contact.NAME_GIVEN] = "Noha";
   name[Contact.NAME_FAMILY] = "Toma";
   contact.addStringArray(Contact.NAME, PIMItem.ATTR_NONE, name);
   contact.commit();

5. Chiudere l'elenco contatti.

   contactList.close();

BlackBerryPIM myPIM = (BlackBerryPIM) PIM.getInstance();
try 
{
   // create a contact list
   long listUID = myPIM.createPIMList(PIM.CONTACT_LIST, "test");
   // add a contact to the list
   BlackBerryContactList contactList = 
      (BlackBerryContactList) myPIM.openPIMList(PIM.CONTACT_LIST, 
       PIM.READ_WRITE, listUID);
   Contact contact = contactList.createContact();
   String[] name = new String[contactList.stringArraySize(Contact.NAME)];
   name[Contact.NAME_GIVEN] = "Noha";
   name[Contact.NAME_FAMILY] = "Toma";
   contact.addStringArray(Contact.NAME, PIMItem.ATTR_NONE, name);
   contact.addString(Contact.TEL, Contact.ATTR_HOME, "519-555-0151");
   contact.addString(Contact.TEL, Contact.ATTR_WORK, "519-555-0199");
   contact.commit();
   // close the contact list
   contactList.close();
} 
catch (PIMException e) 
{
   System.out.println(e.getMessage());
}