疯狂android资料：第九章使用ContentProvider实现数据共享.doc

2013年1月26日23:07:23

2013年1月27日18:05:18
为了在应用程序之间交换数据，android提供了ContentProvider，ContentProvider是不同应用程序之间进行数据交换的标准API，当一个应用程序需要把自己的数据暴露给其它程序使用时，该应用程序就可通过提供ContentProvider来实现，其它应用程序就可以通过ContentResolver来操作ContentProvider暴露的数据。
ContentProvider也是android应用的四大组件之一，与Activity、Service、BroadcaseReceiver相似，他们都需要再AndroidManifest.xml文件中进行配置。
一旦某个应用程序通过ContentProvider暴露了自己的数据操作接口，那么不管该应用程序是否启动，其它应用程序都可通过该接口来操作该应用程序的内部数据，包括增加数据、删除数据、修改数据、查询数据。
9.1数据共享标准：ContentProvider简介
ContentProvider是不同应用程序之间进行数据交换的标准API，ContentProvider以某种Uri的形式对外提供数据，允许其他应用程序访问或修改数据；其他应用程序使用ContentResolver根据Uri去访问操作指定数据。
9.1.1ContentProvider简介
如果把ContentProvider当成一个“网站”来看，那么如何对外提供数据呢：步骤如下
-》定义自己的ContentProvider类，该类需要继承android提供的ContentProvider基类。
-》向android系统注册一个“网站”，也就是在AndroidManifest.xml文件中注册这个ContentProvider，就像注册Activity一样。注册ContentProvider时需要为它绑定一个URL。

向android系统中注册ContentProvider只要在<application.../>元素下添加如下子元素即可。
<provider android:name=”.DictProvider”
android:authorities=”org.crazyit.providers.dictprovider”
/>
当我们向android系统注册了ContentProvider网站之后，其它应用程序就可通过该Uri来访问DictProvider所暴露的数据了。
那么DictProvider到底如何暴露他所通过的数据呢，其实很简单，应用程序对数据的操作无非就是CRUD操作，因此DictProvider除了需要继承ContentProvider之外，还需提供如下：
-》public boolean onCreate（）：该方法在ContentProvider创建后会被调用，当其它应用程序第一次访问ContentProvider时，该ContentProvider会被创建出来，并立即回调onCreate（）。
-》public Uri insert（Uri uri，ContentValues values）：根据该Uri插入values对应的数据。
-》public int delete（Uri uri，String selection，String[] selectionArgs）：根据Uri删除selection条件所匹配的全部记录。
-》public int update（Uri uri，ContentValues values，String selection，String[] selectionArgs）：根据Uri修改select条件所匹配的全部记录
-》public Cursor query（Uri uri，String[] projection，String selection，String[] selectionArgs，String sortOrder）：根据Uri查询出select条件所匹配的全部记录，其中projection就是一个列名列表，表明只选择出指定的数据列。
-》public String getType（Uri uri）：该方法用于返回当前Uri所代表的数据的MIME类型。如果该Uri对应数据可能包括多条记录，那么MIME类型字符串应该以vnd.android.cursor.dir/开头；如果该Uri对应的数据只包括一一条记录，那么返回MIME类型字符串应该以vnd.android.cursor.item/开头
9.1.2Uri简介
在介绍android系统的Uri之前，先看一个最常用的互联网URL，例如想访问疯狂Java联盟的某个页面，应该在浏览器中输入URL：
http：//www.crazyit.org/ethos.php
对于上面的URL，可分为如下三个部分：
-》http：//：URL的协议部分，只是通过HTTP协议来访问网站，这个部分是固定的
-》www.crazyit.org：网站域名部分。只是访问指定的网站，这个部分总是固定的。
-》ethos.php：网站资源部分。当访问需要访问不同资源时，这个部分是动态改变的。

