Android软件开发之获取通讯录联系人信息

总结的最好的一篇文章是：
http://blog.youkuaiyun.com/xys289187120/article/details/6730957

但要纠错下：
Contacts表中没有display_name字段，后者应该是在raw_contacts表中的

-----------------------------------------------------------------------------------------------------------------------------
由于OSCHINA的文章注明了：“未经作者同意不得转载。”，所以只贴出原文地址：

原文地址：http://my.oschina.net/huangsm/blog/56252

-----------------------------------------------------------------------------------------------------------------------------
另外一篇操作Contacts的文章地址在：http://blog.youkuaiyun.com/yao_guet/article/details/6626001 

-----------------------------------------------------------------------------------------------------------------------------
（自己增加注释版 ：）

图中选中的数据库 contacts2.db就是系统储存联系人的数据库，我们将它打开看看里面储存了些什么东东？ 如果对数据库不太清楚的请查看我的博文Android游戏开发之数据库SQLite 详细介绍（十七）

       

（snwrking: DB的路径是 ：/data/data/com.android.providers.contacts/databases/contacts2.db）

打开contacts.db后 发面里面有一堆表，同学们先别慌张。今天我们主要讨论红框内的4个比较常用的表，后期我在介绍其它表的使用。这里说一下如果你想在真机上查看数据库的话必需要先获得root权限，否则无法查看。（snwrking : 我就是在模拟器上用的。模拟器上直接就有ROOT权限，可以打开data/data目录。 至于真机上，请用SuperOneClick）

1.contacts 表

_id ：表的ID，主要用于其它表通过contacts 表中的ID可以查到相应的数据。
display_name:  联系人名称
photo_id:头像的ID，如果没有设置联系人头像，这个字段就为空
times_contacted:通话记录的次数
last_time_contacted: 最后的通话时间 
lookup :是一个持久化的储存 因为用户可能会改名子 但是它改不了lookup

(snwrking : 我在模拟器上的DB上，contacts表中没有display_name字段，这个字段反而是在raw_contacts里。不知道是不是版本的问题。我的模拟器版本是 Android2.3.3)

2.data表

raw_contact_id：通过raw_contact_id可以找到 raw_contact表中相对的数据。

data1 到 data15  这里保存着联系人的信息 联系人名称 联系人电话号码  电子邮件  备注 等等。

   

3.phone_look_up表

data_id  : 通过data_id可以找到 datat表中相对的数据。
raw_contact_id : 通过raw_contact_id 可以找到 raw_contact_表中相对的数据。
normalized_number: 这个字段就比较有意思了，它是将每个电话号码逆序排列。

4.raw_contact表

version :版本号，用于监听变化
deleted :删除标志， 0为默认 1 表示这行数据已经删除
display_name : 联系人名称
last_time_contacts : 最后联系的时间

有关这些的源码都在android.provider.ContactsContract这个类里面，如果想深入了解的话 可以去看看，数据库相关的操作 联查啊 啥的  都在里面。

下面说说代码是怎么用的

         先说说 Phone.CONTENT_URI，获取联系人的时候需要去这个url中去找数据 。它所指向的其实是“content:// com.Android.contacts/data/phones”。这个url 对应着contacts表 和   raw_contacts表 以及 data表 所以说我们的数据都是从这三个表中获取的。

这里强调一下query第二个参数 

[java]  view plain copy

1. private static final String[] PHONES_PROJECTION = new String[] {  
2.        Phone.DISPLAY_NAME, Phone.NUMBER, Photo.PHOTO_ID,Phone.CONTACT_ID };  

它的意思是只去表中找 显示名称  电话号码 头像ID  联系人ID 这4个数据 ，如果你须要其它数据 的话 就须要修改这里。


获得手机通讯录联系人信息

[java]  view plain copy

