java增删改查 通讯录,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值

ArrayListops = 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);

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

ArrayListops = 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项。

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

ArrayListops = 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?