Android自定义ContentProvider

Android 系统支持任意应用程序创建自己的 ContentProvider,以便于将应用程序的数据对其他应用程序共享。

创建应用程序自己的 ContentProvider 需要以下几个步骤:

1)当前应用程序必须具有自己的持久化数据,例如文件存储或者使用 SQLite 数据库存储。

2)当前应用程序需要实现 ContentProvider 的子类,并通过该子类完成对持久化数据的访问。

3)在 AndroidManifest.xml 文件中使用 <provider> 标签声明当前应用程序定义的 ContentProvider。此外,还可以在 AndroidManifest.xml 文件中指定相应的访问权限,以保证该 ContentProvider 仅被具有相应权限的应用程序访问。若不指定访问权限,则任意其他应用程序都可以访问该 ContentProvider。

在实际的应用中,为了方便应用程序所定义的 ContentProvider 被其他应用程序使用,通常会定义一个类,将 ContentProvider 相关信息以静态常量的方式放置到该类中。这样,使用该 ContentProvider 的应用程序只要将该类引用进来,就可以获取该 ContentProvider 的相关信息,进而通过其对数据进行操作。

本节以 Android SQLite 数据库操作实例教程中使用的实例 MyDbDemo 为例,为该实例中创建的 SQLite 数据库 mydb 中的 friends 数据表创建 ContentProvider,以便于其他应用程序通过该 ContentProvider 对 friends 数据表中的数据进行访问。

在实例 MyDbDemo 中的 introduction.android.mydbDemo 包下创建两个文件,分别为 MyDbProvider.java 和 MyFriendsDB.java。

MyDbProvider 继承了 ContentProvider 类,实现了针对 mydb 的 friends 数据表的相关操作。MyFriendsDB 中包含涉及 MyDbProvider 的相关信息。

MyDbProvider.java 的代码如下:
package introduction.android.mydbdemo;

import android.content.ContentProvider;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.UriMatcher;
import android.database.Cursor;
import android.database.sqlite.SQLiteDatabase;
import android.database.sqlite.SQLiteQueryBuilder;
import android.net.Uri;
import android.util.Log;

public class MyDbProvider extends ContentProvider {
    private dbHelper mydbHelper;
    private static final UriMatcher myUriMatcher;

    static {
        myUriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
        myUriMatcher.addURI(MyFriendsDB.AUTHORITY, "friends", MyFriendsDB.FRIENDS);
        myUriMatcher.addURI(MyFriendsDB.AUTHORITY, "friends/#", MyFriendsDB.FRIENDS_ID);
    }
    @Override
    public int delete(Uri uri, String selection, String[] selectionArgs) {
        // TODO Auto-generated method stub
        if (myUriMatcher.match(uri) != MyFriendsDB.FRIENDS_ID) {
            throw new IllegalArgumentException("Wrong Insert Type: " + uri);
        }
        String id = uri.getPathSegments().get(1);
        if (selection == null)
            selection = MyFriendsDB.ID + "=" + id;
        else
            selection = MyFriendsDB.ID + "=" + id + " and " + selection;
            SQLiteDatabase db = mydbHelper.getWritableDatabase();
            int i = db.delete(dbHelper.TB_NAME, selection, selectionArgs);
            if (i > 0)
                Log.i("myDbDemo", "数据更新成功!");
            else
                Log.i("myDbDemo", "数据未更新!");
        return i;
    }

    @Override
    public String getType(Uri uri) {
        // TODO Auto-generated method stub
        switch (myUriMatcher.match(uri)) {
            case MyFriendsDB.FRIENDS:
                return MyFriendsDB.CONTENT_TYPE;
            case MyFriendsDB.FRIENDS_ID:
                return MyFriendsDB.CONTENT_ITEM_TYPE;
            default:
                hrow new IllegalArgumentException("Unknown URI get type: " + uri);
        }
    }

    @Override
    public Uri insert(Uri uri, ContentValues values) {
        // TODO Auto-generated method stub
        if (myUriMatcher.match(uri) != MyFriendsDB.FRIENDS) {
            throw new IllegalArgumentException("Wrong Insert Type: " + uri);
        }
        if (values == null) {
            throw new IllegalArgumentException("Wrong Data.");
        }
        SQLiteDatabase db = mydbHelper.getWritableDatabase();
        long rowId = db.insert(MyFriendsDB.TABLE_NAME, null, values);
        if (rowId > 0) {
            Uri insertUri = ContentUris.withAppendedId(MyFriendsDB.CONTENT_URI, rowId);
            return insertUri;
        }
        return null;
    }

