Android ContentProvider详解

Android提供了5种方式来让用户保存持久化应用程序数据。根据自己的需求来做选择,比如数据是否是应用程序私有的,是否能被其他程序访问,需要多少数据存储空间等,分别是:

  1. 使用SharedPreferences存储数据
  2. 文件存储数据
  3. SQLite数据库存储数据
  4. 使用ContentProvider存储数据
  5. 网络存储数据

咱们今天就来学习一下ContentProvider。作为Android四大巨头之一的他有点名不副实,因为在一般的开发过程中,使用的次数比较少。大部分应用的数据缓存用SharedPreferences就能搞定了。

ContentProvider(数据提供者)是应用程序之间共享数据的一种接口机制,是一种更为高级的数据共享方法。

ContentProvider可以指定需要共享的数据,而其他应用程序则可以在不知道数据来源、路径的情况下,对共享数据进行增删改查等操作。

在Android系统中,许多Android系统内置的数据也是通过ContentProvider提供给用户使用,例如通讯录、音视频文件和图像文件等。


image

什么是ContentProvider

  • ContentProvider是Android的四大组件之一,以标准化的方式在Android 应用间共享数据。
  • ContentProvider封装的数据存储以及增删改查等,并且必须实现一个对外统一的接口(Uri)。

什么是Uri

Uri(通用资源标识符 Universal Resource Identifer),代表数据操作的地址,每一个ContentProvider都会有唯一的地址。

ContentProvider使用的Uri语法结构如下:

content://authority/data_path/id
  • content:// 是通用前缀,表示该Uri用于ContentProvider定位资源。
  • authority 是授权者名称,用来确定具体由哪一个ContentProvider提供资源。因此一般authority都由类的小写全称组成,以保证唯一性。
  • data_path 是数据路径,用来确定请求的是哪个数据集。
  • id 是数据编号,用来请求单条数据。如果是多条这个字段忽略。

样例:

content://com.scc.userprovider/user多条
content://com.scc.userprovider/user/10单条

什么是ContentResolver

  • ContentResolver是数据调用者,ContentProvider将数据发布出来,通过ContentResolver对象结合Uri进行调用。
  • 一般来说ContentProvider是单例模式,多个应用可通过ContentResolver调用ContentProvider的增删改查操作数据,ContentResolver调用的数据操作会让同一个ContentProvider处理。
image

创建ContentProvider

  1. 创建一个类让其继承ContentProvider,并重载6个函数


    image

需要实现的主要方法是:

  • insert()delete()update()query():用于对数据集的增删改查操作。
  • onCreate():一般用来初始化底层数据集和建立数据连接等工作
  • getType():用来返回指定Uri的MIME数据类型,
    • 若Uri是单条数据,则返回的MIME数据类型以vnd.Android.cursor.item开头;
    • 若Uri是多条数据,则返回的MIME数据类型以vnd.android.cursor.dir/开头。

数据访问方法如insert(Uri,ContentValues)和update(Uri,ContentValues,Bundle) 可以同时从多个线程调用,并且必须是线程安全的。其他方法如onCreate() 仅从应用程序主线程调用,并且必须避免执行冗长的操作。请参阅其预期线程行为的方法描述。

  1. 声明Uri规则,实现UriMatcher

咱先来看看UriMatcher是干嘛的,UriMatcher本质上是一个文本过滤器,有助于解析Uri,用在ContentProvider中帮助我们过滤,分辨出查询者想要查询哪个数据表。

UriMatcher的构造函数中,UriMatcher.NO_MATCH是Uri无匹配时的返回代码,值为-1。addUri()方法用来添加新的匹配项,语法为:

public void addUri(String authority, String path, int code)
  • authority表示匹配的授权者名称;
  • path表示数据路径;
  • code表示返回代码。

下面咱搞个实例:

//这里的名称必须与AndroidManifest.xml中android:authorities保持一致
public static final String AUTHORITY = "com.scc.userprovider";
//数据路径
public static final String PATH_USERS = "user";
//访问ContentProvider的URL
public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/" + PATH_USERS);
//返回代码
public static final int USER_INFO = 1;
//创建UriMatcher对象
private static UriMatcher uriMatcher;
//创建静态代码块
static {
    //实例化UriMatcher对象
    uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
    //参数1:authority;参数2:路径;参数3:自定义代码
    uriMatcher.addURI(UserInfoContent.AUTHORITY, UserInfoContent.PATH_USERS, USER_INFO);
}
  1. 注册ContentProvider

