Android手机通讯录解析
相关图片上传麻烦，原文件到我的博客上传的文件里下载。
1、通讯录应用介绍
通讯录应用是Android自带的应用程序，我们看到此应用的时候，可能只认为这是一个应用，用数据库存储数据，但是实际上不是这样的。
通讯录是ContentProvider的应用，通讯录由两部分组成：
(1)com.android.providers.contacts的ContentProvider：真正存储数据的ContentProvider
(2)com.android.contacts：运用ContentResolver获取数据的图形用户界面；
2、通讯录数据库目录结构
（1）、通讯录数据库目录结构的获取
打开Eclipse软件，调出虚拟机。如果已经创建过虚拟机，则只需要运行程序，如下图
如果没有创建就需要再去创建一个虚拟机。
调出虚拟机效果如下：
接下来就要：
通讯录是存放在/data/data/com.android.providers.contacts/databases/contacts2.db里的
接下来就是导出联系人的数据库：
导出后得到这样的数据库：
这个是QLite Database Browser 工具
打开它把contacts2.db数据库拖进去就可以了。
得到如下：
查看数据库表中数据：
到此如何获取手机数据到此结束，前期工作完成。
3、通讯录数据库结构介绍
这是手机通讯录直接相关联的几张表，圈出来的比较重要。
（1） mimetype表
（2） contacts表
此处的name_raw_contact_id为raw_contacts表的主键
（3） raw_contacts表
此处_id为raw_contacts表的主键，version翻译后叫版本号,一般一个联系人创建后版本号就从2开始，当这个联系人每做一次操作后version都增加，一般是增加1，但有时不确定反正他会增加。对于Android手机而言，它本身自带了一个通讯录，他对与联系人的删除操作就用户而言是删除了，因为在用户界面没有了该来联系人了。但是事实上Android并没有真正删除它。仅仅是在raw_contacts表中把deleted字段标记为了1，意思是说“1”代表删除了，“0”代表联系人没删除，是存在的。contact_id来自contacts表的主键。这样contacts和raw_contacts联系在一起了。
（4） data表
data表中的mimetype_id来自mimetype表，raw_contact_id来自raw_contacts表。一般来说data1到data15的字段都是存放数据的。
其中mimetype_id=5代表电话号码mimetype_id=7代表姓名。当mimetype_id=5时data1存放电话号码，data2存放电话号码的类型，data2=2,代表电话号码为手机号。
2、3、手机通讯录的操作介绍
（1）新增 这里介绍了两种方法
/**
* 将一组联系人添加到手机通讯录中
*
* @param Contacts
* @param context
*/
public static void AddContact(ContactInfo[] Contacts, Context context) {
for (int i = 0; i < Contacts.length; i++) {
ContentValues values = new ContentValues();
// 下面的操作会根据RawContacts表中已有的rawContactId使用情况自动生成新联系人的rawContactId
Uri rawContactUri = context.getContentResolver().insert(
RawContacts.CONTENT_URI, values);
long rawContactId = ContentUris.parseId(rawContactUri);
// 向data表插入姓名数据
if (Contacts[i].Name != "") {
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);
values.put(StructuredName.GIVEN_NAME, Contacts[i].Name);
context.getContentResolver().insert(
ContactsContract.Data.CONTENT_URI, values);
}
// 向data表插入电话数据
if (Contacts[i].Num != "") {
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
values.put(Phone.NUMBER, Contacts[i].Num);
values.put(Phone.TYPE, Phone.TYPE_MOBILE);
context.getContentResolver().insert(
ContactsContract.Data.CONTENT_URI, values);
}
}
}
/**
* 将单个联系人添加到通讯录中
*
* @param Contact
* @param context
*/
public static void AddContact(ContactInfo Contact, Context context) {
ContentValues values = new ContentValues();
// 下面的操作会根据RawContacts表中已有的rawContactId使用情况自动生成新联系人的rawContactId
Uri rawContactUri = context.getContentResolver().insert(
RawContacts.CONTENT_URI, values);
long rawContactId = ContentUris.parseId(rawContactUri);
// 向data表插入姓名数据
if (Contact.Name != "") {
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, StructuredName.CONTENT_ITEM_TYPE);
values.put(StructuredName.GIVEN_NAME, Contact.Name);
context.getContentResolver().insert(
ContactsContract.Data.CONTENT_URI, values);
}
// 向data表插入电话数据
if (Contact.Num != "") {
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
values.put(Phone.NUMBER, Contact.Num);
values.put(Phone.TYPE, Phone.TYPE_MOBILE);
context.getContentResolver().insert(
ContactsContract.Data.CONTENT_URI, values);
}
}
public static void testAddContacts(ContactInfo[] Contacts, Context context){
for (int i = 0; i < Contacts.length; i++) {
//插入raw_contacts表，并获取_id属性
Uri uri = Uri.parse("content://com.android.contacts/raw_contacts"); //获取操作的表的路径
ContentResolver resolver = context.getContentResolver(); //类似.NET中的上下文对象或数据库操作
ContentValues values = new ContentValues(); //定义一个联系人操作变量
long contact_id = ContentUris.parseId(resolver.insert(uri, values));
//插入data表
uri = Uri.parse("content://com.android.contacts/data");
//add Name
values.put("raw_contact_id", contact_id);
values.put(Data.MIMETYPE,"vnd.android.cursor.item/name");
values.put("data2", Contacts[i].Name);
values.put("data1", Contacts[i].Name);
resolver.insert(uri, values);
values.clear();
//add Phone
values.put("raw_contact_id", contact_id);
values.put(Data.MIMETYPE,"vnd.android.cursor.item/phone_v2");
values.put("data2", "2"); //手机
values.put("data1", Contacts[i].Num);
resolver.insert(uri, values);
values.clear();
}
}
public static void testAddContacts(ContactInfo Contact, Context context){
//插入raw_contacts表，并获取_id属性
Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
ContentResolver resolver = context.getContentResolver();
ContentValues values = new ContentValues();
long contact_id = ContentUris.parseId(resolver.insert(uri, values));
//插入data表
uri = Uri.parse("content://com.android.contacts/data");
//add Name
values.put("raw_contact_id", contact_id);
values.put(Data.MIMETYPE,"vnd.android.cursor.item/name");
values.put("data2", Contact.Name);
values.put("data1", Contact.Name);
resolver.insert(uri, values);
values.clear();
//add Phone
values.put("raw_contact_id", contact_id);
values.put(Data.MIMETYPE,"vnd.android.cursor.item/phone_v2");
values.put("data2", "2"); //手机
values.put("data1", Contact.Num);
resolver.insert(uri, values);
values.clear();
/** //add email
values.put("raw_contact_id", contact_id);
values.put(Data.MIMETYPE,"vnd.android.cursor.item/email_v2");
values.put("data2", "2"); //单位
values.put("data1", "www.2cto.com");
resolver.insert(uri, values); */
}
（2）修改 此处也介绍两种方法针对ID的来源
/**
* 更新联系人
*
* @param context
* 上下文对象
* @param name
* 联系人姓名
* @param number
* 手机号
* @param ContactId
* ID（此ID是由通讯录数据库自动生成的,并且该ID为contacts表中的主键）
*/
public static void testUpdate(Context context, String name,
String number, String ContactId){
String version="0";
String rawContactsId ="";
ContentResolver cr = context.getContentResolver();
//依contacts表中的主键查找raw_contacts表中的ID即主键
Cursor rawContactsIdCur = cr.query(RawContacts.CONTENT_URI,
null, RawContacts.CONTACT_ID + " = ?",
new String[] { ContactId }, null);
if (rawContactsIdCur.moveToFirst()) {
version = rawContactsIdCur.getString(rawContactsIdCur
.getColumnIndex(RawContacts.VERSION));
//获得raw_contacts表中的主键
rawContactsId = rawContactsIdCur.getString(rawContactsIdCur
.getColumnIndex(RawContacts._ID));
}
ContentResolver resolver = context.getContentResolver();
ContentValues values = new ContentValues();
Uri uri = Uri.parse("content://com.android.contacts/data");//对data表的所有数据操作
resolver = context.getContentResolver();
values.clear();
values = new ContentValues();
values.put("data1", number);
//依raw_contacts表中的ID对data表做相应的修改
resolver.update(uri, values, "mimetype=? and raw_contact_id=?", new String[]{"vnd.android.cursor.item/phone_v2",rawContactsId}) ;
values.clear();
values.put("data2", name);
values.put("data1", name);
resolver.update(uri, values, "mimetype=? and raw_contact_id=?", new String[]{"vnd.android.cursor.item/name",rawContactsId}) ;
rawContactsIdCur.close();
}
/**
* 更新联系人
*
* @param context
* 上下文对象
* @param name
* 联系人姓名
* @param number
* 手机号
* @param ContactId
* ID（此ID是由通讯录数据库自动生成的,并且该ID为raw_contacts表中的主键）
*/
public static void updateContact(Context context, String name,
String number, String ContactId)
{
ContentValues values = new ContentValues();
// 更新姓名
values.clear();
values.put(StructuredName.GIVEN_NAME, name);
context.getContentResolver().update(ContactsContract.Data.CONTENT_URI,
values,
Data.RAW_CONTACT_ID + "=? and " + Data.MIMETYPE + "=?",
new String[] { ContactId, StructuredName.CONTENT_ITEM_TYPE });
// 更新电话
values.clear();
values.put(ContactsContract.CommonDataKinds.Phone.NUMBER, number);
context.getContentResolver().update(ContactsContract.Data.CONTENT_URI,
values,
Data.RAW_CONTACT_ID + "=? and " + Data.MIMETYPE + "=?",
new String[] { ContactId, Phone.CONTENT_ITEM_TYPE });
}
（3）删除
这里是彻底删除，把data,contacts,raw_contacts 表中的数据以并删除，而Android自带的手机通讯录删除操作不是真正意义上的删除，仅仅是将raw_contacts表中的deleted字段改为了“1”。
/**
* 删除联系人
*
* @param context
* 上下文对象
* @param ContactId
* 联系人ID
* ID（此ID是请求数据传递过来的,并且该ID为raw_contacts表中的主键）
*/
public static void DeleteContact(Context context, String ContactId)
{
Uri uri = Uri.parse("content://com.android.contacts/raw_contacts");
ContentResolver resolver = context.getContentResolver();
Cursor cursor = resolver.query(uri, new String[]{RawContacts._ID},"contact_id=?", new String[]{ContactId}, null);
if(cursor.moveToFirst()){
int id = cursor.getInt(0);
//根据id删除data中的相应数据
resolver.delete(uri, "_id=?", new String[]{id+""});
uri = Uri.parse("content://com.android.contacts/data");
resolver.delete(uri, "raw_contact_id=?", new String[]{id+""});
}
}
（4）读取联系人
/**
* 获取联系人
*
* @return list数组，包含手机通讯录中的联系人
*/
private List<Map<String, Object>> getContacts() {
List<Map<String, Object>> list = new ArrayList<Map<String, Object>>();
// 获取用来操作数据的类的对象，对联系人的基本操作都是使用这个对象
ContentResolver cr = getContentResolver();
// 查询contacts表的所有记录
Cursor cur = cr.query(ContactsContract.Contacts.CONTENT_URI, null,
null, null, null);
String deleted = "1";
String version = "0";
// 如果记录不为空
if (cur.getCount() > 0) {
// 游标初始指向查询结果的第一条记录的上方，执行moveToNext函数会判断
// 下一条记录是否存在，如果存在，指向下一条记录。否则，返回false。
while (cur.moveToNext()) {
// 取得联系人的ID索引值
String contactId = cur.getString(cur
.getColumnIndex(ContactsContract.Contacts._ID));
if(contactId==null)
{
contactId="No Id";
}
// 取得联系人的名字索引
int nameIndex = cur.getColumnIndex(PhoneLookup.DISPLAY_NAME);
String name = cur.getString(nameIndex);
if(name==null)
{
name="No name";
}
String rawContactsId = "";
String id = cur.getString(cur
.getColumnIndex(ContactsContract.Contacts._ID));
// str += "ID:" + id + "\n";二、对联系人的基本操作(4)
// 读取rawContactsId
Cursor rawContactsIdCur = cr.query(RawContacts.CONTENT_URI,
null, RawContacts.CONTACT_ID + " = ?",
new String[] { id }, null);
// 该查询结果一般只返回一条记录，所以我们直接让游标指向第一条记录
if (rawContactsIdCur.moveToFirst()) {
// 读取第一条记录的RawContacts._ID列的值
rawContactsId = rawContactsIdCur.getString(rawContactsIdCur
.getColumnIndex(RawContacts._ID));
deleted = rawContactsIdCur.getString(rawContactsIdCur
.getColumnIndex(RawContacts.DELETED));
version = rawContactsIdCur.getString(rawContactsIdCur
.getColumnIndex(RawContacts.VERSION));
}
rawContactsIdCur.close();
// 读取号码
Cursor PhoneCur = cr.query(
ContactsContract.CommonDataKinds.Phone.CONTENT_URI,
null,
ContactsContract.CommonDataKinds.Phone.RAW_CONTACT_ID
+ " =?", new String[] { rawContactsId }, null);
// 上面的ContactsContract.CommonDataKinds.Phone.CONTENT_URI
// 可以用下面的phoneUri代替
// Uri
// phoneUri=Uri.parse("content://com.android.contacts/data/phones");
// 二、对联系人的基本操作(6)
// 一个联系人可能有多个号码，需要遍历
if(!PhoneCur.moveToNext())
{
//获取电话号码为空的情况即游标未找到的情况
String number="No number";
// // 获取号码类型
Map<String, Object> map = new HashMap<String, Object>();
map.put("phone", number + ",");
map.put("name", name + "|");
map.put("version", version + ",");
map.put("deleted", deleted + ",");
map.put("id", contactId + ",");
list.add(map);
}
else
{
// 号获取码
String number = PhoneCur
.getString(PhoneCur
.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
// // 获取号码类型
Map<String, Object> map = new HashMap<String, Object>();
map.put("phone", number + ",");
map.put("name", name + "|");
map.put("version", version + ",");
map.put("deleted", deleted + ",");
map.put("id", contactId + ",");
list.add(map);
}
while (PhoneCur.moveToNext()) {
// 号获取码
String number = PhoneCur
.getString(PhoneCur
.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
if(number==null)
{
number="No number";
}
// // 获取号码类型
Map<String, Object> map = new HashMap<String, Object>();
map.put("phone", number + ",");
map.put("name", name + "|");
map.put("version", version + ",");
map.put("deleted", deleted + ",");
map.put("id", contactId + ",");
list.add(map);
}
PhoneCur.close();//关闭游标
}
}
return list;
}
}