    @Override
    public boolean onCreate() {
        // TODO Auto-generated method stub
        mydbHelper = new dbHelper(getContext(),MyFriendsDB.DATABASE_NAME, null, MyFriendsDB.DATABASE_VERSI0N);
        return false;
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection,String[] selectionArgs, String sortOrder) {
        // TODO Auto-generated method stub
        switch (myUriMatcher.match(uri)) {
            case MyFriendsDB.FRIENDS:
            break;
            case MyFriendsDB.FRIENDS_ID:
            Log.d("MyDbProvider", "select id");
            String id = uri.getPathSegments().get(1);
            if (selection == null)
                selection = MyFriendsDB.ID + "=" + id;
            else 
              selection = MyFriendsDB.ID + "=" + id + " and " + selection;
              break;
        default:
          throw new IllegalArgumentException("Unknown URI type: " + uri);
        }

        if (sortOrder == null)
            sortOrder = "_id ASC";
            SQLiteDatabase db = mydbHelper.getReadableDatabase();
            Cursor c = db.query(MyFriendsDB.TABLE_NAME, projection, selection, selectionArgs,null,null, sortOrder);
            Log.d("MyDbProvider", "" + c.getCount());
            return c;
    }

    @Override
    public int update(Uri uri, ContentValues values, String selection,String[] selectionArgs) {
        // TODO Auto-generated method stub
        if (myUriMatcher.match(uri) != MyFriendsDB.FRIENDS_ID) {
            throw new IllegalArgumentException("Wrong Insert Type: " + uri);
        }
        if (values == null) {
            throw new IllegalArgumentException("Wrong Data.");
        }
        String id = uri.getPathSegments().get(1);
        if (selection == null)
            selection = MyFriendsDB.ID + "=" + id;
        else
            selection = MyFriendsDB.ID + "=" + id + " and " + selection;
            SQLiteDatabase db = mydbHelper.getWritableDatabase();
            int i = db.update(dbHelper.TB_NAME, values, selection, selectionArgs);
            if (i > 0)
                Log.i("myDbDemo ", "数据更新成功! ");
            else
                Log.i("myDbDemo", "数据未更新!");
                return i;
    }
}
MyFriendsDB.java 的代码如下:
package introduction.android.mydbdemo;

import android.net.Uri;

public class MyFriendsDB {

    public static final String AUTHORITY = "introduction.android.mydbdemo.myfriendsdb";
    public static final String DATABASE_NAME = "mydb";
    public static final int DATABASE_VERSI0N = 1;
    public static final String TABLE_NAME = "friends";

    public static final Uri CONTENT_URI = Uri.parse("content://" + AUTHORITY + "/friends");
    public static final int FRIENDS = 1;
    public static final int FRIENDS_ID = 2;

    public static final String CONTENT_TYPE = "vnd.android.cursor.dir/mydb.friends.all";
    public static final String CONTENT_ITEM_TYPE = "vnd.android.cursor.dir/mydb.friends.item";
    public static final String ID = "_id";

    public static final String NAME = "name";
    public static final String AGE = "age";
}
这样,就定义了针对 mydb 的 friends 数据表的 ContentProvider,最后需要在 AndroidManifest.xml 文件中添加该 ContentProvider 的相应声明和访问权限。AndroidManifest.xml 的代码如下:
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="introduction.android.mydbdemo"
    android:versionCode="1"
    android:versionName="1.0">

     uses-sdk android:minSdkVersion="14" />
     uses-permission android:name="introduction.android.permission.USE_MYDB" />
    application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        provider
            android:name="MyDbProvider"
            android:authorities="introduction.android.mydbdemo.MyFriendsDB" />
        activity android:name=".MainActivity">
            <intent-filter>
                action android:name="android.intent.action.MAIN" />
                category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        /activity>
    /application>

</manifest>
该文件通过如下代码:

<provider android:name="MyDbProvider" android:authorities="introduction.android.mydbdemo.MyFriendsDB" />

指明该 ContentProvider 名为 MyDbProvider,该 ContentProvider 的 Authority 为 introduction.android.mydbdemo.myfriendsdb。

通过如下代码:

<uses-permission android:name="introduction.android.permission.USE_MYDB"/>

指明该 ContentProvider 的权限为 introduction.android.permission.USE_MYDB,只有具有该权限的应用程序才可以访问该 ContentProvider。