Android之联系人操作
这一节将简单讲述一下ConentProvider的应用---获得联系人数据和操作联系人数据,系统软件联系人应用内部其实也是通过几张数据表来实现的，对外提供ContentProvider接口，可以通过
URI对联系人进行操作。
首先我们来学习一下如何取得联系人数据，包括电话号码，邮件，名字等等
第一步
由于联系人属于私密信息，所以开发有关联系人方面的应用必须加入读取联系人的权限
<uses-permission android:name="android.permission.READ_CONTACTS" />
第二步
要操作内容提供者，必须提供一个URI，这个URI就是操作所有联系人的URI，
Uri uri = ContactsContract.Contacts.CONTENT_URI;//就是content://com.android.contacts/contacts
观察以上URI字符串清晰地明白该URI表示操作所有的联系人(contacts)
然后得到操作URI的工具
ContentResolver contentResolver = this.getContext().getContentResolver();
查询所有的联系人，返回一个游标
Cursor cursor = contentResolver.query(uri, null, null, null, null);
然后迭代游标，得到里面的数据
while(cursor.moveToNext()){
StringBuilder sb = new StringBuilder();
String contactId = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts._ID)); //得到联系人的唯一标识ID
String name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));//得到联系人的名字
sb.append("contactId=").append(contactId).append(",name=").append(name);
//下面是根据联系人ID在另外一张表中找到该用户的所有电话，该URI其实是content://com.android.contacts/data/emails
Cursor phones = contentResolver.query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null,
ContactsContract.CommonDataKinds.Phone.CONTACT_ID +" = "+ contactId,
null, null);
while(phones.moveToNext()){//迭代该联系人所有的电话
String phoneNumber = phones.getString(phones.getColumnIndex(
ContactsContract.CommonDataKinds.Phone.NUMBER));
sb.append(",phone=").append(phoneNumber);
}
phones.close();
//下面是根据联系人ID在另外一张表中找到该用户的所有电子邮件,该URI其实是content://com.android.contacts/data/emails
Cursor emails = contentResolver.query(ContactsContract.CommonDataKinds.Email.CONTENT_URI,
null,
ContactsContract.CommonDataKinds.Email.CONTACT_ID + " = " + contactId,
null, null);
while (emails.moveToNext()) {//迭代所有的邮箱
String emailAddress = emails.getString(emails.getColumnIndex(
ContactsContract.CommonDataKinds.Email.DATA));
sb.append(",emailAddress=").append(emailAddress);
}
emails.close();
Log.i(TAG, sb.toString());
}
cursor.close();
}
接着介绍下如何插入联系人的数据
首先当然要加入权限
<uses-permission android:name="android.permission.READ_CONTACTS" />
其实原理和上述获得联系人数据类似，都是通过一个URI，然后对URI进行操作，这里就不一一赘述了
ContentValues values = new ContentValues();
//首先向RawContacts.CONTENT_URI执行一个空值插入，目的是获取系统返回的rawContactId
Uri rawContactUri = this.getContext().getContentResolver().insert(RawContacts.CONTENT_URI, values);
long rawContactId = ContentUris.parseId(rawContactUri);
//往data表入姓名数据
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);//内容类型
values.put(StructuredName.GIVEN_NAME, "李天山");
this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
//往data表入电话数据
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
values.put(Phone.NUMBER, "13921009789");
values.put(Phone.TYPE, Phone.TYPE_MOBILE);
this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
//往data表入Email数据
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE);
values.put(Email.DATA, "[email protected]");
values.put(Email.TYPE, Email.TYPE_WORK);
this.getContext().getContentResolver().insert(android.provider.ContactsContract.Data.CONTENT_URI, values);
Android中还提供了一种方法
//批量添加,处于同一个事务中
public void testSave() throws Throwable{
//文档位置：reference\android\provider\ContactsContract.RawContacts.html
ArrayList<ContentProviderOperation> ops = new ArrayList<ContentProviderOperation>();
int rawContactInsertIndex = ops.size();
ops.add(ContentProviderOperation.newInsert(RawContacts.CONTENT_URI)
.withValue(RawContacts.ACCOUNT_TYPE, null)
.withValue(RawContacts.ACCOUNT_NAME, null)
.build());
//文档位置：reference\android\provider\ContactsContract.Data.html
ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)
.withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
.withValue(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE)
.withValue(StructuredName.GIVEN_NAME, "赵薇")
.build());
ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)
.withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
.withValue(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE)
.withValue(Phone.NUMBER, "13671323809")
.withValue(Phone.TYPE, Phone.TYPE_MOBILE)
.withValue(Phone.LABEL, "手机号")
.build());
ops.add(ContentProviderOperation.newInsert(android.provider.ContactsContract.Data.CONTENT_URI)
.withValueBackReference(Data.RAW_CONTACT_ID, rawContactInsertIndex)
.withValue(Data.MIMETYPE, Email.CONTENT_ITEM_TYPE)
.withValue(Email.DATA, "[email protected]")
.withValue(Email.TYPE, Email.TYPE_WORK)
.build());
ContentProviderResult[] results = this.getContext().getContentResolver()
.applyBatch(ContactsContract.AUTHORITY, ops);
for(ContentProviderResult result : results){
Log.i(TAG, result.uri.toString());
}
}
至此，有关通讯录的操作讲述完毕，这算是ContentProvider一个典型的应用了！