本文概要：
在获取通讯录的时候会遇到各种坑。虽然网上也有不少关于该部分的内容，但大多数不能满足我的需求。所以按照一贯的风格，自己动手丰衣足食。

通讯录中遇到的坑

通讯录是我们每天都会用到的应用，算是我们再也熟悉不过的。最近一段时间一直在做关于电话的应用，或多或少的会获取通讯录信息。这部分代码的分析网上有一大堆。感兴趣的同学可以自己搜索学习。但在我看来这部分的内容，其实还是有点复杂的。获取通讯录的时候会牵扯到很多张表，刚开始的时候确实会让人摸不着脉。特别是网上的资料，因为作者出发的角度不同，所以使用的API也会不一样。这样会给初学者带来很多烦恼，从而使他们无法清楚的知道该如何正确的定制属于他们的需要。

填坑

通讯录的使用无非就是查询、添加和删除。是的，你没有听错就是万能的增删改查。在这里我对查询和添加做了一个封装，在大多数情况下基本能够满足我们的需要了。

1、查询

查询的核心代码如下。

// 本地通讯录数据
 public List<Contacts> contacts; //这里的Contacts是我们自定义的类
 
//加载本地通讯录
 public void loadContacts() {
  contacts = new ArrayList<Contacts>();
  new AsyncTask<Object, Object, String>(){
   protected String doInBackground(Object... arg0) {
    String id;
    String mimetype;
    ContentResolver contentResolver = BaseApplication.getContextObject().getContentResolver();
    //只需要从Contacts中获取ID，其他的都可以不要，通过查看上面编译后的SQL语句，可以看出将第二个参数
    //设置成null，默认返回的列非常多，是一种资源浪费。
    Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI,
      new String[]{android.provider.ContactsContract.Contacts._ID}, null, null, null);
    Contacts contactitem;
    while(cursor.moveToNext()) {
     contactitem = new Contacts();//查询的要创建新的contacts对象
     id=cursor.getString(cursor.getColumnIndex(android.provider.ContactsContract.Contacts._ID));
     //从一个Cursor获取所有的信息
     Cursor contactInfoCursor = contentResolver.query(
       android.provider.ContactsContract.Data.CONTENT_URI,
       new String[]{android.provider.ContactsContract.Data.CONTACT_ID,
         android.provider.ContactsContract.Data.MIMETYPE,
         android.provider.ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME, //用户名
         android.provider.ContactsContract.CommonDataKinds.Organization.COMPANY,//公司
         android.provider.ContactsContract.CommonDataKinds.Organization.TITLE,//职称
         android.provider.ContactsContract.CommonDataKinds.Phone.TYPE,//电话属性
         android.provider.ContactsContract.CommonDataKinds.Phone.NUMBER,// 电话号码
         android.provider.ContactsContract.CommonDataKinds.Email.TYPE,//邮件属性
         android.provider.ContactsContract.CommonDataKinds.Email.DATA,//邮件信息
         android.provider.ContactsContract.CommonDataKinds.Note.NOTE,//备注
         android.provider.ContactsContract.Data.DATA1,//查询的细节
         android.provider.ContactsContract.Data.DATA5
       }, 
       android.provider.ContactsContract.Data.CONTACT_ID+"="+id, null, null);
     while(contactInfoCursor.moveToNext()) {
      mimetype = contactInfoCursor.getString(
        contactInfoCursor.getColumnIndex(android.provider.ContactsContract.Data.MIMETYPE));

      if (mimetype.equals(StructuredName.CONTENT_ITEM_TYPE)) {
       String name = contactInfoCursor.getString(contactInfoCursor  
         .getColumnIndexOrThrow(android.provider.ContactsContract.CommonDataKinds.StructuredName.GIVEN_NAME));
       //LogUtils.E("====name==="+name);
       contactitem.setName(name);
      } else if (mimetype.equals(Organization.CONTENT_ITEM_TYPE)) {
       String org = contactInfoCursor.getString(contactInfoCursor  
         .getColumnIndexOrThrow(android.provider.ContactsContract.CommonDataKinds.Organization.COMPANY));
       String title = contactInfoCursor.getString(contactInfoCursor  
         .getColumnIndexOrThrow(android.provider.ContactsContract.CommonDataKinds.Organization.TITLE));
       String department = contactInfoCursor.getString(contactInfoCursor  
         .getColumnIndexOrThrow(android.provider.ContactsContract.CommonDataKinds.Organization.DEPARTMENT));
       //LogUtils.E("====org==="+org+","+title);
       contactitem.setOrganization(org);
       contactitem.setJobtitle(title);
       contactitem.setDepartment(department);
      } else if (mimetype.equals(Phone.CONTENT_ITEM_TYPE)) {
       String type = contactInfoCursor.getString(contactInfoCursor  
         .getColumnIndexOrThrow(android.provider.ContactsContract.CommonDataKinds.Phone.TYPE));
       String number;
       String phonename = null;
       int a = Integer.parseInt(type);
       switch (a){
       case Phone.TYPE_MOBILE:
        phonename = "mobile";
        break;
       case Phone.TYPE_MAIN:
        phonename = "main";
        break;
       case Phone.TYPE_HOME:
        phonename = "home";
        break;
       case Phone.TYPE_WORK:
        phonename = "work";
        break;
       case Phone.TYPE_FAX_WORK:
        phonename = "fax_work";
        break;
       case Phone.TYPE_FAX_HOME:
        phonename = "fax_home";
        break;
       case Phone.TYPE_OTHER:
        phonename = "other";
        break;
       case Phone.TYPE_CUSTOM:
        phonename = "custom";
        break;
       }
       number = contactInfoCursor.getString(contactInfoCursor  
         .getColumnIndexOrThrow(android.provider.ContactsContract.CommonDataKinds.Phone.NUMBER));
       //LogUtils.E("====phone==="+phonename+","+number);
       ContactFields cf = new ContactFields("Contact::Phone", phonename, number);
       contactitem.contact_fields.add(cf);

      } else if (mimetype.equals(Email.CONTENT_ITEM_TYPE)) {
       String type = contactInfoCursor.getString(contactInfoCursor  
         .getColumnIndexOrThrow(android.provider.ContactsContract.CommonDataKinds.Email.TYPE));
       String emailname = null;
       switch (Integer.parseInt(type)) {
       case Email.TYPE_WORK:
        emailname = "work";
        break;
       case Email.TYPE_CUSTOM:
        emailname = "custom";
        break;
       case Email.TYPE_MOBILE:
        emailname = "mobile";
        break;
       case Email.TYPE_HOME:
        emailname = "home";
        break;
       case Email.TYPE_OTHER:
        emailname = "other";
        break;
       }
       String date = contactInfoCursor.getString(contactInfoCursor  
         .getColumnIndexOrThrow(android.provider.ContactsContract.CommonDataKinds.Email.DATA));
       //LogUtils.E("====email==="+emailname+","+date);
       ContactFields cf = new ContactFields("Contact::Email", emailname, date);//ContactFields也是我自定义的一个对象，你可以根据需要定义自己的bean类
       contactitem.contact_fields.add(cf);

      } else if (mimetype.equals(Note.CONTENT_ITEM_TYPE)) {
       String note = contactInfoCursor.getString(
         contactInfoCursor.getColumnIndex(android.provider.ContactsContract.CommonDataKinds.Note.NOTE));
//       LogUtils.E("====note==="+note);
       contactitem.setNote(note);
      }
     }
     contacts.add(contactitem);
//     System.out.println("*********");
     contactInfoCursor.close();
    }
    cursor.close();
   
    return null;
   }
   
  }.execute();
 }

