二十五岁时我们都一样愚蠢、多愁善感,喜欢故弄玄虚,可如果不那样的话,五十岁时也就不会如此明智。
标题:7.7 自定义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 的代码如下:MyFriendsDB.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;
- }
- }
这样,就定义了针对 mydb 的 friends 数据表的 ContentProvider,最后需要在 AndroidManifest.xml 文件中添加该 ContentProvider 的相应声明和访问权限。AndroidManifest.xml 的代码如下:
- 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";
- }
该文件通过如下代码:
- <?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。