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

àì夳堔傛蜴生んèń 2022-02-28 16:26 245阅读 0赞

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

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