Android中ContentResolver.query 参数详解(转) .
首先看一个简单的例子,这个函数获取设备上所有的联系人ID和联系人NAME:
public void fetchAllContacts() { ContentResolver contentResolver = this.getContentResolver(); Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI, null, null, null, null); cursor.getCount(); while(cursor.moveToNext()) { System.out.println(cursor.getString(cursor.getColumnIndex(android.provider.ContactsContract.Contacts._ID))); System.out.println(cursor.getString(cursor.getColumnIndex(android.provider.ContactsContract.Contacts.DISPLAY_NAME))); } cursor.close(); }
运行结果:
11-05 14:13:09.987: I/System.out(4692): 13
11-05 14:13:09.987: I/System.out(4692): 张三
11-05 14:13:09.987: I/System.out(4692): 31
11-05 14:13:09.987: I/System.out(4692): 李四
解释:
ContentResolver contentResolver = this.getContentResolver();
this在这里指的是context,ContentResolver直译为内容解析器,什么东西?Android中程序间数据的共享是通过Provider/Resolver进行的。提供数据(内容)的就叫Provider,Resovler提供接口对这个内容进行解读。
在这里,系统提供了联系人的Provider,那么我们就需要构建一个Resolver来读取联系人的内容。
Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI, null, null, null, null);
根据Android文档,
public final Cursor query (Uri uri, String[] projection,String selection,String[] selectionArgs, String sortOrder)
uri : 上面我们提到了Android提供内容的叫Provider,那么在Android中怎么区分各个Provider?有提供联系人的,有提供图片的等等。所以就需要有一个唯一的标识来标识这个Provider,Uri就是这个标识,android.provider.ContactsContract.Contacts.CONTENT_URI就是提供联系人的内容的地址,可惜这个内容提供者提供的数据很少。
projection : 真不知道为什么要用这个单词,这个参数告诉查询要返回的列(Column),比如Contacts Provider提供了联系人的ID和联系人的NAME等内容,如果我们只需要NAME,那么我们就应该使用:
projection=new String[]{android.provider.ContactsContract.Contacts.DISPLAY_NAME};
selection :查询where字句
selectionArgs : 查询条件属性值
sortOrder :结果排序规则