Android应用开发学习笔记之ContentProvider

作者：刘昊昱

博客：http://blog.csdn.net/liuhaoyutz

ContentProvider用于为其它应用程序提供共享数据，它为不同应用程序间共享数据提供了统一的操作接口。

一、ContentProvider的Uri

每个ContentProvider都有对应的Uri，例如，一个自定义的ContentProvider Uri格式如下：

content://authority/path/id

例如：

content://com.liuhaoyu.myprovider/table1/10

1、  content://是“scheme”，Android规定ContentProvider的scheme固定为content://

2、  com.liuhaoyu.myprovider是“authority”，authority用于唯一标识这个ContentProvider，authority一般使用完整的类名来表示，以保证其唯一性。

另外，对于自定义的ContentProvider，还需要在AndroidManifest.xml中指定authority对ContentProvider进行唯一标识。例如：

<manifest.... >

<applicationandroid:icon="@drawable/icon"android:label="@string/app_name">

<provider android:name=".MyContentProvider"

android:authorities="com.liuhaoyu.myprovider"/>

</application>

</manifest>

3、  authority之后的部分，表示我们要操作的数据，包括“path”和“id”，具体包括几个字段，应该根据需要而定。例如：

要操作table2表中的所有记录，则路径为table2

要操作table2表中的ID为2的记录，则路径为table2/2

要操作table2表中的ID为2的记录的name字段，则路径为table2/2/name

如果要把字符串转换为Uri，可以使用Uri.parse()函数，例如：

Uri uri = Uri.parse(“content://com.liuhaoyu.myprovider/table1/10/name”);

二、Uri的辅助类

因为Uri会经常用到，所以Android提供了两个Uri辅助类UriMatcher和ContentUris。UriMatcher用于对Uri进行匹配，ContentUris用于对Uri的ID部分进行操作。

先来通过一个例子看UriMatcher的用法：

UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH);

sMatcher.addURI("com.liuhaoyu.myprovider","person", 1);

sMatcher.addURI("com.liuhaoyu.myprovider","person/#", 2);//#号为通配符

switch (sMatcher.match(Uri.parse("content://com.liuhaoyu.myprovider/person/10"))){

case 1

break;

case 2

break;

default:

break;

}

首先通过UriMatcher.addURI()对URI进行注册。以后就可以使用UriMatcher.match()对要处理的Uri进行匹配，如果匹配成功，返回注册的返回码。

ContentUris类有两个比较实用的方法：

ContentUris.withAppendedId()函数用于将ID添加到路径后面。

Uri uri = Uri.parse("content://com.liuhaoyu.myprovider/table1")

Uri resultUri = ContentUris.withAppendedId(uri,1);

生成的resultUri为：content://com.liuhaoyu.myprovider/1

ContentUris.parseId()函数用于从Uri中分析出ID。

Uri uri =Uri.parse("content://com.ljq.provider.personprovider/person/10")

long personid = ContentUris.parseId(uri);//获取的结果为:10

三、预定义ContentProvider

Android提供了一些预定义的ContentProvider，包括声音、图片、视频、联系人等等，它们大多数位于android.provider包中，下面列出一些常用的预定义ContentProvider：

Borwser：书签、浏览历史、搜索历史

CallLog：通话历史

Contacts：联系人

MediaStore：声音、视频、图片

四、自定义ContentProvider

若要定义自己的ContentProvider，需要完成以下操作：

(1)、建立数据存储系统。大多数ContentProvider使用Android文件存储方式或者SQlite数据库保存数据，但是开发者可以使用任何方式存储数据。Android提供了SQLiteOpenHelper类帮助创建数据库，SQLiteDatabase类帮助管理数据库。

(2)、继承ContentProvider类来提供数据访问接口。一般需要实现ContentProvider类的如下成员函数：

public class PersonContentProvider extendsContentProvider{

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)

}

(3)、在应用程序的AndroidManifest.xml文件中声明ContentProvider。例如：

<manifest.... >

<applicationandroid:icon="@drawable/icon"android:label="@string/app_name">

<provider android:name=".MyContentProvider"

android:authorities="com.liuhaoyu.myprovider"/>

</application>

</manifest>

五、使用ContentResolver

ContentProvider内部如何保存数据由其设计者决定，但是所有的ContentProvider都实现了一组通用的方法，用来对数据进行增、删、改、查。其它应用程序对ContentProvider进行操作时，并不会直接调用ContentProvider实现的方法，而是通过ContentResolver类实现对ContentProvider的操作。

可以通过Activity.getContentResolver()函数获取ContentResolver对象。

ContentResolver类提供了对ContentProvider进行增、删、改、查的相应函数，具体可参考官方文档。

六、监听ContentProvider的变化

若访问者要监听ContentProvider的变化，可以使用ContentResolver.registerContentObserver()注册一个ContentObserver对象对指定ContentProvider进行监听，如果ContentProvider的数据发生了变化，则ContentObserver.onChange()方法会被调用，可以在该函数中进行相应处理。

而在ContentProvider这边，当其中的数据发生变化时，需要调用ContentResolver.notifyChange()函数通知注册的ContentObserver。

七、应用举例

下面来看一个使用预定义的ContentProvider的例子，该程序运行效果如下：

先来看主布局文件，其内容如下：

<?xml version="1.0"encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="fill_parent"
    android:layout_height="fill_parent"
    android:orientation="vertical" >

   <TextView
        android:id="@+id/result"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textColor="@android:color/white"
        android:textSize="25dp" />

</LinearLayout>

下面看主Activity文件，其内容如下：

package com.liuhaoyu;

import android.app.Activity;
import android.content.ContentResolver;
import android.database.Cursor;
import android.os.Bundle;
importandroid.provider.ContactsContract.Contacts;
importandroid.provider.ContactsContract.CommonDataKinds.Phone;
import android.widget.TextView;

public class MainActivity extends Activity{
            private String[] columns = { Contacts._ID,
                     Contacts.DISPLAY_NAME,
                     Phone.NUMBER,
                     Phone.CONTACT_ID, };

             public void onCreate(BundlesavedInstanceState) {
                 super.onCreate(savedInstanceState);
                 setContentView(R.layout.main);
                 TextView tv = (TextView)findViewById(R.id.result);
                 tv.setText(getQueryData());
             }

             private String getQueryData() {

                 StringBuilder sb = new StringBuilder();
                 ContentResolver resolver =getContentResolver();
                 Cursor cursor =resolver.query(Contacts.CONTENT_URI, null, null, null, null);
                 while (cursor.moveToNext()) {
                     int idIndex =cursor.getColumnIndex(columns[0]);
                     int displayNameIndex =cursor.getColumnIndex(columns[1]);
                     int id = cursor.getInt(idIndex);
                     String displayName = cursor.getString(displayNameIndex);
                     Cursor phone =resolver.query(Phone.CONTENT_URI, null, columns[3] + "=" + id, null,null);
                     while (phone.moveToNext()) {
                         int phoneNumberIndex =phone.getColumnIndex(columns[2]);
                         String phoneNumber =phone.getString(phoneNumberIndex);
                         sb.append(displayName + ":" + "\n" + phoneNumber + "\n");
                     }
                 }
                 cursor.close();
                 return sb.toString();
             }
}