ContentProvider 是 Android 的四大组件之一,用于保存和检索数据,是 Android 系统中不同应用程序之间共享数据的接口。
在 Android 系统中,应用程序之间是相互独立的,分别运行在自己的进程中,相互之间没有数据交换。若应用程序之间需要共享数据,就要用到 ContentProvider。
在 Android 系统的手机中,ContentProvider 最典型的应用是,当发送一条短信时,需要用到联系人的相关信息,此时就是通过 ContentProvider 提供的接口访问 Android 系统中的电话簿,并从中选择联系人。
ContentProvider 提供了一组应用程序之间能相互访问的接口。应用程序通过 ContentProvider 把当前应用中的数据共享给其他应用程序访问,而其他应用程序通过 ContentProvider 对指定应用中的数据进行访问和操作。
Android 系统对一系列常见的公用数据类型提供了对应的 ContentProvider 接口,例如视频、音频、图像、个人通信信息等,都定义在 android.provider 包下。
若应用程序开发者想将自己的数据公开给其他应用程序使用,有两种方法:
ContentProvider 中的数据在形式上和关系数据库中的表格很相似。
以 Android 系统内建的用户常用词典所对应的 ContentProvider 为例,Android 系统为其定义的名字为 android.provider.UserDictionary,该用户词典中的 Word 表格记录了特定用户经常使用的不规则单次的相关信息。其数据格式如下表所示。
word | appId | frequency | locale | _ID |
---|---|---|---|---|
manpreduce | user1 | 100 | en_US | 1 |
precompiler | user14 | 200 | fr_FR | 2 |
applet | user2 | 225 | fr_CA | 3 |
const | user1 | 255 | pt_BR | 4 |
int | user5 | 100 | en_UK | 5 |
表头部分存储在 ContentProvider 中,表格的每一行是该词典数据的一个实例,也就是一个非标准的单词,每一列是和该单词相关的一些信息,例如该单词的拼写、使用者的 id、使用频率等,_ID 起到了主键的作用。
应用程序通过 ContentResolver 的对象访问 ContentProvider 中的数据,该对象提供了对持久层数据的 CRUD 方法。
每个 Activity 都有一个 ContentResolver 对象,要获取该对象,可以使用 Activity 提供的 getContentResolver() 方法。
当然,应用程序要使用其他应用程序提供的 ContentProvider,需要拥有进行操作的相应权限。所有用户词典数据的代码为:
其所对应的权限为:android.permission.READ_USER_DICTIONARY,因此必须在应用程序的 AndroidManifest.xml 文件中添加:
UserDictionary.Words.CONTENT_URI 指的是用户词典中 words 表的内容 URI。
ContentProvider 通过 URI 来共享数据。URI 是一个通用资源标志符,可将其分为 A、B、C、D 共 4 部分。
在本实例中,UserDictionary.Words.CONTENT_URI 包含所要访问 ContentProvider 的标识和具体信息表的路径。
其所代表的完整的字符串是“content://user_dictionary/words”,其中“content://”是前置格式字符串,即 A 部分;“user_dictionary”指定了提供数据的 ContentProvider,即 B 部分;“words”指定了要访问的数据表,即 C 部分。
此外,ContentProvider 允许通过在 URI 后面添加 ID 值的方式访问数据表中某一列数据,即添加 D 部分。例如,访问用户词典 words 表中 _ID=2 的数据的 URI 可以这样表示:
其对应的完整 URI 为:“content://user_dictionary/words/2”。
ContentProvider 定义在 android.content 包下面,是一个抽象类。定义一个 Content Provider 必须实现下面几个抽象方法。
方法名称 | 作用 |
---|---|
onCreate() | 用于在启动时初始化 ContentProvider。由于该方法会在应用程序的主线程启动时被调用,因此不应该执行耗时的操作,以免延迟应用程序的启动时间。执行成功返回 true,失败返回 false。 |
query(Uri,String[],String,String[],String) | 用于对 Uri 指定的 ContentProvider 进行查询,返回一个 Cursor 对象。 |
insert(Uri, ContentValues) | 用于添加数据到 Uri 指定的 ContentProvider 中。 |
update(Uri, ContentValues, String, String[]) | 用于更新 Uri 指定的 ContentProvider 中的数据。 |
delete(Uri, String, String[]) | 用于从 Uri 指定的 ContentProvider 中删除数据。 |
getType(Uri) | 用于返回 Uri 指定的 ContentProvider 中的数据的 MIME 类型。 |
ContentResolver 提供的方法和 ContentProvider 提供的方法相对应,主要有以下几个方法。
方法名称 | 作用 |
---|---|
query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) |
用于对 Uri 指定的 ContentProvider 进行查询。 |
insert(Uri uri, ContentValues values) | 用于添加数据到 Uri 指定的 ContentProvider 中。 |
delete(Uri uri, String selection, String[] selectionArgs) | 用于从 Uri 指定的 ContentProvider 中删除数据。 |
update(Uri uri, ContentValues values, String selection, String[] selectionArgs) | 用于更新 Uri 指定的 ContentProvider 中的数据。 |
在对某特定 ContentProvider 的 CRUD 操作中,通过 ContentResolver 提供的 CRUD 方法将相关信息传递给 ContentProvider,所提供的 CRUD 方法进而对数据进行操作。
因此,在定义自己的 ContentProvider 时,应该定义好该 ContentProvider 对数据进行 CRUD 操作时所使用的方法。
Android 系统提供了 UriMatcher 类用于对 URI 的匹配。
使用步骤为:
1)创建 UriMatcher 类对象。
2)通过 UriMatcher.addURI(String,String,int) 方法对其增加需要匹配的 URI 路径,所对应的匹配码由第三个参数指定。
3)通过 UriMatcher.match(Uri) 方法进行匹配,并返回匹配码。
其代码如下:
UriMatcher uriMatcher=new UriMatcher (UriMatcher.NO_MATCH) ;
//构建UriMatcher对象,常量UriMatcher .NO_MATCH表示不匹配任何路径,返回码-1
//添加需要匹配的URI,并指定匹配时返回的匹配码
UriMatcher.addURI ("introdcuton.android.myprovider", "text", 1) ;
//荣国match()方法匹配content://introdcuton .android.myprovider/text/230
//路径,对应匹配码为2
uriMatcher.addURI ("introdcuton.android.myprovider", "text/#", 2) ;
//#号为通配符,如果match()方法匹配content://introdcuton.android.myprovider/text/230
//路径,对应匹配码为2
Uri uri=Uri.parse ("content://introdcuton.android.myprovider/text/10") ;
switch (uriMatcher.match (uri)) {
case 1: //匹配操作码为1
//执行相应操作
break;
case 2: //匹配返回码为2
//执行相应的操作
break;
default: //不匹配
//执行相应的操作
break;
}
上述代码中,uriMatcher.addURI("introdcuton.android.myprovider","text/#",2) 中“#”为通配符,代表任意数字,还可以使用通配符“*”来代表任意文本。这句话表示,若传入的 URI 能够匹配“content://introdcuton.android.myprovider/text/ 数字”格式,则返回匹配码 2。