欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

Android ApiDemos示例解析(10):App->Activity->QuickContactsDemo

程序员文章站 2022-03-16 20:57:12
...

QuickContactsDemo示例介绍了如果使用Content Provider来访问Android系统的Contacts 数据库。

Content Provider为不同应用之间共享数据提供了统一的接口,通过对底层数据源的抽象,Content Provider实现了应用程序代码和数据层分离。Android平台对大部分的系统数据库都提供了对应的Content Provider接口:

  • Browser: 读取和修改Bookmark,Browser history或Web Searches。
  • CallLog: 查看或是更新Call History(打入电话或是打出电话,未接电话等)
  • Contacts: 检索,修改或存储通讯录。
  • MediaStore: 访问媒体库(包括声音,视频,图像等)。
  • Settings: 访问系统设置,查看或是修改蓝牙设置,铃声设置等。

Android系统的每个Content Provider都定义了一个CONTENT_URI,功能类似于数据库的名称。Android中每个Context对象(如Activity)对含有一个ContentResolver,ContentResolver可以根据CONTENT_URI获取对应的Content Provider:

public void onCreate(Bundle savedInstanceState) {
 super.onCreate(savedInstanceState);
 String select = "((" + Contacts.DISPLAY_NAME + " NOTNULL) AND ("
 + Contacts.HAS_PHONE_NUMBER + "=1) AND ("
 + Contacts.DISPLAY_NAME + " != '' ))";
 Cursor c =
 getContentResolver().query(Contacts.CONTENT_URI,
 CONTACTS_SUMMARY_PROJECTION,
 select,
 null,
 Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC");
 startManagingCursor(c);
 ContactListItemAdapter adapter
      = new ContactListItemAdapter(this,
      R.layout.quick_contacts, c);
 setListAdapter(adapter);
 
}

getContentResolver() 取的ContentResolver对象,它的Query方法定义如下:

public final Cursorquery(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)

  • Uri: 需要访问的Content Provider对应的URI,如通讯录的URI为Contacts.CONTENT_URI。
  • Projection: 需要返回的表的列名,如为NULL,则返回表的全部列。
  • Selection: 查询数据表的条件,相当于SQL 的Where语句。
  • selectionArgs: 相当于SQL查询条件的查询参数?
  • sortOrder: 相当于SQL查询的Order语句,查询排序,为空时,返回记录的缺省顺序。

可以看得出,Content Provider和 数据库的用法非常类似。query返回的对象为Cusor ,有Cursor对象后就可以和访问数据库表一样来insert ,delete ,update 数据库。

startManagingCursor(c); 让Activity来管理cursor 的生命周期。

此外访问Content Provider还需要合适的权限才能正确访问,比如读写通讯录,需要在AndroidManifest.xml设置:

<uses-permission android:name=”android.permission.READ_CONTACTS” />
<uses-permission android:name=”android.permission.WRITE_CONTACTS” />

才能有权限访问通信录。

Android ApiDemos示例解析(10):App->Activity->QuickContactsDemo

注:如果在模拟器上运行这个示例,需要在Contacts添加几个Contacts,否则这个例子没有显示。