Pro Android学习笔记（一六一）：联系人API（4）：读取整合联系人

文章转载只能用于非商业性质，且不能带有虚拟货币、积分、注册等附加条件。转载须注明出处http://blog.csdn.net/flowingflying/以及作者@恺风Wei。

本次我们将写一个小例子读取整合联系人的信息。要读取联系人需要声明权限

android.permission.READ_CONTACTS

读取整合联系人的信息小例子的代码如下：

public class AggregatedContactsTest extends ....{ 
    … …  //隐藏无关代码，showInfo()用于在UI或者LogCat中显示文字信息。

    //【1.1】通过URIContactsContract.Contacts.CONTENT_URI 获取整合联系的cursor   
    private Cursor getContactsCursor(){
        Uri uri = ContactsContract.Contacts.CONTENT_URI; 
        // 通常需要按排序姓氏的排序返回联系人，因此在SQL语句中将加上相关的sort by条件。需要注意的是，需要支持对中文（或其他非英语）的字母排序，因此加上COLLATE。COLLATE是一个SQL炒作，允许重置缺省的字符排序，例如"COLLATE NOCASE"表示不分大小写，"COLLATE BINARY"则表示大小写敏感，COLLATE LOCALIZED则表示non-ASCII字符，例如中文的Unicode编码，看用于非英文或混合情况的合适排序。但是如果我们自己要做一个联系人列表，仅COLLATE LOCALIZED仍然是不够了，例如曾（zeng）作为姓，本应排在z，但是这属于多音字，按常规读法会放在C（ceng） ，还需要一些调整。
        String sortOrder = ContactsContract.Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC";        
        ContentResolver cv = mContext.getContentResolver();
        return cv.query(uri, null, null, null, sortOrder);       
    }    
    
    //【1】显示整合联系人信息
    public void listAggreatedContacts(){
        Cursor c = null;
        try{
            c = getContactsCursor(); //【1.1】获取整合联系人的cursor
            //【1.2】显示整合联系人有哪些信息
            printColumnNames(c, tag, mReport); 
            //【1.3】显示各个contacts的信息
            listContacts(c);             
        }catch(Exception e){
            showInfo("ERROR :" + e.toString());
            e.printStackTrace();
        }finally{
            if(c != null)
                c.close();
        }         
    }
   
    //【1.2】显示整合联系人有哪些信息
    private void printColumnNames(Cursor c){
        int count = c.getColumnCount();
        StringBuffer columnNamesBuffer = new StringBuffer();
        for(int i = 0 ; i < count ; i ++){
            String columnName = c.getColumnName(i);
            columnNamesBuffer.append(columnName).append(';');
        }
        showInfo(columnNamesBuffer.toString());   
    }

    //【1.3】显示各个contacts的信息，为了避免UI上显示过多，只显示前面20个整合联系人，每个联系人信息选取了_ID，display name，以及我们后面需要学习lookup key，并由其生成lookup key Uri。  
    private void listContacts(Cursor c){
        int maxCount = 20;
        int num = 0;
        for(c.moveToFirst(),num = 0;!c.isAfterLast() && num < maxCount;c.moveToNext(),num ++){
            String id = getColumnValue(c, "_ID");
            String name = getColumnValue(c, ContactsContract.Contacts.DISPLAY_NAME);
            String lookupKey = getColumnValue(c, ContactsContract.Contacts.LOOKUP_KEY); 
            String lookupUri = ContactsContract.Contacts.CONTENT_LOOKUP_URI + "/" + lookupKey; 
            showInfo("【"+ num + "】" +id+ " " +  name + ":" + lookupUri);
            //【2】我们对第一个整合联系人中的lookup Uri进行进一步探索，看看Lookup Uri的用法  
            if(num == 0)
                searchByLookUpUri(lookupUri);
        }       
    }
   
    //【2】我们对第一个整合联系人中的lookup Uri进行进一步探索
    private void searchByLookUpUri(String lookupUri){
        Cursor c = null;
        try{
            ContentResolver cv = mContext.getContentResolver();
            c =  cv.query(Uri.parse(lookupUri), null, null, null, null);
            /* 【2.1】查看通过LookUpUri看待回来的列表信息。 
             * 我 们可以看出LookUpUri给出的列表信息内容和通过ontactsContract.Contacts.CONTENT_URI得到的列表信息相同。通过LookUpUri我们可以马上直接定位到某个整合联系人，在数据查询中具有更高的效率。LookUpUri实际上标识了各整合的raw contacts，但返回的是整合联系人的cursor。Android通过Lookup key得到组成的各raw contacts 找到这些raw contacts最匹配的aggregated contact ID，然后返回该整合联系人记录。Android不提供从lookup key找到对应的raw contacts的public API。
             */ 
            printColumnNames(c, tag, mReport); 

            //【2.2】可以通过LookUp URI获取该整合联系人的信息，演示_ID，display name和lookup key三个内容
            for(c.moveToFirst();!c.isAfterLast();c.moveToNext()){
                String id = getColumnValue(c, "_ID");
                String name = getColumnValue(c, ContactsContract.Contacts.DISPLAY_NAME);
                String lookupKey = getColumnValue(c, ContactsContract.Contacts.LOOKUP_KEY); 
                showInfo("---("+ id + ")"  +  name + ":" + lookupKey);
            }   
           
        }finally{
            if(c != null)
                c.close();
        }         
    }
   
}

小例子下载。

相关链接：我的Android开发相关文章