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

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

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(); 
        }          
    } 
    
}