Android的Uri与此类似，例如：
Content：//org.crazyit.providers.dictprovider/words
它也可分为三个部分：
-》Content：//：这个部分是android所规定的，是固定的。
-》org.crazyit.providers.dictprovider：这个部分就是ContentProvider的authority。系统就是由这个部分找到操作那个ContentProvider。只要访问指定的ContentProvider个部分总是固定的
-》words：资源部分（或者说数据部分），当访问需要访问不同资源时，这个部分是动态改变的。
需要指出的是，android的Uri所能表达的功能更丰富，它还可以支持如下Uri：
-》Content：//org.crazyit.providers.dictprovider/words/2
此时他要访问的资源为words/2，这意味著words数据中ID为2的记录。
还有如下形式：
-》Content：//org.crazyit.providers.dictprovider/words/2/word
此时他要访问的资源为words/2，这意味著words数据中ID为2的记录的word字段。
如果想访问全部数据，即可使用上面所示的形式：
-》Content：//org.crazyit.providers.dictprovider/word
虽然大部分使用ContentProvider所操作的数据都来自数据库，但有时候这些数据也可来自于文件、XML或网络等其他存储方式，此时支持的Uri可以改为如下形式：
-》Content：//org.crazyit.providers.dictprovider/word/detail/
上面的Uri表示操作work结点下的detail结点
为了将一个字符串转换成Uri，android提供的Uri工具类提供了parse（）静态方法，例如：
Uri uri=Uri.parse(“Content：//org.crazyit.providers.dictprovider/words/2”)

2013年1月28日13:12:48
9.1.3使用ContentResolver操作数据
前面已经提到，ContentResolver相当于一个“网站”，它的作用是暴露可供操作的数据：其它应用程序则通过ContentResolver来操作ContentResolver所暴露的数据，ContentResolver相当于HttpClient。
Content提供了如下方法来获取ContentResolver对象：
-》getContentResolver（）；
一旦在程序中获得ContentResolver对象之后，接下来就可调用ContentResolver的如下方法来操作数据：
-》insert（Uri uri，ContentValues values）：向Uri对应的ContentResolver中插入values对应的数据。
-》delete（Uri uri，String where，String[] selectionArgs）：删除Uri对应的ContentResolver中where提交匹配的数据。
-》update（Uri uri，ContentValues values，String where，String[] selectionArgs）：更新Uri对应的ContentResolver中where提交匹配的数据。
-》query（Uri uri，String[] projection，String selection，String[] selectionArgs，String sortOrder）：查询Uri对应的ContentResolver中where提交匹配的数据。

一般来说，ContentResolver是单实例模式，当多个应用程序通过ContentResolver来操作ContentResolver提供的数据时，ContentResolver调用的数据操作将会委托给同一ContentResolver处理。

9.2操作系统的ContentResolver
在介绍ContentResolver开发之前，先介绍如何通过ContentResolver操作ContentResolver所暴露的数据。即使我们还未开发自己的ContentResolver，但android系统的应用已经提供了大量的ContentResolver，允许开发者来操作这些ContentResolver所暴露的数据。
使用ContentResolver操作数据的两步骤：
-》调用Activity的ContentResolver（）获取ContentResolver对象。
-》根据需要调用ContentResolver 的insert（）、delete（）、update（）和query（）方法操作数据即可。

为了操作系统提供的ContentResolver，只要了解该ContentResolver的uri即可。

9.2.1使用ContentResolver管理联系人
Android系统提供了Contacts应用程序来管理联系人，而且android系统还为联系人管理提供了ContentResolver，这就允许其他应用程序以ContentResolver来管理联系人。
Android系统对联系人管理ContentResolver的几个Uri如下：
-》ContactsContract.Contacts.CONTENT_URI：管理联系人的Uri。
-》ContactsContract.CommonDataKinds.Phone.CONTENT_URI：管理联系人的电话的Uri
-》ContactsContract.CommonDataKinds.EmailCONTENT_URI：管理联系人的E-mail的Uri
知道联系人管理的ContentResolver的Uri之后，接下来就可在应用程序中通过ContentResolver去操作系统的联系人数据。

实例：查询系统的联系人以及添加联系人（9.2.1）
读联系人权限：
<uses-permission android:name="android.permission.READ_CONTACTS"/>
写联系人权限：
<uses-permission android:name="android.permission.WRITE_CONTACTS"/>

9.2.2使用ContentResolver管理多媒体内容
Android提供了Camera程序来支持拍照、拍摄视频，用户拍摄的照片、视频都将存放在固定的位置。有时，其它应用程序可能需要直接访问Camera所拍摄的照片、视频，为了处理这种需求，android同样为这些多媒体提供了ContentResolver。
Android为多媒体提供的ContentResolver的Uri如下：
-》MediaStore.Audio.Media.EXTERNAL_CONTENT_URI：存储在外部存储器上的视频文件内容的ContentResolver的Uri。
-》MediaStore.Audio.Media.INTERNAL_CONTENT_URI：存储在手机内部存储器上的音频文件内容的ContentResolver的Uri。
-》MediaStore.Audio.Images.EXTERNAL_CONTENT_URI：存储在外部存储器上的图片文件内容的ContentResolver的Uri。
-》MediaStore.Audio.Images.INTERNAL_CONTENT_URI：存储在手机内部存储器上的图片文件内容的ContentResolver的Uri。
-》MediaStore.Audio.Video.EXTERNAL_CONTENT_URI：存储在外部存储器上的音频文件内容的ContentResolver的Uri。
-》MediaStore.Audio.Video.INTERNAL_CONTENT_URI：存储在手机内部存储器上的音频文件内容的ContentResolver的Uri。

实例：查看多媒体数据中的所有图片以及向多媒体数据中添加图片（9.2.2）

9.3实现ContentProvider
前面介绍的只是如何使用ContentResolver来操作系统Contentprovider提供的数据，下面就会介绍如何开发自己的ContentProvider。
9.3.1创建ContentProvider的步骤：

-》开发一个ContentProvider的子类，该子类需要实现增删改查等方法
-》在AndroidManifest.xml文件中注册该ContentProvider

开发ContentProvider时所实现的增删改查方法都需要一个Uri参数，该参数决定对哪个Uri执行数据操作。
为了确定该ContentProvider实现能匹配的Uri，以及确定每一个方法中Uri参数所操作的数据，android系统提供了UriMatcher工具类。
Uri工具类主要提供了如下两个方法：
-》void addURI（String authority，String path，int code）：该方法用于向UriMatcher对象注册Uri，其中authority和path组合成一Uri，而code则代表该Uri对象的表示码
-》int match（Uri uri）：根据前面注册的Uri来判断指定Uri对应的标识码。如果找不到匹配的标识码，该方法将会返回-1.。
例如我们先通过如下代码啦创建UriMatches对象：
UriMatcher matcher=new UriMatcher（UriMatcher.NO_MATCH）；
matcher.addURI（“org.crazyit.providers.dictprovider”，“words”，1）；
matcher.addURI（“org.crazyit.providers.dictprovider”，“word/#”，2）；

上面创建的UriMatcher对象注册了两个Uri，其中org.crazyit.providers.dictprovider/words对应的标识码为1；org.crazyit.providers.dictprovider/word/#对应的表示为2，其中#为通配符。
这就意味着，如下匹配结果：
Matcher.match(Uri.parse(“content：//org.crazyit.providers.dictprovider/words”))；//返回标识码1
Matcher.match(Uri.parse(“content：//org.crazyit.providers.dictprovider/word/2”))；//返回标识码2
Matcher.match(Uri.parse(“content：//org.crazyit.providers.dictprovider/word/10”))；//返回标识码2

至于到底要为UriMatcher对象注册多少个Uri，这取决于系统的业务需求
除此之外，android还提供了一个ContentUri工具类，它是一个操作Uri字符串的工具类，它提供了如下方法：
withAppendedId（uri，id）：用于为路径加上ID部分。例如：
Uri uri=Uri.parse（“content：//org.crazyit.providers.dictprovider/word”）；
Uri resultUri=ContentUris.withAppendedId（uri，2）；
//生成后的Uri为：content：//org.crazyit.providers.dictprovider/word/2
parseId（）：用于从指定Uri中解析出所包含的ID值：例如：
Uri uri=Uri.parse（“content：//org.crazyit.providers.dictprovider/word/2
”）；
Long wordId=ContentUris.parseId（uri）；

实例：使用ContentProvider共享生词本数据（9.3.1）结合（8.3.2）一起操作

2013年1月28日22:46:23
监听ContentProvider的数据改变
前面介绍的是当ContentProvider将数据共享出来之后，ContentResolver会根据业务需要去主动查询ContentProvider所共享数据；在有些时候，应用程序需要实时监听ContentProvider所共享数据的改变，并随着ContentProvider的数据的改变而提供响应，这就需要利用ContentObserver了。

9.4.1ContentObserver简介
前面介绍开发ContentProvider时，不管实现insert、delete、update方法中的哪一个，只要该方法导致了ContentProvider里数据的改变，程序就调用了如下代码：
-》getContext().getContentResolver().notifyChange(Uri, null);
这行代码可用于通知所有注册在该Uri上的监听者：该ContentProvider所共享的数据发生改变。
改变在应用程序中监听ContentProvider数据的改变，需要利用android提供ContentObserve基类。
监听ContentProvider数据改变的监听器需要继承ContentObserver类，并重写该基类所定义的，onChange（boolean selfChange）方法——当它所监听的ContentProvider的数据发生改变时，该onChange将会被触发。
为了监听指定ContentProvider的数据变化，需要通过ContentResolver向指定Uri注册ContentObserver监听器。ContentResolver提供了如下方法来注册监听器。
-》registerContentObserver（Uri uri，boolean notifyForDescendents，ContentObserver observer）。
该方法中三个参数的说明：
-》uri：该监听器所监听的ContentProvider的Uri。
-》notifyForDescendents：如果该参数设为true，假如注册监听的Uri为content：//abc，那么Uri为content：//abc/xyz、content：//abc/xyz/foo的数据改变时也会触发该监听器；如果该参数设为false，假如注册监听听的Uri为content：//abc，那么只有content：//abc的数据发生改变时触发该监听器。
-》observer：监听器实例。
例如如下代码片段可用于为指定Uri注册监听器：
getContentResolver().registerContentObserver(Uri.parse(“content://sms”),true,new SmsObserver(new Handler));

实例：监听用户发出的短信（9.4.1）略