Android 系统支持任意应用程序创建自己的 ContentProvider,以便于将应用程序的数据对其他应用程序共享。 创建应用程序自己的 ContentProvider 需要以下几个步骤: 1)当前应用程序必须具有自
创建应用程序自己的 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。