Android软件开发之获取通讯录联系人信息 + android联系人信息的存储结构 + Android联系人读取操作笔记

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

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

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

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

-----------------------------------------------------------------------------------------------------------------------------
另外一篇操作Contacts的文章地址在：http://blog.csdn.net/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第二个参数 

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

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


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

    /**得到手机通讯录联系人信息**/
    private void getPhoneContacts() {
 ContentResolver resolver = mContext.getContentResolver();

 // 获取手机联系人
 Cursor phoneCursor = resolver.query(Phone.CONTENT_URI,PHONES_PROJECTION, null, null, null);


 if (phoneCursor != null) {
     while (phoneCursor.moveToNext()) {

     //得到手机号码
     String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);
     //当手机号码为空的或者为空字段 跳过当前循环
     if (TextUtils.isEmpty(phoneNumber))
         continue;

     //得到联系人名称
     String contactName = phoneCursor.getString(PHONES_DISPLAY_NAME_INDEX);

     //得到联系人ID
     Long contactid = phoneCursor.getLong(PHONES_CONTACT_ID_INDEX);

     //得到联系人头像ID
     Long photoid = phoneCursor.getLong(PHONES_PHOTO_ID_INDEX);

     //得到联系人头像Bitamp
     Bitmap contactPhoto = null;

     //photoid 大于0 表示联系人有头像 如果没有给此人设置头像则给他一个默认的
     if(photoid > 0 ) {
         Uri uri =ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI,contactid);
         InputStream input = ContactsContract.Contacts.openContactPhotoInputStream(resolver, uri);
         contactPhoto = BitmapFactory.decodeStream(input);
     }else {
         contactPhoto = BitmapFactory.decodeResource(getResources(), R.drawable.contact_photo);
     }

     mContactsName.add(contactName);
     mContactsNumber.add(phoneNumber);
     mContactsPhonto.add(contactPhoto);
     }

     phoneCursor.close();
 }
    }

获得手机sim卡联系人信息

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

    /**得到手机SIM卡联系人人信息**/
    private void getSIMContacts() {
 ContentResolver resolver = mContext.getContentResolver();
 // 获取Sims卡联系人
 Uri uri = Uri.parse("content://icc/adn");
 Cursor phoneCursor = resolver.query(uri, PHONES_PROJECTION, null, null,
     null);

 if (phoneCursor != null) {
     while (phoneCursor.moveToNext()) {

     // 得到手机号码
     String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);
     // 当手机号码为空的或者为空字段 跳过当前循环
     if (TextUtils.isEmpty(phoneNumber))
         continue;
     // 得到联系人名称
     String contactName = phoneCursor
         .getString(PHONES_DISPLAY_NAME_INDEX);

     //Sim卡中没有联系人头像

     mContactsName.add(contactName);
     mContactsNumber.add(phoneNumber);
     }

     phoneCursor.close();
 }
    }

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

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

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

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

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

