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



 


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



打开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 plaincopy

    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 plaincopy

    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. 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 plaincopy

      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 plaincopy

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







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


        [html] view plaincopy

          1. <!-- 读取联系人权限 -->   
          2. <uses-permission android:name="android.permission.READ_CONTACTS"/>  
          3. <!-- 拨打电话权限 -->  
          4. <uses-permission android:name="android.permission.CALL_PHONE"/>




          下面给出完整的代码


          [java] view plaincopy

          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. 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. null;  
          59. null;  
          60.   
          61. @Override  
          62. public void onCreate(Bundle savedInstanceState) {  
          63. this;  
          64. this.getListView();  
          65. /**得到手机通讯录联系人信息**/  
          66.     getPhoneContacts();  
          67.   
          68. new MyListAdapter(this);  
          69.     setListAdapter(myAdapter);  
          70.   
          71.   
          72. new OnItemClickListener() {  
          73.   
          74. @Override  
          75. public void onItemClick(AdapterView<?> adapterView, View view,  
          76. int position, long id) {  
          77. //调用系统方法拨打电话  
          78. new Intent(Intent.ACTION_CALL, Uri  
          79. "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. 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. 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. "content://icc/adn");  
          139. 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. null;  
          189. null;  
          190. null;  
          191. if (convertView == null || position < mContactsNumber.size()) {  
          192.         convertView = LayoutInflater.from(mContext).inflate(  
          193. 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 plaincopy

            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>