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的path,content:// (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会自动地处理安全性和跨进程通信问题。
参考资料
Reference:
http://developer.android.com/reference/android/content/ContentProvider.html
API Guides:
http://developer.android.com/guide/topics/providers/content-providers.html