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

时间:2022-10-12 17:45:37

一、ContentProvider简介

       当应用继承ContentProvider类,并重写该类用于提供数据和存储数据的方法,就可以向其他应用共享其数据。虽然使用其他方法也可以对外共享数据,但数据访问方式会因数据存储的方式而不同,如:采用文件方式对外共享数据,需要进行文件操作读写数据;采用sharedpreferences共享数据,需要使用sharedpreferencesAPI读写数据。而使用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