ContentProvider使用详解

最新推荐文章于 2024-09-03 17:19:15 发布

戈壁勒

最新推荐文章于 2024-09-03 17:19:15 发布

阅读量9.4k

点赞数 1

android基础专栏收录该内容

28 篇文章 1 订阅

订阅专栏

一、使用ContentProvider共享数据

ContentProvider在Android中的作用是对外提供数据，除了可以为所在应用提供
数据外，还可以共享数据给其他应用，这是Android中解决应用之间数据共享的
机制。通过ContentProvider我们可以对数据进行增删改查的操作。当应用需要
通过ContentProvider对外共享数据时，具体作法如下：

1、继承系统ContentProvider，并重写以下方法

public class PersonContentProvider extends ContentProvider{ 
   public boolean onCreate() 
   public Uri insert(Uri uri, ContentValues values) 
   public int delete(Uri uri, String selection, String[] selectionArgs) 
   public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) 
   public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) 
   public String getType(Uri uri) 
}

在重写这些方法时，根据所采用的数据存储方式进行相应修改。通常使用的
是SQLite数据库存储，我们需要新建数据库操作类，并在增删改查方法中完
成对数据库的操作。

2、需要在AndroidManifest.xml文件中注册我们的ContentProvider，这样系统方

法context.getContentResolver()才能找到我们重写的ContentProvider。在注
册ContentProvider时，采用了authorities（主机名/域名）的方法对它进行
唯一标识，ContentProvider的标识类似于网站的域名，通过此域名我们可以
准确访问到对应网站，网站为我们提供数据。Authorities就是ContentProvider
的域名。注册方法如下：

<manifest.... > 
   <application android:icon="@drawable/icon" android:label="@string/app_name"> 
      <provider android:name=".PersonContentProvider"  
           android:authorities="com.ljq.providers.personprovider"/> 
   </application> 
</manifest>

二、Uri介绍

Uri 代表了要操作的数据，Uri 主要包含了两部分信息：1、需要操作的
ContentProvider；2、对ContentProvider中的什么数据进行操作。一个Uri由以
下几部分组成：

ContentProvider的scheme已经由Android所规定，scheme为content://。
主机名（authorities）用于唯一标识这个ContentProvider，外部调用者可以根据
它找到对应的内容提供者（ContentProvider）。
路径（Path）可以用来表示我们要操作的数据，路径的构建应该根据业务而定，
如下：
要操作Person表中ID 为10的记录，可以构建这样的路径：/person/id/10，也
可以为/prson/10，构建什么样的路径需要与UriMatcher中注册的匹配Uri相一
致。例如：/person/id/10，那么匹配Uri需要也需要带id 为/preson/id/#，否则
可以写成/person/10.
要操作person表中的所有记录，可以这样构建路径：/person
如果要把一个字符串转换成Uri，可以使用Uri类中的parse()方法。如下：
Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person")

三、UriMatcher类使用介绍

因为Uri代表了要操作的数据，所以我们经常需要解析Uri，并从Uri中获取数
据。Android提供了两个用于操作Uri的工具类，分别为UriMatcher和ContentUris。
UriMatcher类用于匹配Uri，用法如下：
1、首先需要把匹配的Uri路径全部进行注册，如下：

