연락처를 만들어 BlackBerry 단말기의 기본 연락처 목록 또는 다른 연락처 목록에 할당할 수 있습니다.

1. 필요한 클래스와 인터페이스를 가져옵니다.

   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. 새 연락처를 기본 연락처 목록에 추가하려면 PIM.openPIMList(int, int)를 호출하여 기본 연락처 목록 인스턴스를 열고, 열려는 목록의 형식(PIM.CONTACT_LIST) 및 PIM.READ_WRITE 액세스 모드를 매개 변수로 전달합니다. 4단계를 계속 진행합니다.

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

3. 새 연락처를 기본 연락처 목록이 아닌 연락처 목록에 추가하려면 다음 작업을 수행합니다.
   1. PIM.listPIMLists(int)를 호출하고 목록의 형식(PIM.CONTACT_LIST)을 매개 변수로 전달하여 String 객체의 배열이 반환되도록 합니다. 반환된 배열은 각 연락처 목록에 대해 시스템이 할당한 이름을 제공합니다. 기본 연락처 목록은 이 배열의 인덱스 0으로 반환됩니다.

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

   2. PIM.listPIMLists()에서 반환한 배열의 모든 요소를 반복하여 열려는 연락처 목록에 대해 시스템이 할당한 이름을 찾습니다.
   3. PIM.openPIMList(int, int, String)를 호출하여 연락처 목록 인스턴스를 열고, 열려는 목록의 형식(PIM.CONTACT_LIST), PIM.READ_WRITE 액세스 모드 및 연락처 목록 이름을 매개 변수로 전달합니다.

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

4. ContactList.createContact()를 호출하여 새 연락처를 연락처 목록에 추가합니다.

   BlackBerryContact contact = contactList.createContact();

5. 다음 메소드 중 하나 이상을 호출하여 새 연락처에 대한 정보를 추가합니다. PIMItem 메소드에 대한 자세한 내용은 BlackBerry Java Development Environment용 API 참조서를 참조하십시오.
   • addString()
   • addStringArray()
   • addDate()
   • addInt()
   • addBoolean()
   • addBinary()
6. 다음 메소드를 호출하여 지정된 연락처 필드의 크기 요구 사항 및 형식 요구 사항을 해당 정보가 충족하는지 확인합니다.
   • ContactList.isSupportedField(int)를 호출하여 항목이 해당 필드 형식을 지원하는지 확인합니다.
   • ContactList.isSupportedAttribute(int, int)를 호출하여 필드가 지정된 특성을 지원하는지 확인합니다.
   • PIMList.maxValues(int field)를 호출하여 필드가 지원하는 값의 수를 확인합니다.
7. Contact.commit()을 호출하여 변경 사항을 커밋합니다.

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

8. 다른 프로그램을 호출하는 프로그램이 해당 프로그램에 액세스할 수 있는 권한을 갖지 못한 경우 PIMException 및 ControlledAccessException이 발생하는지 확인합니다.