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

一、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