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第二個參數

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

　　它的意思是只去表中找 顯示名稱  電話號碼 頭像ID  聯系人ID 這4個數據 ，如果你須要其它數據 的話 就須要修改這裡。

　　獲得手機通訊錄聯系人信息

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.     if (phoneCursor != null) {  
9.         while (phoneCursor.moveToNext()) {  
10.    
11.         //得到手機號碼  
12.         String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);  
13.         //當手機號碼為空的或者為空字段 跳過當前循環  
14.         if (TextUtils.isEmpty(phoneNumber))  
15.             continue;  
16.    
17.         //得到聯系人名稱  
18.         String contactName = phoneCursor.getString(PHONES_DISPLAY_NAME_INDEX);  
19.    
20.         //得到聯系人ID  
21.         Long contactid = phoneCursor.getLong(PHONES_CONTACT_ID_INDEX);  
22.    
23.         //得到聯系人頭像ID  
24.         Long photoid = phoneCursor.getLong(PHONES_PHOTO_ID_INDEX);  
25.    
26.         //得到聯系人頭像Bitamp  
27.         Bitmap contactPhoto = null;  
28.    
29.         //photoid 大於0 表示聯系人有頭像 如果沒有給此人設置頭像則給他一個默認的  
30.         if(photoid > 0 ) {  
31.             Uri uri =ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI,contactid);  
32.             InputStream input = ContactsContract.Contacts.openContactPhotoInputStream(resolver, uri);  
33.             contactPhoto = BitmapFactory.decodeStream(input);  
34.         }else {  
35.             contactPhoto = BitmapFactory.decodeResource(getResources(), R.drawable.contact_photo);  
36.         }  
37.    
38.         mContactsName.add(contactName);  
39.         mContactsNumber.add(phoneNumber);  
40.         mContactsPhonto.add(contactPhoto);  
41.         }  
42.    
43.         phoneCursor.close();  
44.     }  
45. }

　　獲得手機sim卡聯系人信息

　　sim卡和手機本人 獲取的方式類似 只是url有點不一樣 ，須要注意的一點是 sim卡  是沒有聯系人頭像的。

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卡中，然後在聯系人中設置一下，這裡就可以看到頭像了，或者 真機上會比較清楚、

　　任意點擊一個聯系人會調用系統撥打電話的界面 ，代碼如下。 

1. //調用系統方法撥打電話  
2. Intent dialIntent = new Intent(Intent.ACTION_CALL, Uri  
3.        .parse("tel:" + mContactsNumber.get(position)));  
4. startActivity(dialIntent);  

1. <!-- 讀取聯系人權限 -->  
2. <uses-permission android:name="android.permission.READ_CONTACTS"/>  
3. <!-- 撥打電話權限 -->  
4. <uses-permission android:name="android.permission.CALL_PHONE"/>  

