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

URI 中的 就是该行 _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); 
    } }

你可能感兴趣的:(ContentProvider基本使用)