下面给出完整的代码

 import java.io.InputStream;
 import java.util.ArrayList;

 import android.app.ListActivity;
 import android.content.ContentResolver;
 import android.content.ContentUris;
 import android.content.Context;
 import android.content.Intent;
 import android.database.Cursor;
 import android.graphics.Bitmap;
 import android.graphics.BitmapFactory;
 import android.net.Uri;
 import android.os.Bundle;
 import android.provider.ContactsContract;
 import android.provider.ContactsContract.CommonDataKinds.Phone;
 import android.provider.ContactsContract.CommonDataKinds.Photo;
 import android.text.TextUtils;
 import android.view.LayoutInflater;
 import android.view.View;
 import android.view.ViewGroup;
 import android.widget.AdapterView;
 import android.widget.BaseAdapter;
 import android.widget.ImageView;
 import android.widget.ListView;
 import android.widget.TextView;
 import android.widget.AdapterView.OnItemClickListener;

 public class ContactsActivity extends ListActivity {

     Context mContext = null;

     /**获取库Phon表字段**/
     private static final String[] PHONES_PROJECTION = new String[] {
         Phone.DISPLAY_NAME, Phone.NUMBER, Photo.PHOTO_ID,Phone.CONTACT_ID };

     /**联系人显示名称**/
     private static final int PHONES_DISPLAY_NAME_INDEX = 0;

     /**电话号码**/
     private static final int PHONES_NUMBER_INDEX = 1;

     /**头像ID**/
     private static final int PHONES_PHOTO_ID_INDEX = 2;

     /**联系人的ID**/
     private static final int PHONES_CONTACT_ID_INDEX = 3;


     /**联系人名称**/
     private ArrayList<String> mContactsName = new ArrayList<String>();

     /**联系人头像**/
     private ArrayList<String> mContactsNumber = new ArrayList<String>();

     /**联系人头像**/
     private ArrayList<Bitmap> mContactsPhonto = new ArrayList<Bitmap>();

     ListView mListView = null;
     MyListAdapter myAdapter = null;

     @Override
     public void onCreate(Bundle savedInstanceState) {
     mContext = this;
     mListView = this.getListView();
     /**得到手机通讯录联系人信息**/
     getPhoneContacts();

     myAdapter = new MyListAdapter(this);
     setListAdapter(myAdapter);


     mListView.setOnItemClickListener(new OnItemClickListener() {

         @Override
         public void onItemClick(AdapterView<?> adapterView, View view,
             int position, long id) {
         //调用系统方法拨打电话
         Intent dialIntent = new Intent(Intent.ACTION_CALL, Uri
             .parse("tel:" + mContactsNumber.get(position)));
         startActivity(dialIntent);
         }
     });

     super.onCreate(savedInstanceState);
     }

     /**得到手机通讯录联系人信息**/
     private void getPhoneContacts() {
     ContentResolver resolver = mContext.getContentResolver();

     // 获取手机联系人
     Cursor phoneCursor = resolver.query(Phone.CONTENT_URI,PHONES_PROJECTION, null, null, null);


     if (phoneCursor != null) {
         while (phoneCursor.moveToNext()) {

         //得到手机号码
         String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);
         //当手机号码为空的或者为空字段 跳过当前循环
         if (TextUtils.isEmpty(phoneNumber))
             continue;

         //得到联系人名称
         String contactName = phoneCursor.getString(PHONES_DISPLAY_NAME_INDEX);

         //得到联系人ID
         Long contactid = phoneCursor.getLong(PHONES_CONTACT_ID_INDEX);

         //得到联系人头像ID
         Long photoid = phoneCursor.getLong(PHONES_PHOTO_ID_INDEX);

         //得到联系人头像Bitamp
         Bitmap contactPhoto = null;

         //photoid 大于0 表示联系人有头像 如果没有给此人设置头像则给他一个默认的
         if(photoid > 0 ) {
             Uri uri =ContentUris.withAppendedId(ContactsContract.Contacts.CONTENT_URI,contactid);
             InputStream input = ContactsContract.Contacts.openContactPhotoInputStream(resolver, uri);
             contactPhoto = BitmapFactory.decodeStream(input);
         }else {
             contactPhoto = BitmapFactory.decodeResource(getResources(), R.drawable.contact_photo);
         }

         mContactsName.add(contactName);
         mContactsNumber.add(phoneNumber);
         mContactsPhonto.add(contactPhoto);
         }

         phoneCursor.close();
     }
     }

     /**得到手机SIM卡联系人人信息**/
     private void getSIMContacts() {
     ContentResolver resolver = mContext.getContentResolver();
     // 获取Sims卡联系人
     Uri uri = Uri.parse("content://icc/adn");
     Cursor phoneCursor = resolver.query(uri, PHONES_PROJECTION, null, null,
         null);

     if (phoneCursor != null) {
         while (phoneCursor.moveToNext()) {

         // 得到手机号码
         String phoneNumber = phoneCursor.getString(PHONES_NUMBER_INDEX);
         // 当手机号码为空的或者为空字段 跳过当前循环
         if (TextUtils.isEmpty(phoneNumber))
             continue;
         // 得到联系人名称
         String contactName = phoneCursor
             .getString(PHONES_DISPLAY_NAME_INDEX);

         //Sim卡中没有联系人头像

         mContactsName.add(contactName);
         mContactsNumber.add(phoneNumber);
         }

         phoneCursor.close();
     }
     }

     class MyListAdapter extends BaseAdapter {
     public MyListAdapter(Context context) {
         mContext = context;
     }

     public int getCount() {
         //设置绘制数量
         return mContactsName.size();
     }

     @Override
     public boolean areAllItemsEnabled() {
         return false;
     }

     public Object getItem(int position) {
         return position;
     }

     public long getItemId(int position) {
         return position;
     }

     public View getView(int position, View convertView, ViewGroup parent) {
         ImageView iamge = null;
         TextView title = null;
         TextView text = null;
         if (convertView == null || position < mContactsNumber.size()) {
         convertView = LayoutInflater.from(mContext).inflate(
             R.layout.colorlist, null);
         iamge = (ImageView) convertView.findViewById(R.id.color_image);
         title = (TextView) convertView.findViewById(R.id.color_title);
         text = (TextView) convertView.findViewById(R.id.color_text);
         }
         //绘制联系人名称
         title.setText(mContactsName.get(position));
         //绘制联系人号码
         text.setText(mContactsNumber.get(position));
         //绘制联系人头像
         iamge.setImageBitmap(mContactsPhonto.get(position));
         return convertView;
     }

     }
 }