在上面的代码中mimetype属性是十分重要的。它是android.provider.ContactsContract.Data.MIMETYPE属性的内容。通过它我们可以判断当前获取数据表的列是哪种CONTENT_ITEM_TYPE。之后根据需要在对应的mimetype下，通过android.provider.ContactsContract.CommonDataKind来获取对应索引列下的内容。代码中的关键部分我都做了注释。至于android.provider.ContactsContract的用法和详细说明，请自行查找相关文档，在此不做过多介绍。

2、添加

添加的道理也是一样，根据需要通过mimetype往通讯录数据库中添加内容。内容不是很复杂，直接上代码

/** 
  * 添加新的联系人
  * @param name 名称 -- 不可为空
  * @param company 公司
  * @param position 职位
  * @param numberlist 电话列表
  * @param emaillist 邮箱列表
  * @param note 备注
  */
 public static void addContacts(Bitmap avatar, String name, String company, String position, List<AddContactsNumberItem> numberlist,
   List<AddContactsNumberItem> emaillist, String note){//AddContactsNumberItem为我自定义类，用来存放phone，email这样的存在多条记录的属性值

  ContentValues values = new ContentValues();
  // 首先向RawContacts.CONTENT_URI执行一个空值插入，目的是获取系统返回的rawContactId
  Uri rawContactUri = EPApplication.getContextObject().getContentResolver().insert(
    RawContacts.CONTENT_URI, values);//EPApplication是我定义的Application的子类，getContextObject方法返回的是context
  long rawContactId = ContentUris.parseId(rawContactUri);
  // 表插入姓名数据
  values.clear();
  values.put(Data.RAW_CONTACT_ID, rawContactId);
  values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);// 内容类型
  values.put(StructuredName.GIVEN_NAME, name);
  EPApplication.getContextObject().getContentResolver().insert(ContactsContract.Data.CONTENT_URI,
    values);

  //添加公司和地址
  if (company != null || position != null) {
   values.clear();
   values.put(Data.RAW_CONTACT_ID, rawContactId);
   values.put(Data.MIMETYPE, Organization.CONTENT_ITEM_TYPE);
   if(company != null){
    values.put(Organization.COMPANY, company);
   }
   if (position != null) {
    values.put(Organization.TITLE, position);
   }
   values.put(Organization.TYPE, Organization.TYPE_WORK);
   EPApplication.getContextObject().getContentResolver().insert(ContactsContract.Data.CONTENT_URI,
     values);
  }
  
  // 插入电话数据
  if (numberlist != null && numberlist.size()>0) {
   for (AddContactsNumberItem item : numberlist) {
    int type = 0;
    if (item.getName().equals("手机")) {
     type = Phone.TYPE_MOBILE;
    } else if (item.getName().equals("工作")){
     type = Phone.TYPE_WORK;
    } else if (item.getName().equals("家庭")){
     type = Phone.TYPE_HOME;
    } else if (item.getName().equals("工作传真")){
     type = Phone.TYPE_FAX_WORK;
    } else if (item.getName().equals("家庭传真")){
     type = Phone.TYPE_FAX_HOME;
    } else if (item.getName().equals("其他")){
     type = Phone.TYPE_OTHER;
    }
    values.clear();
    values.put(Data.RAW_CONTACT_ID, rawContactId);
    values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
    values.put(Phone.NUMBER, item.getContent());
    values.put(Phone.TYPE, type);
    EPApplication.getContextObject().getContentResolver().insert(ContactsContract.Data.CONTENT_URI,
      values);
   }
  }
  
  //添加邮箱
  if (emaillist != null && emaillist.size()>0) {
   for (AddContactsNumberItem item : emaillist) {
    int type = 0;
    if (item.name.equals("工作")) {
     type = Email.TYPE_WORK;
    } else if (item.name.equals("家庭")) {
     type = Email.TYPE_HOME;
    } else if (item.name.equals("其他")) {
     type = Email.TYPE_OTHER;
    }
    values.clear();
    values.put(Data.RAW_CONTACT_ID, rawContactId);
    values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
    values.put(Email.DATA, item.getContent());
    values.put(Email.TYPE, type);
    EPApplication.getContextObject().getContentResolver().insert(ContactsContract.Data.CONTENT_URI,
      values);
   }
  }
  
  // 添加备注
  if (note != null && !note.isEmpty()) {
   values.clear();
   values.put(Data.RAW_CONTACT_ID, rawContactId);
   values.put(Data.MIMETYPE, Note.CONTENT_ITEM_TYPE);
   values.put(Note.NOTE, note);
   EPApplication.getContextObject().getContentResolver().insert(ContactsContract.Data.CONTENT_URI,
     values);
  }
  
  // 设置头像
  if (avatar != null) {
   values.clear();
   values.put(Data.RAW_CONTACT_ID, rawContactId);
   values.put(Data.MIMETYPE, Photo.CONTENT_ITEM_TYPE);
   ByteArrayOutputStream array = new ByteArrayOutputStream();
   avatar.compress(Bitmap.CompressFormat.JPEG, 80, array);
   values.put(Photo.PHOTO, array.toByteArray());
   EPApplication.getContextObject().getContentResolver().insert(ContactsContract.Data.CONTENT_URI,
     values);
  }
 }

小结

每个人对通讯录的理解都有不同，这也说明通讯录使用的灵活性。不管是通讯录还是其他的什么知识，我们都可以用方便自己的形式进行记录和理解。最近一段时间看了很多书，对IOS的开发也在继续深入中。也许正是因为开始了一门新的语言swift，所以才会让我对“吃饭的家伙”Android，有了更深和更客观的认识。如果可能的话，还是多了解一门语言吧。确实会有很多说不出的帮助和提升。也许明年会研究一下HTML5和JS吧。明天的事谁又说的准呢！