通过ContentResolver调用系统URI实现的通讯录示例

Android的四大组件之一，ContentProvider，分为两个部分：一是数据组织工具ContentProvider，一是数据调用工具ContentResolver。对于系统已经提供的URI，如通讯录、多媒体、短信等，通常可以不需要再建立额外的数据库，再用ContentProvider进行组织，而是可以直接用ContentResolver调用这些URI，对系统数据库进行增删改查等操作，从而保证整个Android设备中数据的统一。

 

下面这个链接是本人前段时间为了参加MM论坛的一个小比赛所做的通讯录小demo的源码。因为最近工作和生活的一些原因，把比赛的截止日期给耽误了，所以到最后也没做美工。

http://download.csdn.net/detail/sadfishsc/4182452

 

对通讯录URI的分析主要参考的是雨松MOMO的博文：

http://blog.csdn.net/xys289187120/article/details/6730957

 

如下是对通讯录表进行添加和删除的处理类ContactHandler：

import android.content.ContentResolver;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.Context;
import android.provider.ContactsContract.Data;
import android.provider.ContactsContract.RawContacts;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.provider.ContactsContract.CommonDataKinds.StructuredName;

public class ContactHandler {
	private Context context;
	
	public ContactHandler(Context context) {
		this.context = context;
	}
	
	public void create(ContactItem item) {
		ContentResolver resolver = context.getContentResolver();
		ContentValues values = new ContentValues();
		
		long rawContactId = ContentUris.parseId(resolver.insert(RawContacts.CONTENT_URI, values));
		
		values.clear();
		values.put(Data.RAW_CONTACT_ID, rawContactId);
		values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);
		values.put(StructuredName.DISPLAY_NAME, item.getValue(ContactItem.TYPE_NAME));
		resolver.insert(Data.CONTENT_URI, values);
		
		values.clear();
		values.put(Data.RAW_CONTACT_ID, rawContactId);
		values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
		values.put(Phone.NUMBER, item.getValue(ContactItem.TYPE_PHONE));
		values.put(Phone.TYPE, Phone.TYPE_MOBILE);
		resolver.insert(Data.CONTENT_URI, values);
	}
	
	public void delete(ContactItem item) {
		ContentResolver resolver = context.getContentResolver();
		
		String[] args = {item.getValue(ContactItem.TYPE_CONTACT_ID)};
		
		resolver.delete(RawContacts.CONTENT_URI, Data.CONTACT_ID + "=?", args);
		resolver.delete(Data.CONTENT_URI, Data.RAW_CONTACT_ID + "=?", args);
	}
}

如下是一次性获取通讯录列表信息的类ContractGenerator：

import java.io.InputStream;
import java.util.ArrayList;
import java.util.List;

import android.content.ContentResolver;
import android.content.ContentUris;
import android.content.Context;
import android.database.Cursor;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.net.Uri;
import android.provider.ContactsContract.Contacts;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.provider.ContactsContract.CommonDataKinds.Photo;

public class ContactGenerator {
	private Context context;
	
	private static final String[] PROJECTECTION = {
		Phone.DISPLAY_NAME,
		Phone.NUMBER,
		Photo.PHOTO_ID,
		Phone.CONTACT_ID,
	};
	private static final int DISPLAY_NAME_INDEX = 0;
	private static final int PHONE_NUMBER_INDEX = 1;
	private static final int PHOTO_ID_INDEX = 2;
	private static final int CONTACT_ID_INDEX = 3;
	
	public ContactGenerator(Context context) {
		this.context = context;
	}
	
	public List<ContactItem> generateList() {
		List<ContactItem> list = new ArrayList<ContactItem>();
		
		ContentResolver resolver = context.getContentResolver();
		Cursor cursor = resolver.query(Phone.CONTENT_URI, PROJECTECTION, null, null,  PROJECTECTION[DISPLAY_NAME_INDEX] + " ASC");
		while (cursor.moveToNext()) {
			String name = cursor.getString(DISPLAY_NAME_INDEX);
			String phone = cursor.getString(PHONE_NUMBER_INDEX);
			long photoId = cursor.getLong(PHOTO_ID_INDEX);
			long contactId = cursor.getLong(CONTACT_ID_INDEX);
			
			Bitmap head = null;
			if (photoId > 0) {
				Uri uri = ContentUris.withAppendedId(Contacts.CONTENT_URI, contactId);
				InputStream input = Contacts.openContactPhotoInputStream(resolver, uri);
				head = BitmapFactory.decodeStream(input);
			}
			
			ContactItem item = new ContactItem(context, name, phone, head);
			item.setContactId(contactId);
			list.add(item);
		}
		
		return list;
	}
}

对系统通讯录数据库进行操作，需要在AndroidManifest.xml文件中添加如下两个用户权限：

<uses-permission android:name="android.permission.READ_CONTACTS"></uses-permission>
<uses-permission android:name="android.permission.WRITE_CONTACTS"></uses-permission>

对于ContentResolver的使用，主要是如下几个步骤：

1.      通过Context的getContentResolver()方法获取ContentResolver实例；

2.      调用ContentResolver的insert、delete、update、query方法对数据表进行增删改查操作，对数据表的指定是通过系统URI来完成，这些URI会作为参数传入上述4个方法中。详情参见Android API文档。

 

另外，如下的博文分享了包括通讯录、多媒体、短信在内的系统URI：

http://blog.csdn.net/lyx2007825/article/details/7280043

 

就本文中的示例而言，Java源码文件如下图：

除了前述两个对ContentResolver的操作外，本通讯录的UI控件主要基于二级列表ExpandableListView，所以有继承自BaseExpandableListAdapter的二级列表数据处理适配器类ContactAdapter。另外，ContactItem是数据实体类。其余两个Activity类的界面类。

 

最后需要说明的是，对于系统已经提供了URI的数据资源，没有必要再用ContentProvider对其进行封装管理，因而本示例中并没有用到ContentProvider，只用到ContentResolver。