[每天学点Android开发]使用新的Contacts API （ContactsContract）读取联系人信息

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

涉及的主要内容：1) Contact API的结构和使用方法  2) ContentProvider组件作用，URI概念及使用方法  3)创建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