Android开发之联系人操作

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, "liming@itcast.cn");

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, "liming@itcast.cn")

        .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一个典型的应用了！