实现读取手机中所有联系人的主要信息（名称和联系电话），并以ListView显示

1. Contact API的结构和使用方法

  自Android 2.0（API Level 5）开始，Android平台采用了改进后的Contacts API- ContactsContract，用于管理和集成来自多账户和多数据来源的联系人信息。

  在新的Contacts API中，联系人数据被安排三个主要的表中：contacts, raw contacts and data. 结构如下图所示：

 

                   （图片来源于：developer.android.com）

  1） Contact 表中的一行记录代表一个联系人的总体信息

  2） RawContact表的一行记录用于关联联系人和一个特定的联系人信息来源。因为有可能手机的联系人信息是来源于Gmail，Facebook等其它地方，为互相区别并方便同步，特引入RawContact概念。

  3） Data表：储存所有具体的信息，如：电话，email地址, 头像等。表的每一条记录对应一个RawContact的一个具体信息。

  总的来说就是：一个contact（联系人）记录关联一个或多个RawContact（联系人来源）记录，每个RawContact记录又关联多个data（email, phone number等等）记录。

  参考1：http://developer.android.com/resources/articles/contacts.html 

  参考2：http://www.haoni.org/2011/04/15/androidcontactscontractyanjiu/

2. ContentProvider组件作用，URI概念及使用方法

  在Android中，应用程序之间是相互独立的，分别运行在自己的进程中。如果应用程序之间想互相共享数据怎么办？比如，当我们发送一条短信时，可能要用到联系人应用程序，从中选择要接受短信的人。在这种情况下，Android提供了应用程序之间互相访问的统一接口，这些接口被定义在ContentProvider中，其中包括增，删，查，改等操作。

  我们在ContentProvider中实现我们实际操作数据的方法。但调用时，我们将使用另外一个接口:ContentResolver。ContentResolver提供了和ContentProvider对应的方法。我们是间接地通过ContentResolver来操作ContentProvider的。ContentResolver可以通过getContentResolver()方法获得。

  URI的讲解: 可以参考http://www.cnblogs.com/thomas-lee/archive/2011/04/16/Android3.html 的相关部分以及官方文档上的相关部分，比如：

http://developer.android.com/guide/topics/providers/content-providers.html#creating中的最后一部分。

TextUtils

  这部分参考：《Android应用开发详解》 郭宏志，电子工业出版社

3.  创建ListView，并绑定数据

  参考：http://developer.android.com/resources/tutorials/views/hello-listview.html

4. 最终代码如下：

package com.memo;
import java.util.ArrayList;
import android.app.ListActivity;
import android.database.Cursor;
import android.net.Uri;
import android.os.Bundle;
import android.provider.ContactsContract;
import android.widget.ArrayAdapter;
import android.widget.ListView;

public class Main extends ListActivity {
   
    /** Called when the activity is first created. */
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super .onCreate(savedInstanceState);
       
        Uri contactsUri = ContactsContract.Contacts.CONTENT_URI;
        String[] proj1 = new String[]{ContactsContract.Contacts.DISPLAY_NAME,
                                    ContactsContract.Contacts.HAS_PHONE_NUMBER,
                                    ContactsContract.Contacts.LOOKUP_KEY};
        Cursor curContacts = getContentResolver().query(contactsUri,proj1, null , null , null );
          
        // declare a ArrayList object to store the data that will present to the user
        ArrayList < String > contactsList = new ArrayList < String > ();
        String allPhoneNo = "" ;
        if (curContacts.getCount() > 0 ){
            while (curContacts.moveToNext()){  
                // get all the phone numbers if exist
                if (curContacts.getInt( 1 ) > 0 ){
                    allPhoneNo = getAllPhoneNumbers(curContacts.getString( 2 ));
                }
                contactsList.add(curContacts.getString( 0 ) + " , " + allPhoneNo);
                allPhoneNo = "" ;
            }
        }
  
        // binding the data to ListView
        setListAdapter( new ArrayAdapter < String > ( this ,android.R.layout.simple_list_item_1, contactsList));
        ListView lv = getListView();
        lv.setTextFilterEnabled( true );
       
    }
   
    /**
     * Get all the phone numbers of a specific contact person
     *
     * @param lookUp_Key lookUp key for a specific contact
     * @return a string containing all the phone numbers
     */
    public String getAllPhoneNumbers(String lookUp_Key){
        String allPhoneNo = "" ;
       
        // Phone info are stored in the ContactsContract.Data table
        Uri phoneUri = ContactsContract.CommonDataKinds.Phone.CONTENT_URI;
        String[] proj2 = {ContactsContract.CommonDataKinds.Phone.NUMBER};
        // using lookUp key to search the phone numbers
        String selection = ContactsContract.Data.LOOKUP_KEY + " =? " ;
        String[] selectionArgs = {lookUp_Key};
        Cursor cur = getContentResolver().query(phoneUri,proj2,selection, selectionArgs, null );
        while (cur.moveToNext()){
            allPhoneNo += cur.getString( 0 ) + " " ;
        }

        return allPhoneNo;
       
    }
   

 

}

5. 注意事项：

  1）由于要读取联系人信息，所以必须在AndroidMenifest.xml里加入相关uses-permission用于请求使用许可:

      <uses-permission android:name="android.permission.READ_CONTACTS" />

      参考1：http://developer.android.com/guide/topics/security/security.html

      参考2：http://www.higherpass.com/Android/Tutorials/Working-With-Android-Contacts/

  2) 怎样获取特定联系人的电话号码？由于使用新的API，所以编写方法与使用旧的API不同。

      在查询是主要使用到lookUp key 的概念。

      参考：http://stackoverflow.com/questions/4729551/contactscontract-lookup-phone-number-by-contact-id