ContentProvider基本使用

ContentProvider(内容提供者)是 Android 的四大组件之一,管理 Android 以结构化方式存放的数据,以相对安全的方式封装数据(表)并且提供简易的处理机制和统一的访问接口供其他程序调用,注意:ContentProvider 的作用不是实现进程间通信,它只是为进程间通信提供了一套统一接口,真正实现进程间通信的是底层的 Binder 机制。
要实现与其他的 ContentProvider 通信首先要查找到对应的 ContentProvider 进行匹配。Android 中 ContenProvider 借助 ContentResolver 通过 Uri 与其他的 ContentProvider 进行匹配通信。

相关概念

1.URI
其它应用可以通过 ContentResolver 来访问 ContentProvider 提供的数据,而 ContentResolver 通过 uri 来定位自己要访问的数据,所以我们要先了解 URI。URI(Universal Resource Identifier)统一资源定位符,URI 为系统中的每一个资源赋予一个名字,比方说通话记录。每一个 ContentProvider 都拥有一个公共的 URI,用于表示 ContentProvider 所提供的数据。URI 遵循固定的格式,一共分为四个部分:schema://authority/path/id
1)标准前缀(scheme)——content://,用来说明一个Content Provider控制这些数据;
2)authority--标识 ContentProvider 的唯一字符串,对应于注册时指定的 android:authority 属性,一般是定义该 ContentProvider 的包.类的名称;
3)路径(path)——tablename,通俗的讲就是你要操作的数据库中表的名字,或者你也可以自己定义,记得在使用的时候保持一致就可以了;
4)记录ID(query)——id,如果URI中包含表示需要获取的记录的 ID,则返回该id对应的数据,如果没有ID,就表示返回全部;
2.MIME
MIME 是指定某个扩展名的文件用一种应用程序来打开,就像你用浏览器查看 PDF 格式的文件,浏览器会选择合适的应用来打开一样。Android 中的工作方式跟 HTTP 类似,ContentProvider 会根据 URI 来返回 MIME 类型,ContentProvider 会返回一个包含两部分的字符串。MIME 类型一般包含两部分,如:
1)标准类型:

声音:audio
视频:video
图像:image
文本:text
扩展名:
扩展名 MIME
.html text/html
.txt text/plain
.png image/png
.jpeg image/jpeg

2)自定义类型:
类型有两种形式:多条记录(集合)和单条记录。
1>集合记录(dir):
vnd.android.cursor.dir/自定义
2>单条记录(item):
vnd.android.cursor.item/自定义
vnd 表示这些类型和子类型具有非标准的、供应商特定的形式。Android中类型已经固定好了,不能更改,只能区别是集合还是单条具体记录,子类型可以按照格式自己填写。
在使用 Intent 时,会用到 MIME,根据 Mimetype 打开符合条件的活动。

主要方法

ContentProvider 是一个抽象类,如果我们需要开发自己的内容提供者我们就需要继承这个类并复写其方法,需要实现的主要方法如下:

public boolean onCreate():在创建 ContentProvider 时使用
public Cursor query():用于查询指定 uri 的数据返回一个 Cursor
public Uri insert():用于向指定uri的 ContentProvider 中添加数据
public int delete():用于删除指定 uri 的数据
public int update():用户更新指定 uri 的数据
public String getType():用于返回指定的 Uri 中的数据 MIME 类型
注:数据访问的方法 insert,delete 和 update 可能被多个线程同时调用,此时必须是线程安全的。

1)插入数据
要插入一行新数据,需要使用 ContentProvider#insert(...)。例如,下面程序将一条数据插入的contentprovider中:

eventValues.put(“ID”, 1); 
Uri resultUri = context.getContentResolver().insert(content://com.my.test/Test, eventValues);
if(null == resultUri) {
    // 插入失败
    return;
}

插入成功后会返回该行的 Uri,格式如下:

content://com.my.test/Test<id_value>

URI 中的 <id_value> 就是该行 _ID 列的值。需要注意的是,你不需要指定数据的 _ID列,该列是表的主键,ContentProvider 会自动维护该列并分配一个唯一值。而要从 Uri 中提取 _ID 列的值,可以调用
ContentUris.parseId(...):

MyTest.java
public static long parseId(Uri contentUri) {
    String last = contentUri.getLastPathSegment();
    return last == null ? -1 : Long.parseLong(last);
}

2)查询数据
首先要构建查询条件
ContentProvider 查询和 SQL 查询是相似的,如下表对比:

  • ContentProvider 查询 SQL 查询 作用
  • Uri FROM table_name 查询的数据集合
  • projection col,col,col... 查询结果所需的列
  • selectionClause WHERE col = value 选择条件
  • selectionArgs (没有确切地等效项) 选择条件参数(如果 selection )中使用了 ? 占位符
  • sortOrder ORDER BY col,col,... 结果集 Cursor 的排序规则