列表的布局文件

 <?xml version="1.0" encoding="utf-8"?>

 <RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
     android:layout_width="fill_parent" android:layout_height="wrap_content">
     <ImageView android:id="@+id/color_image"
         android:layout_width="40dip" android:layout_height="40dip" />
     <TextView android:id="@+id/color_title"
         android:layout_width="fill_parent" android:layout_height="wrap_content"
         android:layout_toRightOf="@+id/color_image"
         android:layout_alignParentBottom="true"
         android:layout_alignParentRight="true" android:singleLine="true"
         android:ellipsize="marquee"
         android:textSize="15dip"  />
     <TextView android:id="@+id/color_text"
         android:layout_width="fill_parent" android:layout_height="wrap_content"
         android:layout_toRightOf="@+id/color_image"
         android:layout_below="@+id/color_title"
         android:layout_alignParentBottom="true"
         android:layout_alignParentRight="true"
         android:singleLine="true"
         android:ellipsize="marquee"
         android:textSize="20dip" />
 </RelativeLayout>

这章的内容如果有更熟悉的朋友欢迎和我一起讨论。老规矩每篇文章都会附带源代码，最后如果你还是觉得我写的不够详细 看的不够爽 不要紧我把源代码的下载地址贴出来 欢迎大家一起讨论学习雨松MOMO希望可以和大家一起进步。

下载地址：http://download.csdn.net/source/3559166

原文楼主追加评论：
确实有个BUG，请大家修改一下getView方法就可以了。
public View getView(int position, View convertView, ViewGroup parent) {
ImageView iamge = null;
TextView title = null;
TextView text = null;
if (convertView == null || position < mContactsNumber.size()) {
convertView = LayoutInflater.from(mContext).inflate(
R.layout.contactslist, null);
iamge = (ImageView) convertView.findViewById(R.id.color_image);
title = (TextView) convertView.findViewById(R.id.color_title);
text = (TextView) convertView.findViewById(R.id.color_text);
}
// 绘制联系人名称
title.setText(mContactsName.get(position));
// 绘制联系人号码
text.setText(mContactsNumber.get(position));
// 绘制联系人头像
iamge.setImageBitmap(mContactsPhonto.get(position));
return convertView;
}