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

 Android手机的通讯录联系人全部都存在系统的数据库中，如果须要获得通讯里联系人的信息就须要访问系统的数据库，才能将信息拿出来。 这一篇文章我主要带领同学们熟悉Android的通讯录机制。

数据库 contacts2.db就是系统储存联系人的数据库，我们将它打开看看里面储存了些什么东东？ 

打开contacts.db后 发面里面有一堆表，同学们先别慌张。今天我们主要讨论红框内的4个比较常用的表，后期我在介绍其它表的使用。这里说一下如果你想在真机上查看数据库的话必需要先获得root权限，否则无法查看。

1.contacts 表

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

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 };  

[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. <uses-permission android:name="android.permission.CALL_PHONE"/>    

下面给出完整的代码

[java]  view plain copy

1. import java.io.InputStream;  
2. import java.util.ArrayList;  
3.   
4. import android.app.ListActivity;  
5. import android.content.ContentResolver;  
6. import android.content.ContentUris;  
7. import android.content.Context;  
8. import android.content.Intent;  
9. import android.database.Cursor;  
10. import android.graphics.Bitmap;  
11. import android.graphics.BitmapFactory;  
12. import android.net.Uri;  
13. import android.os.Bundle;  
14. import android.provider.ContactsContract;  
15. import android.provider.ContactsContract.CommonDataKinds.Phone;  
16. import android.provider.ContactsContract.CommonDataKinds.Photo;  
17. import android.text.TextUtils;  
18. import android.view.LayoutInflater;  
19. import android.view.View;  
20. import android.view.ViewGroup;  
21. import android.widget.AdapterView;  
22. import android.widget.BaseAdapter;  
23. import android.widget.ImageView;  
24. import android.widget.ListView;  
25. import android.widget.TextView;  
26. import android.widget.AdapterView.OnItemClickListener;  
27.   
28. public class ContactsActivity extends ListActivity {  
29.   
30.     Context mContext = null;  
31.   
32.     /**获取库Phon表字段**/  
33.     private static final String[] PHONES_PROJECTION = new String[] {  
34.             Phone.DISPLAY_NAME, Phone.NUMBER, Photo.PHOTO_ID,Phone.CONTACT_ID };  
35.      
36.     /**联系人显示名称**/  
37.     private static final int PHONES_DISPLAY_NAME_INDEX = 0;  
38.       
39.     /**电话号码**/  
40.     private static final int PHONES_NUMBER_INDEX = 1;  
41.       
42.     /**头像ID**/  
43.     private static final int PHONES_PHOTO_ID_INDEX = 2;  
44.      
45.     /**联系人的ID**/  
46.     private static final int PHONES_CONTACT_ID_INDEX = 3;  
47.       
48.   
49.     /**联系人名称**/  
50.     private ArrayList<String> mContactsName = new ArrayList<String>();  
51.       
52.     /**联系人头像**/  
53.     private ArrayList<String> mContactsNumber = new ArrayList<String>();  
54.   
55.     /**联系人头像**/  
56.     private ArrayList<Bitmap> mContactsPhonto = new ArrayList<Bitmap>();  
57.       
58.     ListView mListView = null;  
59.     MyListAdapter myAdapter = null;  
60.   
61.     @Override  
62.     public void onCreate(Bundle savedInstanceState) {  
63.         mContext = this;  
64.         mListView = this.getListView();  
65.         /**得到手机通讯录联系人信息**/  
66.         getPhoneContacts();  
67.   
68.         myAdapter = new MyListAdapter(this);  
69.         setListAdapter(myAdapter);  
70.   
71.   
72.         mListView.setOnItemClickListener(new OnItemClickListener() {  
73.   
74.             @Override  
75.             public void onItemClick(AdapterView<?> adapterView, View view,  
76.                     int position, long id) {  
77.                 //调用系统方法拨打电话  
78.                 Intent dialIntent = new Intent(Intent.ACTION_CALL, Uri  
79.                         .parse("tel:" + mContactsNumber.get(position)));  
80.                 startActivity(dialIntent);  
81.             }  
82.         });  
83.   
84.         super.onCreate(savedInstanceState);  
85.     }  
86.   
87.     /**得到手机通讯录联系人信息**/  
88.     private void getPhoneContacts() {  
89.         ContentResolver resolver = mContext.getContentResolver();  
90.   
91.         // 获取手机联系人  
92.         Cursor phoneCursor = resolver.query(Phone.CONTENT_URI,PHONES_PROJECTION, null, null, null);  
93.   
94.   
95.         if (phoneCursor != null) {  
96.             while (phoneCursor.moveToNext()) {  
97.   
98.                 //得到手机号码  
99.                 String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);  
100.                 //当手机号码为空的或者为空字段 跳过当前循环  
101.                 if (TextUtils.isEmpty(phoneNumber))  
102.                     continue;  
103.                   
104.                 //得到联系人名称  
105.                 String contactName = phoneCursor.getString(PHONES_DISPLAY_NAME_INDEX);  
106.                   
107.                 //得到联系人ID  
108.                 Long contactid = phoneCursor.getLong(PHONES_CONTACT_ID_INDEX);  
109.   
110.                 //得到联系人头像ID  
111.                 Long photoid = phoneCursor.getLong(PHONES_PHOTO_ID_INDEX);  
112.                   
113.                 //得到联系人头像Bitamp  
114.                 Bitmap contactPhoto = null;  
115.   
116.                 //photoid 大于0 表示联系人有头像 如果没有给此人设置头像则给他一个默认的  
117.                 if(photoid > 0 ) {  
118.                     Uri uri =ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI,contactid);  
119.                     InputStream input = ContactsContract.Contacts.openContactPhotoInputStream(resolver, uri);  
120.                     contactPhoto = BitmapFactory.decodeStream(input);  
121.                 }else {  
122.                     contactPhoto = BitmapFactory.decodeResource(getResources(), R.drawable.contact_photo);  
123.                 }  
124.                   
125.                 mContactsName.add(contactName);  
126.                 mContactsNumber.add(phoneNumber);  
127.                 mContactsPhonto.add(contactPhoto);  
128.             }  
129.   
130.             phoneCursor.close();  
131.         }  
132.     }  
133.       
134.     /**得到手机SIM卡联系人人信息**/  
135.     private void getSIMContacts() {  
136.         ContentResolver resolver = mContext.getContentResolver();  
137.         // 获取Sims卡联系人  
138.         Uri uri = Uri.parse("content://icc/adn");  
139.         Cursor phoneCursor = resolver.query(uri, PHONES_PROJECTION, null, null,  
140.                 null);  
141.   
142.         if (phoneCursor != null) {  
143.             while (phoneCursor.moveToNext()) {  
144.   
145.                 // 得到手机号码  
146.                 String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);  
147.                 // 当手机号码为空的或者为空字段 跳过当前循环  
148.                 if (TextUtils.isEmpty(phoneNumber))  
149.                     continue;  
150.                 // 得到联系人名称  
151.                 String contactName = phoneCursor  
152.                         .getString(PHONES_DISPLAY_NAME_INDEX);  
153.   
154.                 //Sim卡中没有联系人头像  
155.                   
156.                 mContactsName.add(contactName);  
157.                 mContactsNumber.add(phoneNumber);  
158.             }  
159.   
160.             phoneCursor.close();  
161.         }  
162.     }  
163.       
164.     class MyListAdapter extends BaseAdapter {  
165.         public MyListAdapter(Context context) {  
166.             mContext = context;  
167.         }  
168.   
169.         public int getCount() {  
170.             //设置绘制数量  
171.             return mContactsName.size();  
172.         }  
173.   
174.         @Override  
175.         public boolean areAllItemsEnabled() {  
176.             return false;  
177.         }  
178.   
179.         public Object getItem(int position) {  
180.             return position;  
181.         }  
182.   
183.         public long getItemId(int position) {  
184.             return position;  
185.         }  
186.   
187.         public View getView(int position, View convertView, ViewGroup parent) {  
188.             ImageView iamge = null;  
189.             TextView title = null;  
190.             TextView text = null;  
191.             if (convertView == null) {  
192.                 convertView = LayoutInflater.from(mContext).inflate(  
193.                         R.layout.colorlist, null);  
194.                 iamge = (ImageView) convertView.findViewById(R.id.color_image);  
195.                 title = (TextView) convertView.findViewById(R.id.color_title);  
196.                 text = (TextView) convertView.findViewById(R.id.color_text);  
197.             }  
198.             //绘制联系人名称  
199.             title.setText(mContactsName.get(position));  
200.             //绘制联系人号码  
201.             text.setText(mContactsNumber.get(position));  
202.             //绘制联系人头像  
203.             iamge.setImageBitmap(mContactsPhonto.get(position));  
204.             return convertView;  
205.         }  
206.   
207.     }  
208. }  

列表的布局文件

[html]  view plain copy

1. <?xml version="1.0" encoding="utf-8"?>    
2.     
3. <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    
4.     android:layout_width="fill_parent" android:layout_height="wrap_content">    
5.     <ImageView android:id="@+id/color_image"    
6.         android:layout_width="40dip" android:layout_height="40dip" />    
7.     <TextView android:id="@+id/color_title"    
8.         android:layout_width="fill_parent" android:layout_height="wrap_content"    
9.         android:layout_toRightOf="@+id/color_image"    
10.         android:layout_alignParentBottom="true"    
11.         android:layout_alignParentRight="true" android:singleLine="true"    
12.         android:ellipsize="marquee"     
13.         android:textSize="15dip"  />    
14.     <TextView android:id="@+id/color_text"    
15.         android:layout_width="fill_parent" android:layout_height="wrap_content"    
16.         android:layout_toRightOf="@+id/color_image"    
17.         android:layout_below="@+id/color_title"    
18.         android:layout_alignParentBottom="true"    
19.         android:layout_alignParentRight="true"     
20.         android:singleLine="true"    
21.         android:ellipsize="marquee"     
22.         android:textSize="20dip" />    
23. </RelativeLayout>