Android 学习笔记 Contacts （一）ContentResolver query 参数详解

1.获取联系人姓名

一个简单的例子，这个函数获取设备上所有的联系人ID和联系人NAME。

[java]  view plain copy

1. public void fetchAllContacts() {  
2.     ContentResolver contentResolver = this.getContentResolver();  
3.     Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI,  
4.             null, null, null, null);  
5.     cursor.getCount();  
6.     while(cursor.moveToNext()) {  
7.         System.out.println(cursor.getString(cursor.getColumnIndex(android.provider.ContactsContract.Contacts._ID)));  
8.         System.out.println(cursor.getString(cursor.getColumnIndex(android.provider.ContactsContract.Contacts.DISPLAY_NAME)));  
9.     }  
10.     cursor.close();  
11. }  

执行结果：

[java]  view plain copy

1. 11-05 14:13:09.987: I/System.out(4692): 13  
2. 11-05 14:13:09.987: I/System.out(4692): 张三  
3. 11-05 14:13:09.987: I/System.out(4692): 31  
4. 11-05 14:13:09.987: I/System.out(4692): 李四  

解释：

[java]  view plain copy

1. ContentResolver contentResolver = this.getContentResolver();  

this在这里指的是MainActivity，ContentResolver直译为内容解析器，什么东东？Android中程序间数据的共享是通过Provider/Resolver进行的。提供数据（内容）的就叫Provider，Resovler提供接口对这个内容进行解读。

在这里，系统提供了联系人的Provider，那么我们就需要构建一个Resolver来读取联系人的内容。

[java]  view plain copy

1. Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI,  
2.                 null, null, null, null);  

根据Android文档，

public final Cursor query (Uri uri, String[] projection,String selection,String[] selectionArgs, StringsortOrder)

第一个参数，uri，rui是什么呢？好吧，上面我们提到了Android提供内容的叫Provider，那么在Android中怎么区分各个Provider？有提供联系人的，有提供图片的等等。所以就需要有一个唯一的标识来标识这个Provider，Uri就是这个标识，android.provider.ContactsContract.Contacts.CONTENT_URI就是提供联系人的内容提供者，可惜这个内容提供者提供的数据很少。

第二个参数，projection，真不知道为什么要用这个单词，这个参数告诉Provider要返回的内容（列Column），比如Contacts Provider提供了联系人的ID和联系人的NAME等内容，如果我们只需要NAME，那么我们就应该使用：

[java]  view plain copy

1. Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI,  
2.     new String[]{android.provider.ContactsContract.Contacts.DISPLAY_NAME}, null, null, null);  

当然，下面打印的你就只能显示NAME了，因为你返回的结果不包含ID。用null表示返回Provider的所有内容（列Column）。

第三个参数，selection，设置条件，相当于SQL语句中的where。null表示不进行筛选。如果我们只想返回名称为张三的数据，第三个参数应该设置为：

[java]  view plain copy

1. Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI,  
2.     new String[]{android.provider.ContactsContract.Contacts.DISPLAY_NAME},  
3.     android.provider.ContactsContract.Contacts.DISPLAY_NAME + "='张三'", null, null);  

结果：

[java]  view plain copy

1. 11-05 15:30:32.188: I/System.out(10271): 张三  

第四个参数，selectionArgs，这个参数是要配合第三个参数使用的，如果你在第三个参数里面有？，那么你在selectionArgs写的数据就会替换掉？，

[java]  view plain copy

1. Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI,  
2.     new String[]{android.provider.ContactsContract.Contacts.DISPLAY_NAME},  
3.     android.provider.ContactsContract.Contacts.DISPLAY_NAME + "=?",  
4.                 new String[]{"张三"}, null);  

效果和上面一句的效果一样。

第五个参数，sortOrder，按照什么进行排序，相当于SQL语句中的Order by。如果想要结果按照ID的降序排列：

[java]  view plain copy

1. Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI,  
2.                 null, null,null, android.provider.ContactsContract.Contacts._ID + " DESC");  

结果：

[java]  view plain copy

1. 11-05 16:00:32.808: I/System.out(12523): 31  
2. 11-05 16:00:32.808: I/System.out(12523): 李四  
3. 11-05 16:00:32.817: I/System.out(12523): 13  
4. 11-05 16:00:32.817: I/System.out(12523): 张三  

升序，其实默认排序是升序，+" ASC"写不写效果都一样：

[java]  view plain copy

1. Cursor cursor = contentResolver.query(android.provider.ContactsContract.Contacts.CONTENT_URI,  
2.                 null, null,null, android.provider.ContactsContract.Contacts._ID + " ASC");  

结果：

[java]  view plain copy

1. 11-05 15:59:10.327: I/System.out(12406): 13  
2. 11-05 15:59:10.327: I/System.out(12406): 张三  
3. 11-05 15:59:10.327: I/System.out(12406): 31  
4. 11-05 15:59:10.327: I/System.out(12406): 李四