在AndroidManifest.xml文件中的 application节点下使用标签注册。样例:

<!--
android:name指定ContentProvider实现的类名
android:authorities指定ContentProvider对应Uri(相当于ContentProvider分配一个域名)
android:exported指定ContentProvider是否允许其他应用调用。
如果将该属性设置为true,则允许其他应用调用-->
<android:authorities="com.scc.userprovider"
    android:name=".UserProvider"
    android:exported="true"/>

使用ContentProvider

  1. 通过insert()方法添加单条数据
ContentValues cv = new ContentValues();
cv.put(UserInfoContent._ID, bean.get_id());
cv.put(UserInfoContent.USER_NAME, bean.getName());
cv.put(UserInfoContent.USER_AGE, bean.getAge());
cv.put(UserInfoContent.USER_UPDATE_TIME, bean.getUpdate_time());
Uri uri = getContentResolver().insert(UserInfoContent.CONTENT_URI, cv);
Log.e(getClass().getName(), "insert:" + uri);
  • 通过bulkInsert()方法添加多条数据
ContentValues[] arrayValues = new ContentValues[10];
//实例化每一个ContentValues...
int count = getContentResolver().bulkInsert(UserInfoContent.CONTENT_URI, arrayValues);
image
  1. 指定ID删除单条数据
int delete = getContentResolver().delete(UserInfoContent.CONTENT_URI, "_id=12", null);
Log.e(getClass().getName(), "delete(失败返回-1):" + delete);
  • 通过selection语句删除多条数据
String selection = UserInfoContent._ID + ">12";
int result = getContentResolver().delete(UserInfoContent.CONTENT_URI, selection, null);
image
  1. 修改数据
UserInfoBean bean = new UserInfoBean("蚩尤", 32, "12:00");
ContentValues cv = new ContentValues();
cv.put(UserInfoContent.USER_NAME, bean.getName());
cv.put(UserInfoContent.USER_AGE, bean.getAge());
cv.put(UserInfoContent.USER_UPDATE_TIME, bean.getUpdate_time());
getContentResolver().update(UserInfoContent.CONTENT_URI, cv, "_id=18", null);
image
  1. 查询数据
Cursor cursor = getContentResolver().query(UserInfoContent.CONTENT_URI, null, selection, null, null);
//循环取出游标指向的每条用户记录
while (cursor.moveToNext()) {
    UserInfoBean user = new UserInfoBean();
    user.name = cursor.getString(cursor.getColumnIndex(UserInfoContent.USER_NAME));
    user.age = cursor.getInt(cursor.getColumnIndex(UserInfoContent.USER_AGE));
    user._id = cursor.getString(cursor.getColumnIndex(UserInfoContent._ID));
    user.update_time = cursor.getString(cursor.getColumnIndex(UserInfoContent.USER_UPDATE_TIME));
    userList.add(user); //添加到用户信息列表
}
cursor.close(); //关闭数据库游标
Log.e(getClass().getName(), "Query用户:" + String.format("当前共找到%d个用户", userList.size()));
image

跨应用使用ContentProvider

跨应用和本应用使用ContentProvider一样的方法,这边就不做复制了。

例5的Uri是拼接字段,但是拼接后的结果
content://com.scc.userprovider/user

跨平台使用getContentResolver().方法 的第一个参数:

Uri uricontent = Uri.parse("content://com.scc.userprovider/user");

ContentValues cv = new ContentValues();
cv.put(UserInfoContent._ID, bean.get_id());
cv.put(UserInfoContent.USER_NAME, bean.getName());
cv.put(UserInfoContent.USER_AGE, bean.getAge());
cv.put(UserInfoContent.USER_UPDATE_TIME, bean.getUpdate_time());
Uri uri = getContentResolver().insert(uricontent, cv);
Log.e(getClass().getName(), "insert:" + uri);
  1. 新增数据+查找数据


    image
  2. 修改数据+删除数据


    image

java.lang.SecurityException: Permission Denial: opening provider com.scc.cp.UserProvider from ProcessRecord

解决方案:

在AndroidManifest.xml文件中的 application节点下使用<provider>标签注册时android:exported="false"时,不允许其他应用调用。所以其他和应用使用ContentProvider会崩溃报错。将exported改为:android:exported="true"即可。

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

推荐阅读更多精彩内容