Vous pouvez créer un contact et l'affecter à la liste de contacts par défaut ou à une autre liste de contacts sur un terminal BlackBerry.

1. Importez les classes et les interfaces requises.

   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. Pour ajouter le nouveau contact à la liste de contacts par défaut, appelez PIM.openPIMList(int, int) pour ouvrir l'instance de la liste de contacts par défaut, en transmettant comme paramètres le type de liste à ouvrir (PIM.CONTACT_LIST) et le mode d'accès PIM.READ_WRITE. Passez à l'étape 4.

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

3. Pour ajouter le nouveau contact à une liste de contacts qui n'est pas la liste de contacts par défaut, procédez comme suit :
   1. Appelez PIM.listPIMLists(int) en transmettant comme paramètre le type de liste à ouvrir (PIM.CONTACT_LIST), pour renvoyer un tableau d'objets String. Le tableau renvoyé fournit les noms attribués par le système pour chaque liste de contacts. La liste de contacts par défaut est renvoyée à l'index 0 du tableau.

      String[] lists = PIM.listPIMLists(PIM.CONTACT_LIST);

   2. Itérez dans le tableau renvoyé par PIM.listPIMLists() pour rechercher le nom attribué par le système à la liste de contacts que vous souhaitez ouvrir.
   3. Appelez PIM.openPIMList(int, int, String) pour ouvrir l'instance de la liste de contacts, en transmettant comme paramètres le type de liste à ouvrir (PIM.CONTACT_LIST), le mode d'accès PIM.READ_WRITE et le nom de la liste de contacts.

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

4. Appelez ContactList.createContact() pour ajouter le nouveau contact à la liste de contacts.

   BlackBerryContact contact = contactList.createContact();

5. Appelez des méthodes parmi les suivantes afin d'ajouter des informations au nouveau contact. Pour plus d'informations à propos des méthodes PIMItem, consultez la référence API de BlackBerry Java Development Environment.
   • addString()
   • addStringArray()
   • addDate()
   • addInt()
   • addBoolean()
   • addBinary()
6. Appelez les méthodes suivantes pour vérifier que les informations répondent aux exigences de taille et de type du champ de contact indiqué.
   • Appelez ContactList.isSupportedField(int) pour vérifier que l'élément prend en charge le type de champ.
   • Appelez ContactList.isSupportedAttribute(int, int) pour vérifier que le champ prend en charge l'attribut indiqué.
   • Appelez PIMList.maxValues(int field) pour vérifier le nombre de valeurs pris en charge par le champ.
7. Appelez Contact.commit() pour valider les modifications.

   if(contact.isModified())
   {
       contact.commit();
   }

8. Recherchez toute exception PIMException et ControlledAccessException si votre application n'est pas autorisée à accéder à l'application appelée.