//常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码 
UriMatcher  sMatcher = new UriMatcher(UriMatcher.NO_MATCH); 
//如果match()方法匹配content:
//com.ljq.provider.personprovider/person路径，返回匹配码为1，匹配Uri注册如下： 
sMatcher.addURI("com.ljq.provider.personprovider", person", 1);
//添加需要匹配uri，如果匹配就会返回匹配码 
//如果match()方法匹配content://com.ljq.provider.personprovider/person/230路径，返回匹配码为2，配Uri注册如下： 
sMatcher.addURI("com.ljq.provider.personprovider", "person/#", 2);
//#号为通配符 
//传入Uri，进行匹配 
switch (sMatcher.match(Uri.parse("content://com.ljq.provider.personprovider/person/10"))) {  
   case 1 
     break; 
   case 2 
     break; 
   default://不匹配 
     break; 
}

注册完需要匹配的Uri后，就可以使用sMatcher.match(uri)对输入的uri进
匹配，如果匹配正确就返回匹配码，匹配码是addUri()方法传入的第三个
数，假设匹配content://com.ljq.provider.personprovider/person 路径，返回
匹配码为1。

四、ContentUris介绍

ContentUris用于操作Uri后面的ID 部分，它有两个实用的方法：
WithAppendedId(uri, id)用于为uri路径加上id 部分，如下：

Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person") 
Uri resultUri = ContentUris.withAppendedId(uri, 10);  
//生成后的Uri为：content://com.ljq.provider.personprovider/person/10 
parseId(uri)用于从路径中获取Id，如下： 
Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person/10") 
long personid = ContentUris.parseId(uri);
//获取的结果为:10

五、使用ContentProvider共享数据

ContentProvider类主要方法的作用：
1、 public boolean onCreate()：该方法在ContentProvider 创建后就会被调用，
Android开机后，ContentProvider在其它应用第一次访问它时才会被创建。
2、 public int insert()：该方法用于宫外部应用为ContentProvider中添加数据使
用。
3、 public int delete(Uri uri, String selection, String[] selectionArgs)：该方法用于
供外部应用从ContentProvider中删除数据。
4、 public int update(Uri uri, ContentValues values, String selection, String[]
selectionArgs)：该方法用于供外部应用更新ContentProvider中的数据。
5、 public cursor query(Uri uri, String[] projection, String selection, String[]
selectionArgs, String sortOrder)：该方法用于供外部应用查询ContentProvider
中的数据。
6、 public String getType(uri)：该方法用于返回当前uri代表数据的MIME类型。
如果操作的数据属于集合类型，那么MIME类型字符串应该以
vnd.android.cursor.dir/开头，例如，要得到所有person记录的Uri为
content://com.ljq.provider.personprovider/person，那么返回的MIME类型字
符串应该为："vnd.android.cursor.dir/person"。
如果要操作的数据类型为非集合类型，那么MIME类型字符串应该以
vnd.android.cursor.item/开头。例如：得到id 为10的person记录，Uri为
content://com.ljq.provider.personprovider/person/10，那么返回的MIME类型
字符串为："vnd.android.cursor.item/person"。

六、使用ContentResovler操作ContentProvider中的数据

当外部应用需要对ContentProvider 中的数据进行操作时，可以使用
ContentResovler来完成，可以使用Activity的getContentResovler()方法来获取
CountentResovler对象。ContentResovler提过了和ContentProvider类似的四个
方法：
public Uri insert(Uri uri, ContentValues values)：该方法用于往ContentProvider
添加数据。
public int delete(Uri uri, String selection, String[] selectionArgs)：该方法用于从
ContentProvider删除数据。
public int update(Uri uri, ContentValues values, String selection, String[]
selectionArgs)：该方法用于更新ContentProvider中的数据。
public Cursor query(Uri uri, String[] projection, String selection, String[]
selectionArgs, String sortOrder)：该方法用于从ContentProvider中获取数据。
这些方法的第一个参数为uri，代表要操作的ContentProvider和对其中的什么数
据进行操作，假设给定的是：
Uri.parse("content://com.ljq.providers.personprovider/person/10")，那么将会对
主机名为com.ljq.providers.personprovider的ContentProvider进行操作，操作的数
据为person表中id为10的记录。
使用ContentResovler对ContentProvider中的数据进行增删改查操作，如下：

ContentResolver resolver =  getContentResolver(); 
Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person"); 
//添加一条记录 
ContentValues values = new ContentValues(); 
values.put("name", "linjiqin"); 
values.put("age", 25); 
resolver.insert(uri, values);   
//获取person表中所有记录 
Cursor cursor = resolver.query(uri, null, null, null, "personid desc"); 
while(cursor.moveToNext()){ 
   Log.i("ContentTest", "personid="+ cursor.getInt(0)+ ",name="+ cursor.getString(1)); 
} 
//把id为1的记录的name字段值更改新为zhangsan 
ContentValues updateValues = new ContentValues(); 
updateValues.put("name", "zhangsan"); 
Uri updateIdUri = ContentUris.withAppendedId(uri, 2); 
resolver.update(updateIdUri, updateValues, null, null);
//删除id为2的记录 
Uri deleteIdUri = ContentUris.withAppendedId(uri, 2); 
resolver.delete(deleteIdUri, null, null);

七、监听ContentProvider中数据的变化

如果ContentProvider的访问者需要知道ContentProvider中数据发生变化，可以
在ContentProvider中数据发生变化时调用getContentResovler().notifyChange(uri,
null)来通知注册在此uri上的访问者，如下：

public class PersonContentProvider extends ContentProvider { 
   public Uri insert(Uri uri, ContentValues values) { 
      db.insert("person", "personid", values); 
      getContext().getContentResolver().notifyChange(uri, null); 
   } 
}

如果ContentProvider 的访问者需要得到数据变化通知，必须使用
ContentObserver对数据（数据采用Uri描述）进行监听，当监听到数据变化通
知时，系统就会调用ContentObserver的onChange()方法，如下：

getContentResolver().registerContentObserver(Uri.parse("content://com.ljq.providers.personprovider/person"), 
       true, new PersonObserver(new Handler())); 
public class PersonObserver extends ContentObserver{ 
   public PersonObserver(Handler handler) { 
      super(handler); 
   } 
   public void onChange(boolean selfChange) { 
      //此处可以进行相应的业务处理 
   } 
}