Android Content Provider基础

时间:2024-07-26 20:37:02

Android Content Provider基础

Content Providers

  Content providers管理对一个结构化的数据集合的访问。它们封装了数据,并且提供了保护数据安全性的机制。

  Content providers是连接跨进程数据的标准接口。

  当你需要访问一个content provider中的数据时:

  你在应用的Context中,使用ContentResolver对象作为一个客户端(client),来和provider通信。

  而provider是实现了ContentProvider的一个类的实例,它接收来自客户端的请求,执行请求的动作,然后返回结果。

  一般情况下如果你不想和其他应用分享数据的话,是不用开发你自己的content provider的,但是,如果你在你的应用中需要自定义搜索建议,或者实现复制粘贴复杂数据或者文件到其他应用中,你还是需要自己实现provider。

  Android本身包含了一些content providers,他们管理音频、视频、图像、联系人信息等数据。

  你可以从这个包中(android.provider)看到它们。

  这些providers可以在一些限制条件下,被任何Android应用访问。

Content Provider Basics

  Content provider最初就是想提供给其他应用来访问的,providers和provider clients提供了一个一致、标准的接口来访问数据,同时也处理了跨进程的通信和数据访问的安全问题。

  下面讨论几个基础问题。

数据保存形式

  Content provider向外部应用提供数据,用一个或多个table的形式,和关系型数据中的表(table)是类似的,一行就代表了一条数据实例,而这行中的每一列代表了这个实例中的一项数据。表中每一列的header是列名。

  注意:一个provider是不要求有主键(primary key)的,如果有主键,也不要求非要用_ID这个名字。

  但是,如果你想要把provider的数据和一个ListView绑定,必须有一列叫_ID,原因在 Displaying query results部分解释。

访问一个provider

  Provider是一个 ContentProvider类的具体子类的实例。

  要访问provider,需要通过一个客户端对象,即一个 ContentResolver 对象。这个对象中含有一些方法,名字和provider中的相同。

  ContentResolver中的方法提供了基本的CRUD(create, retrieve, update, and delete)功能。

  客户端应用中的ContentResolver对象和拥有provider的应用中的ContentProvider对象自动地处理跨进程的通信(inter-process communication)。

  Provider也扮演一个抽象层,位置处在repository of data和作为data外部表现的tables之间。  

  注意:要访问一个provider,你的应用通常需要请求一些特定的权限,这些在Content Provider Permissions部分讨论。

Content URIs

  Content URI是一个URI,它用来确定识别(identify)provider中的数据的。

  Content URIs包含了provider的标志符号名(authority)和一个指向表的名字(path)。

  当你调用一个客户端方法访问provider中的table时,content URI就是其中一个参数。

   ContentResolver对象会解析出URI的authority,通过和系统中已知的providers的表进行对比,决议找出需要的provider。

  之后,ContentResolver对象将会向正确的provider分发(dispatch)查询的参数。

  ContentProvider使用URI的path部分来选择要访问的table,通常每一个table都有一个path。

  一个完整的URI例子:

  content://user_dictionary/words

  其中user_dictionary为authority,words为table的pathcontent:// (the scheme)必须有,它说明这个URI是一个content URI。  

  有很多的provider允许你在URI中附加ID值来访问table中的某一行,比如:

Uri singleUri = ContentUris.withAppendedId(UserDictionary.Words.CONTENT_URI,4);

  注意: Uri 和 Uri.Builder 类包含了很多方法可以从字符串构造URI;ContentUris 提供了方便的方法可以给URI附加id值。

Retrieving Data from the Provider

  从provider中取数据,基本的步骤如下:

  1.请求向provider获取数据的权限。

  2.定义代码,向provider发送查询。

  权限的获取不能是运行时请求的,必须在manifest文件中说明你需要这种权限,使用<uses-permission> 元素,然后用provider定义的权限名。

  更多关于provider的权限的讨论参见:Content Provider Permissions.

  构造查询:查询类似于SQL查询,包含了要返回的一些列(The set of columns that the query should return is called a projection),一个选择标准的集合,以及排序的顺序。

Displaying query results

  客户端方法 ContentResolver.query() 总是返回Cursor,包含了满足选择标准的中的由projection指定的containing the columns specified by the query's projection for the rows that match the query's selection criteria)。

  Cursor 提供了对其包含的行和列的随机访问。

  使用 Cursor 类的方法,可以迭代访问结果中的行,决定每一列的数据类型,从列中取得数据,检验结果的其他特性等。

  一些Cursor类的实现会在provider中的数据改变时自动地更新对象,或者在Cursor改变的时候,触发一些观察者对象的方法,或者二者都有。

  注意:一个provider有可能会根据发出查询的对象的本质,限制对列的访问。

  比如,Contacts Provider对sync adapters限制了对某些列的访问,所以它不会把这些列发送给一个activity或者service。

  如果没有行满足查询条件,provider会返回一个空的Cursor对象,即它的 Cursor.getCount() 是0。

  如果查询失败,查询的结果取决于具体的provider,它可以选择返回null,也可能是抛出异常。

  

  由于一个 Cursor是一个行的列表,一个显示它的内容的不错的方法就是用一个SimpleCursorAdapter把 Cursor和 ListView 连接起来。

  注意,要用ListView显示时,Cursor必须包含一个列叫做_ID。因此,很多providers中,每一个表都有一个_ID列。

  和从provider查取数据类似,你也可以使用客户端和provider的交互方式来修改数据。

  你调用一个 ContentResolver的方法,传递参数,接着就被传到 ContentProvider中的对应方法中去,provider和provider client会自动地处理安全性和跨进程通信问题。

  具体参见:Inserting, Updating, and Deleting Data

参考资料

  Reference:

  http://developer.android.com/reference/android/content/ContentProvider.html

  API Guides:

  http://developer.android.com/guide/topics/providers/content-providers.html