Android通讯录的管理（联系人的增删改查）

Android中的联系人存储是通过ContentProvider实现的。因此APP对系统通讯录进行操作涉及到ContentProvider接口的使用。

通讯录存储常用的数据库表

使用有关接口前，首先了解一下通讯录数据库中常用的数据库表：

表名	表用途
contacts	联系人表，存储了实际的联系人姓名，头像，最后通话时间等信息。 会对实际的联系人数据进行一定去重。
raw_contacts	实际的联系人数据表，每一行是一个单独的联系人。 会存在多行对应同一个contacts表中条目的情况。
data	所有联系人信息数据。通过raw_contact_id外键与raw_contacts建立联系。

contacts与raw_contacts的区分
一个raw_contacts对应一个联系人，程序中或用户操作生成新的联系人，就是直接在这个表中插入新条目。
contacts是实际通讯录中显示的联系人——当raw_contacts中存在相同名称的联系人时，系统会将这几个联系人合并。
（例如通过通讯录添加两个名字相同的名片，这时系统会提示是否要对这两个名片进行合并。）

data表
1.data表每一行都是一项数据(姓名，电话，Email，网址，生日等)。并通过外键raw_contacts_id与raw_contacts表关联起来。
2.由1所述，一个联系人根据情况会有多条data数据。数据存储在data1-15这15列中。
例如某一行存储电话号码，那么在表中data1列存储电话号码，data2列存储号码类型（单位／家庭／组织等）。
又例如某一行存储的联系人姓名，那么data1列存储显示在界面上的名称，data2存储名，data3存储姓。
3.依数据类型不同，data1-14的含义会不同；data15默认存储blob二进制形式的数据。
4.那么又如何区分不同行数据的真实类型呢？是通过data表中mimetype_id列的值（整形）来进行区分。根据这一列的取值，对data1-14进行不同的解析。mimetype_id中数值与类型的对应关系在mimetypes表中定义。例如：

_id	mimetypes	含义
1	vnd.android.cursor.item/email_v2	电子邮件
2	vnd.android.cursor.item/im	即时通讯
3	vnd.android.cursor.item/nickname	昵称

在编写代码时，实际传入的是mimetypes中的字符串参数，而不是ID值。

以上数据库中所有表及字段的定义，都可在android.provider.ContactsContract中找到。
通讯录存储的数据文件在/data/data/com.android.providers.contacts/databases/目录下，需要手机获取Root权限。

对通讯录进行增删改查

按电话号码查询联系人

Uri phoneUri = Uri.withAppendedPath(ContactsContract.CommonDataKinds.Phone.CONTENT_FILTER_URI, Uri.encode(phone));

ContentResolver resolver = context.getContentResolver();
Cursor cursor = resolver.query(phoneUri, new String[]{ContactsContract.CommonDataKinds.Phone._ID, 
    ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME, ContactsContract.CommonDataKinds.Phone.CONTACT_ID}, null, null, null);

while (cursor.moveToNext()) {
    int id = cursor.getInt(0);
    String name = cursor.getString(1);
    int contactId = cursor.getInt(2);
    if (name.equals(user.getName())) {
        deleteList.add(id);
    }
}

注意这里使用的URL是ContactsContract.CommonDataKinds.Phone.CONTENT_FILTER_URI，而不是ContactsContract.PhoneLookup.CONTENT_FILTER_URI。
这是由于PhoneLookup.CONTENT_FILTER_URI会以用户提供的手机号查询后，再使用标准格式的电话号码再次查找，会返回两个相同的结果。例如用户提供了号码17000000000，那么程序会先查询17000000000号码，再查询+86 17000000000，并且两次查询都会成功。

查询通讯录中所有联系人

Uri uri = ContactsContract.Data.CONTENT_URI;
ContentResolver resolver = context.getContentResolver();
Cursor cursorUser = resolver.query(uri, new String[]{ContactsContract.CommonDataKinds.Phone._ID,
    ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME, ContactsContract.CommonDataKinds.Phone.RAW_CONTACT_ID}, null, null, null);

while( cursorUser.moveToNext()) {
    int id = cursorUser.getInt(0); // 按上面数组的声明顺序获取
    String name = cursorUser.getString(1);
    int rawContactsId = cursorUser.getInt(2);
}

删除联系人某项数据(Data中某一项)

int id; // data表中对应的id值
ArrayList<ContentProviderOperation> ops = new ArrayList<>();
ops.add(ContentProviderOperation.newDelete(ContactsContract.Data.CONTENT_URI)
    .withSelection(ContactsContract.Data._ID + "=?", new String[]{String.valueOf(d)})
    .build());

context.getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);

向通讯录中添加新的联系人

ArrayList<ContentProviderOperation> ops = new ArrayList<>();
ops.add(ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
    .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, null)  // 此处传入null添加一个raw_contact空数据
    .build());
ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
    .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)  // RAW_CONTACT_ID是第一个事务添加得到的，因此这里传入0，applyBatch返回的ContentProviderResult[]数组中第一项
    .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE)
    .withValue(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, userName)
    .build());
ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
    .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
    .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)
    .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, phoneNumber)
    .withValue(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_WORK)
    .build());

context.getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);

其中withValueBackReference接口传参代表此键值是事务中之前操作得到的结果，因此需要传入之前事务的index值。由于添加联系人是在第一步操作，对应结果数组的第0项。

向已有联系人中添加新数据

ArrayList<ContentProviderOperation> ops = new ArrayList<>();
ops.add(ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
    .withValue(ContactsContract.Data.RAW_CONTACT_ID, rawContactsId)  // 这里关键是传入正确的raw_contacts_id值
    .withValue(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)
    .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, phoneNumber)
    .withValue(ContactsContract.CommonDataKinds.Phone.TYPE, ContactsContract.CommonDataKinds.Phone.TYPE_WORK)
    .build());

context.getContentResolver().applyBatch(ContactsContract.AUTHORITY, ops);

参考文档

通讯录Android官方文档，常用数据库表及相应含义
PhoneLookup.CONTENT_FILTER_URI returns twice the same contact
What are the semantics of withValueBackReference?