Android学习记录(3)—Android中ContentProvider的基本原理学习总结

时间:2021-04-07 00:10:14
一、ContentProvider简介
       当 应用继承ContentProvider类,并重写该类用于提供数据和存储数据的方法,就可以向其他应用共享其数据。虽然使用其他方法也可以对外共享数据,但数据访问方式会因数据存储的方式而不同,如:采用 文件方式对外共享数据,需要进行文件操作读写数据;采用sharedpreferences共享数据,需要使用sharedpreferences API读写数据。而使用ContentProvider共享数据的好处是统一了数据访问方式。
二、Uri类简介
       Uri代表了要操作的数据,Uri主要包含了两部分信息:1.需要操作的ContentProvider ,2.对ContentProvider中的什么数据进行操作,一个Uri由以下几部分组成:

       1.scheme:ContentProvider(内容提供者)的scheme已经由Android所规定为:content://。
       2.主机名(或Authority):用于唯一标识这个ContentProvider,外部调用者可以根据这个标识来找到它。
       3.路径(path):可以用来表示我们要操作的数据,路径的构建应根据业务而定,如下:
•         要操作contact表中id为10的记录,可以构建这样的路径:/contact/10
•         要操作contact表中id为10的记录的name字段, contact/10/name
•         要操作contact表中的所有记录,可以构建这样的路径:/contact
要操作的数据不一定来自 数据库,也可以是文件等他存储方式,如下:
要操作xml文件中contact节点下的name节点,可以构建这样的路径:/contact/name
如果要把一个字符串转换成Uri,可以使用Uri类中的parse()方法,如下:
Uri uri = Uri.parse("content://com.changcheng.provider.contactprovider/contact")
三、UriMatcher、ContentUrist和ContentResolver简介
       因为Uri代表了要操作的数据,所以我们很经常需要解析Uri,并从Uri中 获取数据。Android 系统提供了两个用于操作Uri的工具类,分别为UriMatcher 和ContentUris 。掌握它们的使用,会便于我们的 开发工作。

       UriMatcher:用于匹配Uri,它的用法如下:
       1.首先把你需要匹配Uri路径全部给注册上,如下:
       //常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码(-1)。
       UriMatcher  uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
       //如果match()方法匹配content://com.changcheng.sqlite.provider.contactprovider/contact路径,返回匹配码为1
       uriMatcher.addURI(“com.changcheng.sqlite.provider.contactprovider”, “contact”, 1);//添加需要匹配uri,如果匹配就会返回匹配码
       //如果match()方法匹配   content://com.changcheng.sqlite.provider.contactprovider/contact/230路径,返回匹配码为2
       uriMatcher.addURI(“com.changcheng.sqlite.provider.contactprovider”, “contact/#”, 2);//#号为通配符
      
       2.注册完需要匹配的Uri后,就可以使用uriMatcher.match(uri)方法对输入的Uri进行匹配,如果匹配就返回匹配码,匹配码是调用addURI()方法传入的第三个参数,假设匹配content://com.changcheng.sqlite.provider.contactprovider/contact路径,返回的匹配码为1。

       ContentUris:用于获取Uri路径后面的ID部分,它有两个比较实用的方法:
•         withAppendedId(uri, id)用于为路径加上ID部分
•         parseId(uri)方法用于从路径中获取ID部分

       ContentResolver:当外部应用需要对ContentProvider中的数据进行添加、删除、修改和查询操作时,可以使用ContentResolver 类来完成,要获取ContentResolver 对象,可以使用Activity提供的getContentResolver()方法。 ContentResolver使用insert、delete、update、query方法,来操作数据。

四、ContentProvider示例程序
Manifest.xml中的代码

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="net.loonggg.test"
android:versionCode="1"
android:versionName="1.0" >

<uses-sdk
android:minSdkVersion="8"
android:targetSdkVersion="17" />

<application
android:allowBackup="true"
android:icon="@drawable/ic_launcher"
android:label="@string/app_name"
android:theme="@style/AppTheme" >
<activity
android:name="net.loonggg.test.MainActivity"
android:label="@string/app_name" >
<intent-filter>
<action android:name="android.intent.action.MAIN" />

<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>

<provider
android:name="net.loonggg.service.PersonContentProvider"
android:authorities="net.loonggg.test.personprovider" >
</provider>
</application>

</manifest>
需要在<application></application>中为provider进行注册!!!!

这里用到了数据库的内容,而与数据库相关的内容我用的就是在Android学习记录(2)—Android中数据库的常见操作中的内容,所以我不讲了,直接讲与ContentProvider直接的内容,待会我会把代码放出来,让大家参考,所以这里不过多赘述了!

1、接着创建一个PersonContentProvider.java对数据库的接口进行包装,让数据库的操作暴露出来:

package net.loonggg.service;

import net.loonggg.db.DBHelper;
import net.loonggg.db.DBInfo.Table;
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.net.Uri;

public class PersonContentProvider extends ContentProvider {
// 定义一个uri的匹配器,用于匹配uri,如果路径不满足条件返回 -1
private static UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
private static final int INSERT = 1;
private static final int DELETE = 2;
private static final int UPDATE = 3;
private static final int QUERY = 4;
private static final int QUERYONE = 5;

private DBHelper dbHelper = null;

static {
// 添加一组匹配规则
matcher.addURI("net.loonggg.test.personprovider", "insert", INSERT);
matcher.addURI("net.loonggg.test.personprovider", "delete", DELETE);
matcher.addURI("net.loonggg.test.personprovider", "update", UPDATE);
matcher.addURI("net.loonggg.test.personprovider", "query", QUERY);
matcher.addURI("net.loonggg.test.personprovider", "query/#", QUERYONE);
}

// content://net.loonggg.test.personprovider/insert 添加的操作
// content://net.loonggg.test.personprovider/delete 删除
// content://net.loonggg.test.personprovider/update 更新
// content://net.loonggg.test.personprovider/query 查询

/**
* 当内容提供者初始化的事后调用,适合数据化的初始化
*/
@Override
public boolean onCreate() {
dbHelper = new DBHelper(getContext());
return false;
}

@Override
public Cursor query(Uri uri, String[] projection, String selection,
String[] selectionArgs, String sortOrder) {
if (matcher.match(uri) == QUERY) {
SQLiteDatabase db = dbHelper.getReadableDatabase();
Cursor cursor = db.query(Table.USER_INFO_TB_NAME, projection,
selection, selectionArgs, null, null, null);
return cursor;
} else if (matcher.match(uri) == QUERYONE) {
SQLiteDatabase db = dbHelper.getReadableDatabase();
long id = ContentUris.parseId(uri);
Cursor cursor = db.query(Table.USER_INFO_TB_NAME, projection,
"userId = ?", new String[] { id + "" }, null, null, null);
return cursor;
} else {
throw new IllegalArgumentException("路径不匹配,不能执行查询操作");
}
}

@Override
public String getType(Uri uri) {
if (matcher.match(uri) == QUERY) {
return "vnd.android.cursor.dir/person";
} else if (matcher.match(uri) == QUERYONE) {
return "vnd.android.cursor.item/person";
}
return null;
}

@Override
public Uri insert(Uri uri, ContentValues values) {
if (matcher.match(uri) == INSERT) {
SQLiteDatabase db = dbHelper.getWritableDatabase();
db.insert(Table.USER_INFO_TB_NAME, null, values);
} else {
throw new IllegalArgumentException("路径不匹配,不能执行插入操作");
}
return null;
}

@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
int result = 0;
if (matcher.match(uri) == DELETE) {
SQLiteDatabase db = dbHelper.getWritableDatabase();
result = db.delete(Table.USER_INFO_TB_NAME, selection,
selectionArgs);
} else {
throw new IllegalArgumentException("路径不匹配,不能执行删除操作");
}
return result;
}

@Override
public int update(Uri uri, ContentValues values, String selection,
String[] selectionArgs) {
int result = 0;
if (matcher.match(uri) == UPDATE) {
SQLiteDatabase db = dbHelper.getWritableDatabase();
result = db.update(Table.USER_INFO_TB_NAME, values, selection,
selectionArgs);
} else {
throw new IllegalArgumentException("路径不匹配,不能执行更新操作");
}
return result;
}

}
到这里关于ContentProvider的内容就差不多完了,这样数据就暴露出来了,可以运行程序了,最后写一个第三方的应用程序就可以操作这个程序里的数据了!

第三方调用本程序内容的程序,我也会把代码打包一同放出来,让大家参考。

代码下载地址:http://yunpan.cn/QDRj7dc3Gv2dn