Per recuperare informazioni da un elenco contatti su un dispositivo BlackBerry, richiamare uno dei metodi PIMList.items(). Questi metodi restituiscono un elenco di tutti i contatti in un elenco contatti specifico. È possibile richiamare i metodi BlackBerryContactList.items() per restituire i gruppi di contatti.

1. Importare le classi e le interfacce richieste.

   import net.rim.blackberry.api.pdap.BlackBerryContact;
   import net.rim.blackberry.api.pdap.BlackBerryContactList;
   import net.rim.blackberry.api.pdap.BlackBerryPIMList;
   import java.util.Enumeration;
   import javax.microedition.pim.PIM;
   import javax.microedition.pim.PIMException;
   import javax.microedition.pim.PIMItem;

2. Richiamare PIM.getInstance() per recuperare un'istanza di PIM, quindi richiamare PIM.openPIMList() per aprire l'istanza dell'elenco contatti, passando come parametri il tipo di elenco da aprire (PIM.CONTACT_LIST), la modalità di accesso con cui aprire l'elenco (PIM.READ_WRITE, PIM.READ_ONLY o PIM.WRITE_ONLY) e il nome, qualora non si stia aprendo l'elenco contatti predefinito.

   BlackBerryContactList contactList = (BlackBerryContactList) 
       PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);

3. Richiamare PIMList.items() per recuperare un'enumerazione di voci in un elenco contatti.

   Enumeration _enum = contactList.items();

4. Richiamare uno dei metodi getter PIMItem per recuperare le informazioni di contatto.
   • Per recuperare una matrice di campi che contengono i dati per un contatto specifico, richiamare PIMItem.getFields().
   • Per recuperare un elemento String che rappresenti il valore per un campo di contatto specificato, richiamare PIMItem.getString(int field, int index).
   • Per recuperare una data che rappresenti il valore per un campo di contatto specificato, richiamare PIMItem.getDate(int field, int index).

   while (_enum.hasMoreElements())
   {
        BlackBerryContact c = (BlackBerryContact)_enum.nextElement();
        int[] fieldIds = c.getFields();
        int id;
        for(int index = 0; index < fieldIds.length; ++index)
        {
             id = fieldIds[index];
             if(c.getPIMList().getFieldDataType(id) == BlackBerryContact.STRING)
             {
                  for(int j=0; j < c.countValues(id); ++j)
                  {
                       String value = c.getString(id, j);
                       System.out.println(c.getPIMList().getFieldLabel(id) + "=" 
                         + value);
                  }
             }
        }
   }