博客

Android中的联系人存储是通过

ContentProvider

实现的。因此APP对系统通讯录进行操作涉及到ContentProvider接口的使用。

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

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

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

表中定义。例如：

在编写代码时，实际传入的是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?