一、使用ContentProvider(内容提供者)共享数据
ContentProvider在android中的作用是对外共享数据,也就是说你可以通过ContentProvider把应用中的数据共享给其他应用访问,其他应用可以通过ContentProvider对你应用中的数据进行添删改查。关于数据共享,以前我们学习过文件操作模式,知道通过指定文件的操作模式为Context.MODE_WORLD_READABLE或Context.MODE_WORLD_WRITEABLE同样也可以对外共享数据。那么,这里为何要使用ContentProvider对外共享数据呢?是这样的,如果采用文件操作模式对外共享数据,数据的访问方式会因数据存储的方式而不同,导致数据的访问方式无法统一,如:采用xml文件对外共享数据,需要进行xml解析才能读取数据;采用sharedpreferences共享数据,需要使用sharedpreferences API读取数据。
使用ContentProvider对外共享数据的好处是统一了数据的访问方式。
当应用需要通过ContentProvider对外共享数据时,第一步需要继承ContentProvider并重写下面方法:
public class PersonContentProvider extends ContentProvider{ public boolean onCreate() public Uri insert(Uri uri, ContentValues values) public int delete(Uri uri, String selection, String[] selectionArgs) public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) public String getType(Uri uri) }
第二步需要在AndroidManifest.xml使用<provider>对该ContentProvider进行配置,为了能让其他应用找到该ContentProvider ,ContentProvider采用了authorities(主机名/域名)对它进行唯一标识,你可以把ContentProvider看作是一个网站(想想,网站也是提供数据者),authorities 就是他的域名:
< manifest.... > < application android:icon ="@drawable/icon" android:label ="@string/app_name" > < provider android:name =".PersonContentProvider" android:authorities ="com.ljq.providers.personprovider" /> </ application > </ manifest >
二、Uri介绍
Uri代表了要操作的数据,Uri主要包含了两部分信息:1》需要操作的ContentProvider ,2》对ContentProvider中的什么数据进行操作,一个Uri由以下几部分组成:
ContentProvider(内容提供者)的scheme已经由Android所规定, scheme为:content://
主机名(或叫Authority)用于唯一标识这个ContentProvider,外部调用者可以根据这个标识来找到它。
路径(path)可以用来表示我们要操作的数据,路径的构建应根据业务而定,如下:
要操作person表中id为10的记录,可以构建这样的路径:/person/10
要操作person表中id为10的记录的name字段, person/10/name
要操作person表中的所有记录,可以构建这样的路径:/person
要操作xxx表中的记录,可以构建这样的路径:/xxx
当然要操作的数据不一定来自数据库,也可以是文件、xml或网络等其他存储方式,如下:
要操作xml文件中person节点下的name节点,可以构建这样的路径:/person/name
如果要把一个字符串转换成Uri,可以使用Uri类中的parse()方法,如下:
Uri uri = Uri.parse("content://com.ljq.provider.personprovider/person")
三、UriMatcher类使用介绍
因为Uri代表了要操作的数据,所以我们经常需要解析Uri,并从Uri中获取数据。Android系统提供了两个用于操作Uri的工具类,分别为UriMatcher和ContentUris 。掌握它们的使用,会便于我们的开发工作。
UriMatcher类用于匹配Uri,它的用法如下:
首先第一步把你需要匹配Uri路径全部给注册上,如下:
// 常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码 UriMatcher sMatcher = new UriMatcher(UriMatcher.NO_MATCH); // 如果match()方法匹配content: // com.ljq.provider.personprovider/person路径,返回匹配码为1 sMatcher.addURI( " com.ljq.provider.personprovider " , " person " , 1 ); // 添加需要匹配uri,如果匹配就会返回匹配码 // 如果match()方法匹配content: // com.ljq.provider.personprovider/person/230路径,返回匹配码为2 sMatcher.addURI( " com.ljq.provider.personprovider " , " person/# " , 2 ); // #号为通配符 switch (sMatcher.match(Uri.parse( " content://com.ljq.provider.personprovider/person/10 " ))) { case 1 break ; case 2 break ; default : // 不匹配 break ; }
注册完需要匹配的Uri后,就可以使用sMatcher.match(uri)方法对输入的Uri进行匹配,如果匹配就返回匹配码,匹配码是调用addURI()方法传入的第三个参数,假设匹配content://com.ljq.provider.personprovider/person路径,返回的匹配码为1
四、ContentUris类使用介绍
ContentUris类用于操作Uri路径后面的ID部分,它有两个比较实用的方法:
withAppendedId(uri, id)用于为路径加上ID部分:
Uri uri = Uri.parse( " content://com.ljq.provider.personprovider/person " ) Uri resultUri = ContentUris.withAppendedId(uri, 10 ); // 生成后的Uri为:content: // com.ljq.provider.personprovider/person/10
parseId(uri)方法用于从路径中获取ID部分:
Uri uri = Uri.parse( " content://com.ljq.provider.personprovider/person/10 " ) long personid = ContentUris.parseId(uri); // 获取的结果为:10
五、使用ContentProvider共享数据
ContentProvider类主要方法的作用:
public boolean onCreate():该方法在ContentProvider创建后就会被调用,Android开机后,ContentProvider在其它应用第一次访问它时才会被创建。
public Uri insert(Uri uri, ContentValues values):该方法用于供外部应用往ContentProvider添加数据。
public int delete(Uri uri, String selection, String[] selectionArgs):该方法用于供外部应用从ContentProvider删除数据。
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs):该方法用于供外部应用更新ContentProvider中的数据。
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder):该方法用于供外部应用从ContentProvider中获取数据。
public String getType(Uri uri):该方法用于返回当前Url所代表数据的MIME类型。
如果操作的数据属于集合类型,那么MIME类型字符串应该以vnd.android.cursor.dir/开头,
例如:要得到所有person记录的Uri为content://com.ljq.provider.personprovider/person,那么返回的MIME类型字符串应该为:"vnd.android.cursor.dir/person"。
如果要操作的数据属于非集合类型数据,那么MIME类型字符串应该以vnd.android.cursor.item/开头,
例如:得到id为10的person记录,Uri为content://com.ljq.provider.personprovider/person/10,那么返回的MIME类型字符串为:"vnd.android.cursor.item/person"。
六、使用ContentResolver操作ContentProvider中的数据
当外部应用需要对ContentProvider中的数据进行添加、删除、修改和查询操作时,可以使用ContentResolver 类来完成,要获取ContentResolver 对象,可以使用Activity提供的getContentResolver()方法。 ContentResolver 类提供了与ContentProvider类相同签名的四个方法:
public Uri insert(Uri uri, ContentValues values):该方法用于往ContentProvider添加数据。
public int delete(Uri uri, String selection, String[] selectionArgs):该方法用于从ContentProvider删除数据。
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs):该方法用于更新ContentProvider中的数据。
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder):该方法用于从ContentProvider中获取数据。
这些方法的第一个参数为Uri,代表要操作的ContentProvider和对其中的什么数据进行操作,
假设给定的是:Uri.parse("content://com.ljq.providers.personprovider/person/10"),那么将会对主机名为com.ljq.providers.personprovider的ContentProvider进行操作,操作的数据为person表中id为10的记录。
使用ContentResolver对ContentProvider中的数据进行添加、删除、修改和查询操作:
ContentResolver resolver = getContentResolver(); Uri uri = Uri.parse( " content://com.ljq.provider.personprovider/person " ); // 添加一条记录 ContentValues values = new ContentValues(); values.put( " name " , " linjiqin " ); values.put( " age " , 25 ); resolver.insert(uri, values); // 获取person表中所有记录 Cursor cursor = resolver.query(uri, null , null , null , " personid desc " ); while (cursor.moveToNext()){ Log.i( " ContentTest " , " personid= " + cursor.getInt( 0 ) + " ,name= " + cursor.getString( 1 )); } // 把id为1的记录的name字段值更改新为zhangsan ContentValues updateValues = new ContentValues(); updateValues.put( " name " , " zhangsan " ); Uri updateIdUri = ContentUris.withAppendedId(uri, 2 ); resolver.update(updateIdUri, updateValues, null , null ); // 删除id为2的记录 Uri deleteIdUri = ContentUris.withAppendedId(uri, 2 ); resolver.delete(deleteIdUri, null , null );
七、监听ContentProvider中数据的变化
如果ContentProvider的访问者需要知道ContentProvider中的数据发生变化,可以在ContentProvider发生数据变化时调用getContentResolver().notifyChange(uri, null)来通知注册在此URI上的访问者,例子如下:
public class PersonContentProvider extends ContentProvider { public Uri insert(Uri uri, ContentValues values) { db.insert( " person " , " personid " , values); getContext().getContentResolver().notifyChange(uri, null ); } }
如果ContentProvider的访问者需要得到数据变化通知,必须使用ContentObserver对数据(数据采用uri描述)进行监听,当监听到数据变化通知时,系统就会调用ContentObserver的onChange()方法:
getContentResolver().registerContentObserver(Uri.parse( " content://com.ljq.providers.personprovider/person " ), true , new PersonObserver( new Handler())); public class PersonObserver extends ContentObserver{ public PersonObserver(Handler handler) { super (handler); } public void onChange( boolean selfChange) { // 此处可以进行相应的业务处理 } }
下面是实例:
PersonContentProvider内容提供者类
package com.ljq.db; 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; import android.text.TextUtils; /** * 内容提供者 * * 作用:统一数据访问方式,方便外部调用 * * @author jiqinlin * */ public class PersonContentProvider extends ContentProvider { // 数据集的MIME类型字符串则应该以vnd.android.cursor.dir/开头 public static final String PERSONS_TYPE = " vnd.android.cursor.dir/person " ; // 单一数据的MIME类型字符串应该以vnd.android.cursor.item/开头 public static final String PERSONS_ITEM_TYPE = " vnd.android.cursor.item/person " ; public static final String AUTHORITY = " com.ljq.provider.personprovider " ; // 主机名 /* 自定义匹配码 */ public static final int PERSONS = 1 ; /* 自定义匹配码 */ public static final int PERSON = 2 ; public static final Uri PERSONS_URI = Uri.parse( " content:// " + AUTHORITY + " /person " ); private DBOpenHelper dbOpenHelper = null ; // UriMatcher类用来匹配Uri,使用match()方法匹配路径时返回匹配码 private static final UriMatcher uriMatcher; static { // 常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码 uriMatcher = new UriMatcher(UriMatcher.NO_MATCH); // 如果match()方法匹配content: // com.ljq.provider.personprovider/person路径,返回匹配码为PERSONS uriMatcher.addURI(AUTHORITY, " person " , PERSONS); // 如果match()方法匹配content: // com.ljq.provider.personprovider/person/230路径,返回匹配码为PERSON uriMatcher.addURI(AUTHORITY, " person/# " , PERSON); } @Override public boolean onCreate() { dbOpenHelper = new DBOpenHelper( this .getContext()); return true ; } @Override public Uri insert(Uri uri, ContentValues values){ SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); long id = 0 ; switch (uriMatcher.match(uri)) { case PERSONS: id = db.insert( " person " , " name " , values); // 返回的是记录的行号,主键为int,实际上就是主键值 return ContentUris.withAppendedId(uri, id); case PERSON: id = db.insert( " person " , " name " , values); String path = uri.toString(); return Uri.parse(path.substring( 0 , path.lastIndexOf( " / " )) + id); // 替换掉id default : throw new IllegalArgumentException( " Unknown URI " + uri); } } @Override public int delete(Uri uri, String selection, String[] selectionArgs) { SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); int count = 0 ; switch (uriMatcher.match(uri)) { case PERSONS: count = db.delete( " person " , selection, selectionArgs); break ; case PERSON: // 下面的方法用于从URI中解析出id,对这样的路径content: // com.ljq.provider.personprovider/person/10 // 进行解析,返回值为10 long personid = ContentUris.parseId(uri); String where = " id= " + personid; // 删除指定id的记录 where += ! TextUtils.isEmpty(selection) ? " and ( " + selection + " ) " : "" ; // 把其它条件附加上 count = db.delete( " person " , where, selectionArgs); break ; default : throw new IllegalArgumentException( " Unknown URI " + uri); } db.close(); return count; } @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { SQLiteDatabase db = dbOpenHelper.getWritableDatabase(); int count = 0 ; switch (uriMatcher.match(uri)) { case PERSONS: count = db.update( " person " , values, selection, selectionArgs); break ; case PERSON: // 下面的方法用于从URI中解析出id,对这样的路径content: // com.ljq.provider.personprovider/person/10 // 进行解析,返回值为10 long personid = ContentUris.parseId(uri); String where = " id= " + personid; // 获取指定id的记录 where += ! TextUtils.isEmpty(selection) ? " and ( " + selection + " ) " : "" ; // 把其它条件附加上 count = db.update( " person " , values, where, selectionArgs); break ; default : throw new IllegalArgumentException( " Unknown URI " + uri); } db.close(); return count; } @Override public String getType(Uri uri) { switch (uriMatcher.match(uri)) { case PERSONS: return PERSONS_TYPE; case PERSON: return PERSONS_ITEM_TYPE; default : throw new IllegalArgumentException( " Unknown URI " + uri); } } @Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { SQLiteDatabase db = dbOpenHelper.getReadableDatabase(); switch (uriMatcher.match(uri)) { case PERSONS: return db.query( " person " , projection, selection, selectionArgs, null , null , sortOrder); case PERSON: // 下面的方法用于从URI中解析出id,对这样的路径content: // com.ljq.provider.personprovider/person/10 // 进行解析,返回值为10 long personid = ContentUris.parseId(uri); String where = " id= " + personid; // 获取指定id的记录 where += ! TextUtils.isEmpty(selection) ? " and ( " + selection + " ) " : "" ; // 把其它条件附加上 return db.query( " person " , projection, where, selectionArgs, null , null , sortOrder); default : throw new IllegalArgumentException( " Unknown URI " + uri); } } }
文件清单
<? xml version="1.0" encoding="utf-8" ?> < manifest xmlns:android ="http://schemas.android.com/apk/res/android" package ="com.ljq.sql" android:versionCode ="1" android:versionName ="1.0" > < application android:icon ="@drawable/icon" android:label ="@string/app_name" > < uses-library android:name ="android.test.runner" /> < activity android:name =".SqlActivity" 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 ="com.ljq.db.PersonContentProvider" android:authorities ="com.ljq.provider.personprovider" /> </ application > < uses-sdk android:minSdkVersion ="7" /> < instrumentation android:name ="android.test.InstrumentationTestRunner" android:targetPackage ="com.ljq.sql" android:label ="Tests for My App" /> </ manifest >
PersonContentProviderTest内容提供者测试类
package com.ljq.test; import android.content.ContentResolver; import android.content.ContentValues; import android.database.Cursor; import android.net.Uri; import android.test.AndroidTestCase; import android.util.Log; /** * 外部访问内容提供者 * * @author jiqinlin * */ public class PersonContentProviderTest extends AndroidTestCase{ private static final String TAG = " PersonContentProviderTest " ; public void testSave() throws Throwable{ ContentResolver contentResolver = this .getContext().getContentResolver(); Uri insertUri = Uri.parse( " content://com.ljq.provider.personprovider/person " ); ContentValues values = new ContentValues(); values.put( " name " , " ljq " ); values.put( " phone " , " 1350000009 " ); Uri uri = contentResolver.insert(insertUri, values); Log.i(TAG, uri.toString()); } public void testUpdate() throws Throwable{ ContentResolver contentResolver = this .getContext().getContentResolver(); Uri updateUri = Uri.parse( " content://com.ljq.provider.personprovider/person/1 " ); ContentValues values = new ContentValues(); values.put( " name " , " linjiqin " ); contentResolver.update(updateUri, values, null , null ); } public void testFind() throws Throwable{ ContentResolver contentResolver = this .getContext().getContentResolver(); // Uri uri = Uri.parse("content: // com.ljq.provider.personprovider/person"); Uri uri = Uri.parse( " content://com.ljq.provider.personprovider/person " ); Cursor cursor = contentResolver.query(uri, null , null , null , " id asc " ); while (cursor.moveToNext()){ int personid = cursor.getInt(cursor.getColumnIndex( " id " )); String name = cursor.getString(cursor.getColumnIndex( " name " )); String phone = cursor.getString(cursor.getColumnIndex( " phone " )); Log.i(TAG, " personid= " + personid + " ,name= " + name + " ,phone= " + phone); } cursor.close(); } public void testDelete() throws Throwable{ ContentResolver contentResolver = this .getContext().getContentResolver(); Uri uri = Uri.parse( " content://com.ljq.provider.personprovider/person/1 " ); contentResolver.delete(uri, null , null ); } }
来自CSDN Blog : feng88724的专栏 2011-04-18
1.Uri
通用资源标志符(Universal Resource Identifier, 简称"URI")。
Uri代表要操作的数据,Android上可用的每种资源 - 图像、视频片段等都可以用Uri来表示。
URI一般由三部分组成:
访问资源的命名机制。
存放资源的主机名。
资源自身的名称,由路径表示。
Android的Uri由以下三部分组成: "content://"、数据的路径、标示ID(可选)
举些例子,如:
所有联系人的Uri: content://contacts/people
某个联系人的Uri: content://contacts/people/5
所有图片Uri: content://media/external
某个图片的Uri:content://media/external/images/media/4
我们很经常需要解析Uri,并从Uri中获取数据。
Android系统提供了两个用于操作Uri的工具类,分别为UriMatcher 和ContentUris 。
虽然这两类不是非常重要,但是掌握它们的使用,会便于我们的开发工作。
下面就一起看一下这两个类的作用。
2.UriMatcher
UriMatcher 类主要用于匹配Uri.
使用方法如下。
首先第一步,初始化:
- UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
第二步注册需要的Uri:
- matcher.addURI("com.yfz.Lesson", "people", PEOPLE);
- matcher.addURI("com.yfz.Lesson", "person/#", PEOPLE_ID);
第三部,与已经注册的Uri进行匹配:
- Uri uri = Uri.parse("content://" + "com.yfz.Lesson" + "/people");
- int match = matcher.match(uri);
- switch (match)
- {
- case PEOPLE:
- return "vnd.android.cursor.dir/people";
- case PEOPLE_ID:
- return "vnd.android.cursor.item/people";
- default:
- return null;
- }
match方法匹配后会返回一个匹配码Code,即在使用注册方法addURI时传入的第三个参数。
上述方法会返回"vnd.android.cursor.dir/person".
总结:
--常量 UriMatcher.NO_MATCH 表示不匹配任何路径的返回码
--# 号为通配符
--* 号为任意字符
另外说一下,官方SDK说明中关于Uri的注册是这样写的:
- private static final UriMatcher sURIMatcher = new UriMatcher();
- static
- {
- sURIMatcher.addURI("contacts", "/people", PEOPLE);
- sURIMatcher.addURI("contacts", "/people/#", PEOPLE_ID);
- sURIMatcher.addURI("contacts", "/people/#/phones", PEOPLE_PHONES);
- sURIMatcher.addURI("contacts", "/people/#/phones/#", PEOPLE_PHONES_ID);
- sURIMatcher.addURI("contacts", "/people/#/contact_methods", PEOPLE_CONTACTMETHODS);
- sURIMatcher.addURI("contacts", "/people/#/contact_methods/#", PEOPLE_CONTACTMETHODS_ID);
- sURIMatcher.addURI("contacts", "/deleted_people", DELETED_PEOPLE);
- sURIMatcher.addURI("contacts", "/phones", PHONES);
- sURIMatcher.addURI("contacts", "/phones/filter/*", PHONES_FILTER);
- sURIMatcher.addURI("contacts", "/phones/#", PHONES_ID);
- sURIMatcher.addURI("contacts", "/contact_methods", CONTACTMETHODS);
- sURIMatcher.addURI("contacts", "/contact_methods/#", CONTACTMETHODS_ID);
- sURIMatcher.addURI("call_log", "/calls", CALLS);
- sURIMatcher.addURI("call_log", "/calls/filter/*", CALLS_FILTER);
- sURIMatcher.addURI("call_log", "/calls/#", CALLS_ID);
- }
这个说明估计已经是Google官方没有更新,首先是初始化方法,没有传参,那么现在初始化时,实际是必须传参的。 可以看一下Android2.2的源码,无参数的构造方法已经是private的了。
另外就是addURI这个方法,第二个参数开始时不需要"/", 否则是无法匹配成功的。
3.ContentUris
ContentUris 类用于获取Uri路径后面的ID部分
1)为路径加上ID: withAppendedId(uri, id)
比如有这样一个Uri
- Uri uri = Uri.parse("content://com.yfz.Lesson/people")
通过withAppendedId方法,为该Uri加上ID
- Uri resultUri = ContentUris.withAppendedId(uri, 10);
最后resultUri为: content://com.yfz.Lesson/people/10
2)从路径中获取ID: parseId(uri)
- Uri uri = Uri.parse("content://com.yfz.Lesson/people/10")
- long personid = ContentUris.parseId(uri);
最后personid 为 :10
附上实验的代码:
- package com.yfz;
- import com.yfz.log.Logger;
- import android.app.Activity;
- import android.content.ContentUris;
- import android.content.UriMatcher;
- import android.net.Uri;
- import android.os.Bundle;
- public class Lesson_14 extends Activity {
- private static final String AUTHORITY = "com.yfz.Lesson";
- private static final int PEOPLE = 1;
- private static final int PEOPLE_ID = 2;
- //NO_MATCH表示不匹配任何路径的返回码
- private static final UriMatcher sURIMatcher = new UriMatcher(UriMatcher.NO_MATCH);
- static
- {
- sURIMatcher.addURI(AUTHORITY, "people", PEOPLE);
- //这里的#代表匹配任意数字,另外还可以用*来匹配任意文本
- sURIMatcher.addURI(AUTHORITY, "people/#", PEOPLE_ID);
- }
- @Override
- protected void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- Logger.d("------ Start Activity !!! ------");
- Uri uri1 = Uri.parse("content://" + AUTHORITY + "/people");
- Logger.e("Uri:" + uri1);
- Logger.d("Match 1" + getType(uri1));
- Uri uri2 = Uri.parse("content://" + AUTHORITY + "/people" + "/2");
- Logger.e("Uri:" + uri2);
- Logger.d("Match 2" + getType(uri2));
- //拼接Uri
- Uri cUri = ContentUris.withAppendedId(uri1, 15);
- Logger.e("Uri:" + cUri);
- //获取ID
- long id = ContentUris.parseId(cUri);
- Logger.d("Uri ID: " + id);
- }
- private String getType(Uri uri) {
- int match = sURIMatcher.match(uri);
- switch (match)
- {
- case PEOPLE:
- return "vnd.android.cursor.dir/person";
- case PEOPLE_ID:
- return "vnd.android.cursor.item/person";
- default:
- return null;
- }
- }
- }