1.    /**得到手机通讯录联系人信息**/  
2.    private void getPhoneContacts() {  
3. ContentResolver resolver = mContext.getContentResolver();  
4.   
5. // 获取手机联系人  
6. Cursor phoneCursor = resolver.query(Phone.CONTENT_URI,PHONES_PROJECTION, null, null, null);  
7.   
8.   
9. if (phoneCursor != null) {  
10.     while (phoneCursor.moveToNext()) {  
11.   
12.     //得到手机号码  
13.     String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);  
14.     //当手机号码为空的或者为空字段 跳过当前循环  
15.     if (TextUtils.isEmpty(phoneNumber))  
16.         continue;  
17.       
18.     //得到联系人名称  
19.     String contactName = phoneCursor.getString(PHONES_DISPLAY_NAME_INDEX);  
20.       
21.     //得到联系人ID  
22.     Long contactid = phoneCursor.getLong(PHONES_CONTACT_ID_INDEX);  
23.   
24.     //得到联系人头像ID  
25.     Long photoid = phoneCursor.getLong(PHONES_PHOTO_ID_INDEX);  
26.       
27.     //得到联系人头像Bitamp  
28.     Bitmap contactPhoto = null;  
29.   
30.     //photoid 大于0 表示联系人有头像 如果没有给此人设置头像则给他一个默认的  
31.     if(photoid > 0 ) {  
32.         Uri uri =ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI,contactid);  
33.         InputStream input = ContactsContract.Contacts.openContactPhotoInputStream(resolver, uri);  
34.         contactPhoto = BitmapFactory.decodeStream(input);  
35.     }else {  
36.         contactPhoto = BitmapFactory.decodeResource(getResources(), R.drawable.contact_photo);  
37.     }  
38.       
39.     mContactsName.add(contactName);  
40.     mContactsNumber.add(phoneNumber);  
41.     mContactsPhonto.add(contactPhoto);  
42.     }  
43.   
44.     phoneCursor.close();  
45. }  
46.    }  

获得手机sim卡联系人信息

sim卡和手机本人 获取的方式类似 只是url有点不一样 ，须要注意的一点是 sim卡  是没有联系人头像的。

[java]  view plain copy

1.    /**得到手机SIM卡联系人人信息**/  
2.    private void getSIMContacts() {  
3. ContentResolver resolver = mContext.getContentResolver();  
4. // 获取Sims卡联系人  
5. Uri uri = Uri.parse("content://icc/adn");  
6. Cursor phoneCursor = resolver.query(uri, PHONES_PROJECTION, null, null,  
7.     null);  
8.   
9. if (phoneCursor != null) {  
10.     while (phoneCursor.moveToNext()) {  
11.   
12.     // 得到手机号码  
13.     String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);  
14.     // 当手机号码为空的或者为空字段 跳过当前循环  
15.     if (TextUtils.isEmpty(phoneNumber))  
16.         continue;  
17.     // 得到联系人名称  
18.     String contactName = phoneCursor  
19.         .getString(PHONES_DISPLAY_NAME_INDEX);  
20.   
21.     //Sim卡中没有联系人头像  
22.       
23.     mContactsName.add(contactName);  
24.     mContactsNumber.add(phoneNumber);  
25.     }  
26.   
27.     phoneCursor.close();  
28. }  
29.    }  

这个界面就可以看到联系人的 名称 号码 以及头像了。如果想在模拟器上看须要将图片拷贝到SD卡中，然后在联系人中设置一下，这里就可以看到头像了，或者 真机上会比较清楚、

任意点击一个联系人会调用系统拨打电话的界面 ，代码如下。

[java]  view plain copy

1. //调用系统方法拨打电话  
2. Intent dialIntent = new Intent(Intent.ACTION_CALL, Uri  
3.     .parse("tel:" + mContactsNumber.get(position)));  
4. startActivity(dialIntent);  

最重要的是须要AndroidManifest.xml中 加入权限 否则代码会报错的。 千万别忘了。

[html]  view plain copy

1. <!-- 读取联系人权限 -->   
2. <uses-permission android:name="android.permission.READ_CONTACTS"/>  
3. <!-- 拨打电话权限 -->  
4. <span style="margin: 0px; padding: 0px; border: none;%