创建 Stub Content Provider

原文:http://developer.android.com/training/sync-adapters/creating-stub-provider.html

Sync Adapter 框架是设计成用来和设备数据一起工作的,而这些设备数据应该被灵活且安全的 Content Provider 框架管理。因此,Sync Adapter 框架会期望应用已经为它的本地数据定义了 Content Provider。如果 Sync Adapter 框架尝试去运行我们的 Sync Adapter,而我们的应用没有一个 Content Provider 的话,那么 Sync Adapter 将会崩溃。

如果我们正在开发一个新的应用,它将数据从服务器传输到一台设备上,那么我们务必考虑将本地数据存储于 Content Provider 中。除了它对于 Sync Adapter 的重要性之外,Content Provider 还可以提供许多安全上的好处,更何况它是专门为了在 Android 设备上处理数据存储而设计的。要学习如何创建一个 Content Provider,可以阅读:Creating a Content Provider

然而,如果我们已经通过别的形式来存储本地数据,我们仍然可以使用 Sync Adapter 来处理数据传输。为了满足 Sync Adapter 框架对于 Content Provider 的要求,我们可以在应用中添加一个 Stub Content Provider。一个 Stub Content Provider 实现了 Content Provider 类,但是所有的方法都返回null或者0。如果我们添加了一个 Stub Content Provider,那么无论数据存储机制是什么,我们都可以使用 Sync Adapter 来传输数据。

如果在我们的应用中已经有了一个 Content Provider,那么我们就不需要创建 Stub Content Provider 了。在这种情况下,我们可以略过这节课程,直接进入:创建 Sync Adapter。如果你还没有创建 Content Provider,这节课将向你展示如何通过添加一个 Stub Content Provider,将你的 Sync Adapter 添加到框架中。

添加一个 Stub Content Provider

要为我们的应用创建一个 Stub Content Provider,首先继承ContentProvider类,并且在所有需要重写的方法中,我们一律不进行任何处理而是直接返回。下面的代码片段展示了我们应该如何创建一个 Stub Content Provider:

/*

* Define an implementation of ContentProvider that stubs out

* all methods

*/publicclassStubProviderextendsContentProvider{/*

* Always return true, indicating that the

* provider loaded correctly.

*/@OverridepublicbooleanonCreate(){returntrue;    }/*

* Return an empty String for MIME type

*/@OverridepublicStringgetType(){returnnewString();    }/*

* query() always returns no results

*

*/@OverridepublicCursorquery(

Uri uri,

String[] projection,

String selection,

String[] selectionArgs,

String sortOrder){returnnull;    }/*

* insert() always returns null (no URI)

*/@OverridepublicUriinsert(Uri uri, ContentValues values){returnnull;    }/*

* delete() always returns "no rows affected" (0)

*/@Overridepublicintdelete(Uri uri, String selection, String[] selectionArgs){return0;    }/*

* update() always returns "no rows affected" (0)

*/publicintupdate(

Uri uri,

ContentValues values,

String selection,

String[] selectionArgs){return0;    }}

在 Manifest 清单文件中声明 Provider

Sync Adapter 框架会通过查看应用的 manifest 文件中是否声明了 provider,来验证我们的应用是否使用了 Content Provider。为了在 manifest 清单文件中声明我们的 Stub Content Provider,添加一个标签,并让它拥有下列属性字段:

android:name="com.example.android.datasync.provider.StubProvider"

指定实现 Stub Content Provider 类的完整包名。

android:authorities="com.example.android.datasync.provider"

指定 Stub Content Provider 的 URI Authority。用应用的包名加上字符串".provider"作为该属性字段的值。虽然我们在这里向系统声明了 Stub Content Provider,但是不会尝试访问 Provider 本身。

android:exported="false"

确定其它应用是否可以访问 Content Provider。对于 Stub Content Provider 而言,由于没有让其它应用访问该 Provider 的必要,所以我们将该值设置为false。该值并不会影响 Sync Adapter 框架和 Content Provider 之间的交互。

android:syncable="true"

该标识指明 Provider 是可同步的。如果将这个值设置为true,那么将不需要在代码中调用setIsSyncable()。这一标识将会允许 Sync Adapter 框架和 Content Provider 进行数据传输,但是仅仅在我们显式地执行相关调用时,这一传输时才会进行。

下面的代码片段展示了我们应该如何将标签添加到应用的 manifest 清单文件中:

......

现在我们已经创建了所有 Sync Adapter 框架所需要的依赖项,接下来我们可以创建封装数据传输代码的组件了。该组件就叫做 Sync Adapter。在下节课中,我们将会展示如何将这一组件添加到应用中。

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

推荐阅读更多精彩内容