　　下面給出完整的代碼

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.     private ArrayList<String> mContactsName = new ArrayList<String>();  
50.    
51.     /**聯系人頭像**/  
52.     private ArrayList<String> mContactsNumber = new ArrayList<String>();  
53.    
54.     /**聯系人頭像**/  
55.     private ArrayList<Bitmap> mContactsPhonto = new ArrayList<Bitmap>();  
56.    
57.     ListView mListView = null;  
58.     MyListAdapter myAdapter = null;  
59.    
60.     @Override  
61.     public void onCreate(Bundle savedInstanceState) {  
62.     mContext = this;  
63.     mListView = this.getListView();  
64.     /**得到手機通訊錄聯系人信息**/  
65.     getPhoneContacts();  
66.    
67.     myAdapter = new MyListAdapter(this);  
68.     setListAdapter(myAdapter);  
69.    
70.     mListView.setOnItemClickListener(new OnItemClickListener() {  
71.    
72.         @Override  
73.         public void onItemClick(AdapterView<?> adapterView, View view,  
74.             int position, long id) {  
75.         //調用系統方法撥打電話  
76.         Intent dialIntent = new Intent(Intent.ACTION_CALL, Uri  
77.             .parse("tel:" + mContactsNumber.get(position)));  
78.         startActivity(dialIntent);  
79.         }  
80.     });  
81.    
82.     super.onCreate(savedInstanceState);  
83.     }  
84.    
85.     /**得到手機通訊錄聯系人信息**/  
86.     private void getPhoneContacts() {  
87.     ContentResolver resolver = mContext.getContentResolver();  
88.    
89.     // 獲取手機聯系人  
90.     Cursor phoneCursor = resolver.query(Phone.CONTENT_URI,PHONES_PROJECTION, null, null, null);  
91.    
92.     if (phoneCursor != null) {  
93.         while (phoneCursor.moveToNext()) {  
94.    
95.         //得到手機號碼  
96.         String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);  
97.         //當手機號碼為空的或者為空字段 跳過當前循環  
98.         if (TextUtils.isEmpty(phoneNumber))  
99.             continue;  
100.    
101.         //得到聯系人名稱  
102.         String contactName = phoneCursor.getString(PHONES_DISPLAY_NAME_INDEX);  
103.    
104.         //得到聯系人ID  
105.         Long contactid = phoneCursor.getLong(PHONES_CONTACT_ID_INDEX);  
106.    
107.         //得到聯系人頭像ID  
108.         Long photoid = phoneCursor.getLong(PHONES_PHOTO_ID_INDEX);  
109.    
110.         //得到聯系人頭像Bitamp  
111.         Bitmap contactPhoto = null;  
112.    
113.         //photoid 大於0 表示聯系人有頭像 如果沒有給此人設置頭像則給他一個默認的  
114.         if(photoid > 0 ) {  
115.             Uri uri =ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI,contactid);  
116.             InputStream input = ContactsContract.Contacts.openContactPhotoInputStream(resolver, uri);  
117.             contactPhoto = BitmapFactory.decodeStream(input);  
118.         }else {  
119.             contactPhoto = BitmapFactory.decodeResource(getResources(), R.drawable.contact_photo);  
120.         }  
121.    
122.         mContactsName.add(contactName);  
123.         mContactsNumber.add(phoneNumber);  
124.         mContactsPhonto.add(contactPhoto);  
125.         }  
126.    
127.         phoneCursor.close();  
128.     }  
129.     }  
130.    
131.     /**得到手機SIM卡聯系人人信息**/  
132.     private void getSIMContacts() {  
133.     ContentResolver resolver = mContext.getContentResolver();  
134.     // 獲取Sims卡聯系人  
135.     Uri uri = Uri.parse("content://icc/adn");  
136.     Cursor phoneCursor = resolver.query(uri, PHONES_PROJECTION, null, null,  
137.         null);  
138.    
139.     if (phoneCursor != null) {  
140.         while (phoneCursor.moveToNext()) {  
141.    
142.         // 得到手機號碼  
143.         String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);  
144.         // 當手機號碼為空的或者為空字段 跳過當前循環  
145.         if (TextUtils.isEmpty(phoneNumber))  
146.             continue;  
147.         // 得到聯系人名稱  
148.         String contactName = phoneCursor  
149.             .getString(PHONES_DISPLAY_NAME_INDEX);  
150.    
151.         //Sim卡中沒有聯系人頭像  
152.    
153.         mContactsName.add(contactName);  
154.         mContactsNumber.add(phoneNumber);  
155.         }  
156.    
157.         phoneCursor.close();  
158.     }  
159.     }  
160.    
161.     class MyListAdapter extends BaseAdapter {  
162.     public MyListAdapter(Context context) {  
163.         mContext = context;  
164.     }  
165.    
166.     public int getCount() {  
167.         //設置繪制數量  
168.         return mContactsName.size();  
169.     }  
170.    
171.     @Override  
172.     public boolean areAllItemsEnabled() {  
173.         return false;  
174.     }  
175.    
176.     public Object getItem(int position) {  
177.         return position;  
178.     }  
179.    
180.     public long getItemId(int position) {  
181.         return position;  
182.     }  
183.    
184.     public View getView(int position, View convertView, ViewGroup parent) {  
185.         ImageView iamge = null;  
186.         TextView title = null;  
187.         TextView text = null;  
188.         if (convertView == null ¦¦ position < mContactsNumber.size()) {  
189.         convertView = LayoutInflater.from(mContext).inflate(  
190.             R.layout.colorlist, null);  
191.         iamge = (ImageView) convertView.findViewById(R.id.color_image);  
192.         title = (TextView) convertView.findViewById(R.id.color_title);  
193.         text = (TextView) convertView.findViewById(R.id.color_text);  
194.         }  
195.         //繪制聯系人名稱  
196.         title.setText(mContactsName.get(position));  
197.         //繪制聯系人號碼  
198.         text.setText(mContactsNumber.get(position));  
199.         //繪制聯系人頭像  
200.         iamge.setImageBitmap(mContactsPhonto.get(position));  
201.         return convertView;  
202.     }  
203.    
204.     }  
205. }  

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>  

　　下載地址：http://vdisk.weibo.com/s/aa4uT