文章转载只能用于非商业性质,且不能带有虚拟货币、积分、注册等附加条件。转载须注明出处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开发相关文章