在安卓开发过程中时常会碰到获取手机联系人的需求,今天就来总结一下如何获得手机联系人以及这么做的原因。说到获取手机联系人就不得不提一下ContentProvider,安卓通过ContentProvider在不同的应用间共享数据,手机联系人数据就是通过这种方式对用户暴露的。下面开始讲解获取手机联系人的步骤,如果有误欢迎大神指导,拍砖。
一 添加权限
在安卓6.0及以上的系统,需要在Manifest.xml文件中添加如下权限:
<uses-permission android:name="android.permission.READ_CONTACTS"/>
二 查看手机联系人数据库表结构
下面看一张图,安卓系统联系人数据库表
该数据库是在data->data目录下如下图所在的位置导出的,能导出此数据库前提是您的手机已经root或者直接使用模拟器
我们主要关注以上 红框 中的四张表,下面就来说说这四张表:
- contacts表:是当前手机中显示的所有的联系人,通过contact_id与其它表相关联。
- raw_contacts表:用户创建过的所有的联系人,包括已经删除的联系人(deleted字段标识该条联系人是否被删除),该表与contacts表差不多,不再放图。
- mimetype表:定义了手机联系人信息不同的类型
- data表:包含了手机联系人的信息,例如:手机号、姓名、邮箱、地址等。通过contact_id或者raw_contact_id查询对应联系人的信息
三 通过代码获取手机联系人
首先说明一点在我测试的过程中通过ContentResolver查询联系人数据库,实际上查询的是对应的视图,视图可以理解为通过一个或者多个基本表(或视图)导出的表。当您把数据库导出来之后可以很清楚的看到各个视图,如图所示
我们查询的列名比如:display_name就是根据视图的列名填写的,有时候表中的列名和视图中的列名不太一样,举个栗子:我们data表中有mimetype_id而在data视图中就是mimetype,因为我们查询的是视图,所以我们需要查询的列名就是mimetype
下面看代码
private void getLinkman() {
ContentResolver contentResolver = getContentResolver();
//contacts视图的uri
Uri contacts_uri = Uri.parse("content://com.android.contacts/contacts");
//data视图的uri
Uri data_uri = Uri.parse("content://com.android.contacts/data");
//先查询contacts视图,获得contact_id
Cursor contactCursor = contentResolver.query(contacts_uri,
new String[]{"_id","display_name"}, null, null, null);
//循环遍历contactCursor
if (contactCursor != null && contactCursor.getCount() > 0){
StringBuilder sb = new StringBuilder();
while (contactCursor.moveToNext()){
sb.append("\n\n");
String rawContactId = contactCursor.getString(0);
String displayName = contactCursor.getString(1);
Log.e(getClass().getSimpleName(),displayName);
//根据获得的contact_id去查询data视图获得联系人信息
Cursor dataCursor = contentResolver.query(data_uri, new String[]{"mimetype","data1"},
"contact_id = ?", new String[]{rawContactId}, null);
if (dataCursor != null && dataCursor.getCount() > 0){
while (dataCursor.moveToNext()){
//我们只演示获得手机号,邮箱和姓名
String mimeType = dataCursor.getString(0);
String data = dataCursor.getString(1);
//根据mimetype表中的类型判断用户信息类型
if ("vnd.android.cursor.item/phone_v2".equals(mimeType)){
//手机号
sb.append("手机号:"+data+",");
}else if ("vnd.android.cursor.item/email_v2".equals(mimeType)){
//邮箱
sb.append("邮箱:"+data+",");
}else if ("vnd.android.cursor.item/name".equals(mimeType)){
//姓名
sb.append("姓名:"+data);
}
}
}
dataCursor.close();
}
contactCursor.close();
tv_linkman.setText(sb.toString());
}
}
代码中都有注释应该很容易理解,其实获得手机联系人最重要的是要明白联系人数据库中各个表包含的数据以及它们之间的联系。最后一定要记得我们通过ContentResolver查询的是视图,需要查询的列名一定要根据视图中的填写,否则会报错误提示java.lang.IllegalArgumentException: Invalid column xxx