cursor = context .getContentResolver().query(
    UserDictionary.Words.CONTENT_URI,
    projection,
    selectionClause,
    selectionArgs,
    sortOrder);

查询结果是一个 Cursor 对象,处理范例如下:

if (null == mCursor) {
    // 失败
} else if (mCursor.getCount() < 1) {
    // 查询结果为空
} else {
    // 查询结果非空
    while (cursor.moveToNext()) {
        // 名称
        String name= cursor.getString(cursor.getColumnIndexOrThrow(“name”));
        ...
    }
    cursor.close(); // 关闭结果集
}

3)删除数据
删除数据与查询类似,需要构造查询条件,删除操作结束会返回成功删除的行数。

int rowsDeleted = context.getContentResolver().delete(...);

4)更新数据
更新操作类似于查询操作和插入操作的结合体,既需要构造 ContentValues 对象,也需要构造查询条件,删除操作结束后返回成功修改的行数。

int rowsUpdated = context.getContentResolver().update(
    UserDictionary.Words.CONTENT_URI, 
    updateValues,
    selectionClause,
    selectionArgs);

ContentProvider 核心类

1.UriMatcher
Uri 代表要操作的数据,在开发过程中对数据进行获取时需要解析 Uri,Android 提供了两个用于操作 Uri 的工具类,分别为 UriMatcher 和 ContentUris 。掌握它们的基本概念和使用方法,对一个 Android 开发者来说是一项必要的技能。
UriMatcher 类用于匹配 Uri,它的使用步骤如下:
将需要匹配的Uri路径进行注册,代码如下:

//常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码
UriMatcher  sMatcher = new UriMatcher(UriMatcher.NO_MATCH);
//如果match()方法匹配“content://com.my.test/Test”路径,返回匹配码为1
sMatcher.addURI("content://com.my.test.provider.myprovider", " Test", 1);
//如果match()方法匹配content://com.my.test.provider.myprovider/Test/1路径,返回匹配码为2
sMatcher.addURI("com.my.test.provider.myprovider", "Test/#", 2);

此处采用 addURI 注册了两个需要用到的 URI;注意,添加第二个 URI 时,路径后面的 id 采用了通配符形式 “#”,表示只要前面三个部分都匹配上了就 OK。
注册完需要匹配的 Uri 后,可以使用 sMatcher.match(Uri) 方法对输入的 Uri 进行匹配,如果匹配就返回对应的匹配码,匹配码为调用 addURI() 方法时传入的第三个参数。
2.ContentUris
ContentUris 类用于操作 Uri 路径后面的 ID 部分,它有两个比较实用的方法:withAppendedId(Uri uri, long id) 和 parseId(Uri uri)。

withAppendedId(Uri uri, long id) 用于为路径加上 ID 部分:

Uri uri = Uri.parse("content://com.my.test.myprovider/user")
//生成后的Uri为:content://com.my.test.myprovider/user/7
Uri resultUri = ContentUris.withAppendedId(uri, 7); 

parseId(Uri uri) 则从路径中获取 ID 部分:

Uri uri = Uri.parse("content://com.my.test.myprovider/user/7")
//获取的结果为:7
long personid = ContentUris.parseId(uri);

3.ContentObserver

public class MyObserver extends ContentObserver{
   public MyObserver (Handler handler) {
      super(handler);
   }
   public void onChange(boolean selfChange) {
      //to do something
   }
}

ContentObserver 用于监听 ContentProvider 中指定 Uri 标识数据的变化(增 / 删 / 改),使用时需要用到 ContentResolver 的两个方法:

ContentResolver.java
//注册监听
public final void registerContentObserver(Uri uri, boolean notifyForDescendants, ContentObserver observer) 

//注销监听
public final void unregisterContentObserver(ContentObserver observer)

需要注意:ContentProvider 内部需要手动通知修改事件,才能有效回调给 ContentResolver,例如:
ContentProvider 实现类

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

推荐阅读更多精彩内容