Criar uma lista de contatos

Você pode criar listas de contatos em um aparelho BlackBerry. Observe o seguinte sobre as listas de contatos que você cria:

  • Cada lista de contatos tem um ID exclusivo, que é o valor retornado por createPIMList().
  • As listas de contatos não têm registros de serviço e não suportam sincronização sem fio.
  • Os aplicativos podem se registrar para escutar alterações da sua lista de contatos invocando BlackBerryPIMList.addListener().
  1. Importe as classes e interfaces necessárias.
    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. Recupere um objeto BlackBerryPIM.
    BlackBerryPIM myPIM = (BlackBerryPIM) PIM.getInstance();
  3. Crie a lista de contatos.
    long listUID = myPIM.createPIMList(PIM.CONTACT_LIST, "test");
    A lista de contatos é nomeada usando o nome que você fornece ("teste" no exemplo anterior), a menos que haja outra lista de contatos com esse nome no aparelho, caso em que um número é anexado para torná-lo exclusivo. Para consultar a lista de contatos posteriormente, você deve usar o UID da lista, que é o valor retornado por createPIMList().
  4. Opcionalmente, preencha a lista de contatos.
    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. Feche a lista de contatos.
    contactList.close();

Exemplo de código

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());
}

Estas informações foram úteis? Gostaríamos de receber seus comentários.