一、 联系人数据库
联系人的数据库文件的位置
/data/data/com.android.providers.contacts/databases.contacts2.db
数据库中重要的几张表
1、contacts表
该表保存了所有的手机测联系人,每个联系人占一行,该表保存了联系人的
ContactID、联系次数、最后一次联系的时间、是否含有号码、是否被添加
到收藏夹等信息。
2、raw_contacts表
该表保存了所有创建过的手机测联系人,每个联系人占一行,表里有一列标
识该联系人是否被删除,该表保存了两个ID:RawContactID和ContactID,
从而将contacts表和raw_contacts表联系起来。该表保存了联系人的
RawContactID、ContactID、联系次数、最后一次联系的时间、是否被添
加到收藏夹、显示的名字、用于排序的汉语拼音等信息。
3、 mimetypes
该表定义了所有的MimeTypeID,即联系人的各个字段的唯一标志。
4、data表
该表保存了所有创建过的手机测联系人的所有信息,每个字段占一行 ,该表
保存了两个ID:MimeTypeID和RawContactID,从而将data表和
raw_contacts表联系起来。
联系人的所有信息保存在列data1至data15中,各列中保存的内容根据
MimeTypeID的不同而不同。如保存号码(MimeTypeID=5)的那行数据中,
data1列保存号码,data2列保存号码类型(手机号码/家庭号码/工作号码等)。
二、对联系人的基本操作
这里的基本操作只是针对手机测的联系人,(U)SIM侧的联系人的操
作后续介绍。
如果对联系人的基本操作,我们必须得到许可。
方法就是在AndroidManifest.xml文件中配置如下权限:
/>
/>读取联系人分为以下步骤:
1、先读取contacts表,获取ContactsID;
2、再在raw_contacts表中根据ContactsID获取RawContactsID;
3、然后就可以在data表中根据RawContactsID获取该联系人的各数据了。
// 获取用来操作数据的类的对象,对联系人的基本操作都是使用这个对象
ContentResolver cr=getContentResolver();
// 查询contacts表的所有记录
Cursor cur=cr.query(ContactsContract.Contacts.CONTENT_URI, null, null,
null, null);
// 如果记录不为空
if (cur.getCount() >0)
{
// 游标初始指向查询结果的第一条记录的上方,执行moveToNext函数会判断
// 下一条记录是否存在,如果存在,指向下一条记录。否则,返回false。
while (cur.moveToNext())
{
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));
}
rawContactsIdCur.close();
// 读取号码
If (Integer.parseInt(cur.getString(cur.getColumnIndex(ContactsContract.
Contacts.HAS_PHONE_NUMBER))) >0)
{
// 根据查询RAW_CONTACT_ID查询该联系人的号码
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)
// 一个联系人可能有多个号码,需要遍历
while (PhoneCur.moveToNext())
{
// 号获取码
String number=
PhoneCur.getString(PhoneCur.getColumnIndex(
ContactsContract.CommonDataKinds.Phone.NUMBER));
// 获取号码类型
String numberType=
PhoneCur.getString(PhoneCur.getColumnIndex(
ContactsContract.CommonDataKinds.Phone.TYPE));
}
PhoneCur.close();
新建联系人新建联系人时, 根据contacts、raw_ contacts两张表中ID的使用情况,自动
生成ContactID和RawContactID。
Android源码新建重复姓名的联系人的ContactID是不重复的,所以会重复显
示。
用下面的代码新建联系人,如果多次新建的联系人的姓名是一样的,生成的
ContactID也会重复,RawContactID不会重复,我们在读取联系人的时候可
以获取所有同姓名联系人的号码等信息,在显示联系人的时候,重复姓名的
联系人的所有字段信息都会合并起来显示为一个联系人。
ContentValuesvalues=newContentValues();
Uri rawContactUri=
getContentResolver().insert(RawContacts.CONTENT_URI, values);
long rawContactId=ContentUris.parseId(rawContactUri);二、对联系人的基本操作(8)
// 向data表插入姓名数据
if (name != "")
{
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE,
StructuredName.CONTENT_ITEM_TYPE);
values.put(StructuredName.GIVEN_NAME, name);
getContentResolver().insert(ContactsContract.Data.CONTENT_URI,
values);
}
// 向data表插入电话数据
if (phoneNum != "")
{
values.clear();
values.put(Data.RAW_CONTACT_ID, rawContactId);
values.put(Data.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
values.put(Phone.NUMBER, phoneNum);
values.put(Phone.TYPE, Phone.TYPE_MOBILE);
getContentResolver().insert(ContactsContract.Data.CONTENT_URI,
values);
}
删除联系人Android帮助文档:When a raw contact is deleted, all of its Data rows as
well as StatusUpdates, AggregationExceptions, PhoneLookup rows are
deleted automatically.
所以,要删除联系人,我们只需要将raw_contacts表中指定RawContactID的
行删除,其他表中与之关联的数据都会自动删除。
public void delete(long rawContactId)
{
getContentResolver().delete(ContentUris.withAppendedId(RawContac
ts.CONTENT_URI, rawContactId), null, null);
}
更新联系人联系人的所有信息都是保存在data表中,所以要更新联系人,我们只需要根
据RawContactID和MIMETYPE修改data表中的内容。
ContentValuesvalues=newContentValues();
values.put(Phone.NUMBER, “123");
values.put(Phone.TYPE, Phone.TYPE_MOBILE);
String Where=ContactsContract.Data.RAW_CONTACT_ID + " = ? AND
" + ContactsContract.Data.MIMETYPE + " = ?";
String[] WhereParams=newString[]{"5", Phone.CONTENT_ITEM_TYPE};
getContentResolver().update(ContactsContract.Data.CONTENT_URI,
values, Where, WhereParams);