Crear un contacto y asignarlo a una lista de contactos

Puede crear un contacto y asignarlo a la lista de contactos predeterminada o bien a otra lista de contactos de un dispositivo BlackBerry.

  1. Importe las clases y las interfaces necesarias.
    import net.rim.blackberry.api.pdap.BlackBerryContact; 
    import net.rim.blackberry.api.pdap.BlackBerryContactList;
    import net.rim.blackberry.api.pdap.BlackBerryPIMList;
    import net.rim.device.api.system.ControlledAccessException;
    import javax.microedition.pim.PIM;
    import javax.microedition.pim.PIMList;
    import javax.microedition.pim.PIMException;
    import javax.microedition.pim.ContactList;
  2. Para agregar el contacto nuevo a la lista de contactos predeterminada, invoque PIM.openPIMList(int, int) para abrir una instancia de la lista de contactos predeterminada, pasando como parámetros el tipo de lista que se va a abrir (PIM.CONTACT_LIST) y el modo de acceso PIM.READ_WRITE. Avance hasta el paso 4.
    BlackBerryContactList contactList = (BlackBerryContactList) 
        PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE);
  3. Para agregar el contacto nuevo a una lista de contactos que no sea la lista de contactos predeterminada, realice las acciones siguientes:
    1. Invoque PIM.listPIMLists(int), pasando como parámetro el tipo de lista (PIM.CONTACT_LIST), para devolver una matriz de objetos String. La matriz devuelta ofrece los nombres asignados por el sistema a cada lista de contactos. La lista de contactos predeterminada se devuelve en el índice 0 de la matriz.
      String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);
    2. Itere sobre la matriz que devuelve PIM.listPIMLists() para buscar el nombre asignado por el sistema a la lista de contactos que desea abrir.
    3. Invoque PIM.openPIMList(int, int, String) para abrir la instancia de la lista de contactos, pasando como parámetro el tipo de lista que se va a abrir (PIM.CONTACT_LIST), el modo de acceso PIM.READ_WRITE y el nombre de la lista de contactos.
      BlackBerryContactList contactList = (BlackBerryContactList) 
          PIM.getInstance().openPIMList(PIM.CONTACT_LIST, PIM.READ_WRITE, name);
  4. Invoque ContactList.createContact() para agregar el contacto nuevo a la lista de contactos.
    BlackBerryContact contact = contactList.createContact();
  5. Invoque uno o más de los métodos siguientes para agregar información referente al contacto nuevo. Para obtener más información acerca de métodos PIMItem, consulte la referencia de API para BlackBerry Java Development Environment.
    • addString()
    • addStringArray()
    • addDate()
    • addInt()
    • addBoolean()
    • addBinary()
  6. Invoque los métodos siguientes para comprobar que la información cumple los requisitos de tamaño y de tipo del campo especificado del contacto.
    • Invoque ContactList.isSupportedField(int) para comprobar que el elemento es compatible con el tipo de campo.
    • Invoque ContactList.isSupportedAttribute(int, int) para comprobar que el campo es compatible con el atributo especificado.
    • Invoque PIMList.maxValues(int field) para comprobar el número de valores con los que es compatible el campo.
  7. Invoque Contact.commit() para acometer los cambios.
    if(contact.isModified())
    {
        contact.commit();
    }
  8. Busque PIMException y ControlledAccessException si su aplicación no tiene permiso para acceder a la aplicación que invoca.

¿Le ha resultado útil esta información? Envíenos sus comentarios.