作者@恺风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();
}
}
}小例子下载。
