ContentProvider基础

0x00 前言

这篇关于 ContentProvider 的总结文章,早在四月份就想写了,但是一直没有时间和精力去写,而且我也不想随便写一下,还是希望能保证一定的文章质量。恰巧昨天为自己定了一个目标,就是每周学习一个主题,并输出相关总结文章或例程。所以,第一周的主题就定为ContentProvider。下面看下本文会涉及到的几点内容:

  1. 什么是 ContentProvider;
  2. 使用 ContentProvider 的优点;
  3. 一个使用系统 ContentProvider 的例程。

0x01 ContentProvider简介

关于 ContentProvider,搞 Android 的人都不会陌生,它是 Andriod 中的四大组件之一,但或许是存在感最低的一个组件。为什么这么说呢?因为一般来说我们开发应用很少会去自定义这种组件,但是其实它非常重要和有用。我们先来看下它的作用:

一看到它的名字——内容提供者,就能大概猜到它与数据是相关的,它的作用就是实现数据共享,这个共享不仅仅限于本应用内部,还包括系统中的其他应用(即跨进程的数据共享)。为此,它实现了一套标准的接口方法用于存取(增、删、改、查,这些操作其实和标准的 SQL 操作是类似的)它管理的数据,而底层的数据如何存储(存储于文件系统或者 SQLite 数据库等),调用者根本不用去关心:

// 查询记录
Cursor query (Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)

// 插入记录
Uri insert (Uri uri, ContentValues values)

// 更新记录
int update (Uri uri, ContentValues values, String selection, String[] selectionArgs)

// 删除记录            
int delete (Uri uri, String selection, String[] selectionArgs)

虽然 ContentProvider 定义了一系列的方法,但是我们的应用并不直接调用这些方法,而是使用一个ContentResolver对象,通过调用它的方法(与 ContentProvider 中的方法一一对应)作为替代,如图1所示。


ContentResolver.png

图 1:图片来自 Udacity 学院课程截图

说到这里大家肯定会奇怪,ContentResolver 是如何定位到我们想要的那个的ContentProvider 的呢?你要知道Android系统已经为我们提供了很多的 ContentProvider,例如日历联系人、多媒体(音频、视频以及图像)等数据。

其实,答案就是各个方法参数中的 Uri,就像你在浏览器的地址栏中输入一个网址 (URL),按下回车后,浏览器就会向服务器发起请求,而对应的服务器会返回相应的结果给浏览器。类似地,当ContentResolver也是通过一个给定的 URI (UR L是 URI 的一个子集)发起请求,Android 系统会根据给定URI中的authority(URI 的组成部分找到那个 ContentProvider ,并将该请求传递给该 ContentProvider。每个 ContentProvider 的 authority 都是唯一的,而且都会在 Android 系统注册。ContentProvider 收到请求后,会解析 URI 剩余的部分(通过辅助类UriMatcher实现),然后返回相应数据。

通过以上内容,我想大家对 ContentProvider 应该有了一个大概的了解了吧,下面我将通过用户词典(user dictionary:用于存储一些用户想保存的非标准单词的拼写)这个系统内置的 ContentProvider来向大家说明如何使用它。

0x02 如何使用 ContentProvider

我们要知道 ContentProvider 提供的数据的形式与一般关系型的数据库是一样的,都是通过一张或多张的数据库表来实现的,例如用户词典的数据表是这样的,其中每一行代码一个单词实例,每一列代表每个单词的属性:

表1:用户词典数据表样例引用

word app id frequency locale _ID
mapreduce user12 100 en_US 1
applet user2 200 pt_BR 2
const user1 255 en_UK 3

上面这个表跟我们平时操作的数据表没有什么区别嘛,说下本节我们要实现的功能就是通过一个ListView来显示表1中的数据,就这么简单,具体步骤如下:

(1) 获取相应 ContentProvider 的权限

Android 系统中内置了很多的 ContentProvider,当我们访问它们时,需要在AndroidManifest.xml文件中声明相应的读/写权限,如果你声明了写权限,应该不需要再申请读权限,用户词典的具体权限声明如下所示:

<uses-permission android:name="android.permission.READ_USER_DICTIONARY"/>
<uses-permission android:name="android.permission.WRITE_USER_DICTIONARY" />

(2) 访问正确的 ContentProvider

如前面所述,我们的应用不会直接访问 ContentProvider,我们需要通过 ContentResolver 以及正确的 URI,如图2所示,同时调用相应的方法:
queryinsertupdatedelete


query.png

图 2:图片来自 Udacity 学院课程截图

我们这个例子只是简单地查询数据,具体示例代码如下所示:

// 获取 ContentResolver 用于向 ContentProvider 发送数据请求
ContentResolver resolver = getContentResolver();
// 获取 Cursor,它包含了Words数据表的所有行
Cursor cursor = resolver.query(UserDictionary.Words.CONTENT_URI, // Uri
    null, // projection
    null, // selection
    null, // selectionArgs
    null  // sortOrder
);
Content URI

上述代码中query方法第一个参数UserDictionary.Words.CONTENT_URI,即之前我们提到的 URI,它一般由三部分组成content://authority/path,它用于标识 ContentProvider 中的数据记录,详细请参考Content URIs

(3) 在 UI 上展现数据

我们的目标是在 ListView 中显示这些单词,在第(2)个步骤得到的cursor其实就相当于一个数据源,所以只要实现相应的 Adapter 即可,具体代码如下所示:

// 使用系统提供的 SimpleCursorAdapter
SimpleCursorAdapter adapter = new SimpleCursorAdapter(this,
    android.R.layout.two_line_list_item,
    cursor,
    COLUMNS_TO_BE_BOUND,
    LAYOUT_ITEMS_TO_FILL,
    0
);

dictListView.setAdapter(adapter);

0x03 总结

根据以上这些的内容,我们稍微总结一下使用 ContentProvider 的两个优点:

  1. 底层的数据源对上层是透明的,可以非常方便地替换;
  2. 允许系统中的多个应用对同一个数据源进行(安全的)访问和修改,而相应的修改对于多个应用来说都是可见的。

看到这里我想很多人会想:如果我们并不想与其他应用共享我们的应用的数据,那么我们应该是不需要开发这种类型的组件。以前我也是这么想的,既然 ContentProvider 底层数据的存储还是通过 SQLite 数据库,为什么要用它呢?其实不然,首先我们使用 SQLite 数据库存储我们的数据,我们还是需要在 SQLite 数据库之上封装一层类似 ContentProvider 提供的那套接口方法;其次,我们还可以利用 Android 系统提供的一些相关功能类与 ContentProvider 配合起来使用。 例如,SyncAdaters, Loaders, CursorAdapter。说到这里我推荐大家一个视频吧,来自2010年 Google IO 大会,讲的是 Android 应用的设计模式(架构),其中一共提出了三种设计模式,而 ContentProvider 在其中扮演了非常重要的角色:

  1. Android REST client applications
  2. PPT下载地址

0x04 参考资料:

  1. Content Provider
  2. How to Use Content Provider
  3. ContentResolver
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,864评论 6 494
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,175评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,401评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,170评论 1 286
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,276评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,364评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,401评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,179评论 0 269
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,604评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,902评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,070评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,751评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,380评论 3 319
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,077评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,312评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,924评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,957评论 2 351

推荐阅读更多精彩内容