ContentProvider是Android四大组件之一,它用来封装数据,并通过ContentResolver接口将数据提供给其他应用。只有当需要在多个应用之间共享数据时才会用到ContentProvider。
多个应用共享数据时,如何区分是哪个应用中的那部分数据呢?
ContentProvider通过Uri标识具体某个应用的某些数据。当一个应用提供了ContentProvider向其他应用共享数据时,该应用在其ContentProvider中添加标识自己特定数据的Uri,然后其他应用想要获得这些数据时,则可以通过向ContentResolver接口的方法传入标识要访问的数据的Uri即可。
如应用B和应用C都向外提供数据,他们就需要在自己提供的ContentProvider中分别指明自己所能解析的Uri。应用A要访问应用B和应用C提供的数据,就需要使用ContentResolver接口,要向该接口的访问数据的方法中传入特定的Uri以区分是要访问应用B的数据,还是要访问应用C的数据。
应用之间共享数据需要用到的类和接口有:ContentProvider、ContentResolver、Uri、UriMatcher、ContentUris等。
下面一一学习这几个类和接口的简单使用:
1)ContentProvider:
该类是一个抽象类,要在自己应用中使用ContentProvider对象,需要自定义类继承ContentProvider类,并实现几个主要的抽象方法:
onCreate()方法: 其它应用第一次访问该ContentProvider时被调。
insert()方法:外部应用使用此方法添加数据。
delete()方法:外部应用使用此方法删除数据。
update ()方法:外部应用使用此方法更新数据。
query()方法:外部应用使用此方法查询数据。
getType()方法: 主要用于匹配数据类型,返回当前Uri所代表数据的MIME类型。如果操作的数据属于集合类型,那么MIME类型字符串应该以vnd.android.cursor.dir/自定义类型。数据属于非集合类型数据,应该返回vnd.android.cursor.item/自定义类型。
2)ContentResolver:
是一个接口,可以通过Context.getContentResolver()获取该接口的实例,当在自己应用中要访问别的应用ContentProvider提供的数据时,需要获取该接口的实例,然后调用该接口的insert()、update()、query()、delete()等方法,最终会调用对应ContentProvider中同名的方法,实现共享数据的增删改查操作。
3)Uri:
也是一个抽象类。
Uri标准的格式是:schema://主机名authority/path[/ID]
后面的ID部分根据访问需要,可能没有。
如:content://cn.csc.app1/student标识要访问的是cn.csc.app1所标识的应用中的student表。
ContentProvider中Uri的schema部分一般为content://
authority用来标识要访问的是哪个ContentProvider,通常用能唯一标识应用的包名作为authority。
path部分,则标识我们要访问的是哪些数据,如student表示我们要访问的是student表的数据。
若加上ID部分,如content://cn.csc.app1/student/10,一般被用来表示我们要访问的是student表中的id为10的那条数据。
uri中可以使用通配符:
*:表示匹配任意长度的字符串
#:表示匹配任意长度的数字串
如匹配任意表的uri可以表示为:content://cn.csc.app1/*
匹配student表中任意一条记录的uri:content://cn.csc.app1/student/#
常用到的是Uri中的一个静态方法:
parse()用来将字符串表示的uri解析为Uri对象。
4)UriMatcher:
Uri匹配的一个工具类,一般用在ContentProvider中:
一般使用常量NO_MATCH作为参数,构造UriMatcher对象,然后调用addURI()方法向该对象中添加URI,使用match()方法判断传入的Uri的匹配结果。
addURI()方法的参数说明:
authority:Uri中的authority用于标识是哪个ContentProvider
path:Uri中的path部分,标识要操作的是哪张表
code:用于设置当前添加的Uri的标识码,当使用match方法,传入一个Uri参数时,会将匹配到的Uri对应的code返回,以指明当前匹配到哪个Uri。
5)ContentUris:
一个实用的对Uri进行操作的工具类
parseId():用来获取传入的Uri中的Id部分
withAppendId():用于将传入的Uri和id拼接起来。
下面是实际编写ContentProvider的一个简单示例:
第一步:要先有一个数据库帮助类,以便于进行数据库增删改查操作
package cn.csc.content_provider.db; import android.content.Context; import android.database.sqlite.SQLiteDatabase; import android.database.sqlite.SQLiteOpenHelper; import android.database.sqlite.SQLiteDatabase.CursorFactory; import android.util.Log; public class MySqliteHelper extends SQLiteOpenHelper { public static final String TAG = "MYSQLITEHELPER"; public static final String CREATE_STUDENT = "create table t_student (" + "id integer primary key, name varchar(20), " + "gender varchar(10), age integer)"; public static final String CREATE_TEACHER = "create table t_teacher(" + "id integer primary key, name varchar(20))"; public MySqliteHelper(Context context, String name, CursorFactory factory, int version) { super(context, name, factory, version); } @Override public void onOpen(SQLiteDatabase db) { Log.i(TAG,"open db"); super.onOpen(db); } @Override public void onCreate(SQLiteDatabase db) { db.execSQL(CREATE_STUDENT); db.execSQL(CREATE_TEACHER); } @Override public void onUpgrade(SQLiteDatabase db, int oldVersion, int newVersion) { } }
第二步:编写自己的ContentProvider类,继承自ContentProvider类,并实现主要的方法:
1)编写MyContentProvider继承自ContentProvider类: public class MyContentProvider extends ContentProvider { @Override public int delete (Uri uri, String selection, String[] selectionArgs) { // TODO Auto-generated method stub return 0; } @Override public String getType(Uri uri) { // TODO Auto-generated method stub return null; } @Override public Uri insert (Uri uri, ContentValues values){ // TODO Auto-generated method stub return null; } @Override public boolean onCreate() { // TODO Auto-generated method stub return false; } @Override public Cursor query (Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { // TODO Auto-generated method stub return null; } @Override public int update (Uri uri, ContentValues values, String selection, String[] selectionArgs) { // TODO Auto-generated method stub return 0; } }
2)注意,四大组件都需要在Manifest.xml文件中注册:
在Application节点中添加:
<provider android:name="cn.csc.content_provider.MyContentProvider" android:authorities="cn.csc.content_provider"></provider>
3)为该类添加一个静态UriMatcher字段,用于后续工作中Uri的匹配工作,并通过静态代码块,添加能够匹配的Uri:
private static final UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH); private static final int STUDENT_DIR = 0; private static final int STUDENT_ITEM = 1; private static final int TEACHER_DIR = 2; private static final int TEACHER_ITEM = 3; static{ matcher.addURI("cn.csc.content_provider", "t_student", STUDENT_DIR); matcher.addURI("cn.csc.content_provider", "t_student/#", STUDENT_ITEM); matcher.addURI("cn.csc.content_provider", "t_teacher", TEACHER_DIR); matcher.addURI("cn.csc.content_provider", "t_teacher/#", TEACHER_ITEM); }
4)实现父类中的几个抽象方法:
@Override public int delete (Uri uri, String selection, String[] selectionArgs) { int cnt = -1; switch(matcher.match(uri)){ case STUDENT_DIR: cnt = db.delete("t_student", selection, selectionArgs); break; case STUDENT_ITEM: long id = ContentUris.parseId(uri); cnt = db.delete("t_student", "id = ?", new String[]{id+""}); break; case TEACHER_DIR: cnt = db.delete("t_teacher", selection, selectionArgs); break; case TEACHER_ITEM: long id1 = ContentUris.parseId(uri); cnt = db.delete("t_teacher", "id = ?", new String[]{id1+""}); break; } return cnt; } @Override public String getType(Uri uri) { switch(matcher.match(uri)){ case STUDENT_ITEM: return "vnd.android.cursor.item/student"; case TEACHER_ITEM: return "vnd.android.cursor.item/teacher"; case STUDENT_DIR: return "vnd.android.cursor.dir/student"; case TEACHER_DIR: return "vnd.android.cursor.dir/teacher"; } return null; } @Override public Uri insert (Uri uri, ContentValues values){ switch(matcher.match(uri)){ case STUDENT_DIR: long id = db.insert("t_student", null, values); return ContentUris.withAppendedId(uri, id); case TEACHER_DIR: return ContentUris.withAppendedId(uri, db.insert("t_teacher", null, values)); } return null; } @Override public boolean onCreate() { helper = new MySqliteHelper(getContext(), "students.db", null, 1); db = helper.getWritableDatabase(); return true; } @Override public Cursor query (Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { Cursor cursor = null; switch (matcher.match(uri)) { case STUDENT_ITEM: long id = ContentUris.parseId(uri); cursor = db.query("t_student", projection, "id = ?", new String[]{id+""}, null, null, sortOrder); break; case TEACHER_ITEM: long id1 = ContentUris.parseId(uri); cursor = db.query("t_teacher", projection, "id = ?", new String[]{id1+""}, null, null, sortOrder); break; case STUDENT_DIR: cursor = db.query("t_student", projection, selection, selectionArgs, null, null, sortOrder); break; case TEACHER_DIR: cursor = db.query("t_teacher", projection, selection, selectionArgs, null, null, sortOrder); break; } return cursor; } @Override public int update (Uri uri, ContentValues values, String selection, String[] selectionArgs) { int cnt = -1; switch (matcher.match(uri)) { case STUDENT_ITEM: long id = ContentUris.parseId(uri); cnt = db.update("t_student", values, "id = ?", new String[]{id+""}); break; case TEACHER_ITEM: long id1 = ContentUris.parseId(uri); cnt = db.update("t_teacher", values, "id = ?", new String[]{id1+""}); break; case STUDENT_DIR: cnt = db.update("t_student", values, selection, selectionArgs); break; case TEACHER_DIR: cnt = db.update("t_teacher", values, selection, selectionArgs); break; } return cnt; }
5)新建一个项目,在其中通过ContentResolver访问该ContentProvider提供的数据:
public class MyTest extends AndroidTestCase { public void testInsert(){ Uri uri = Uri.parse("content://cn.csc.content_provider/t_student"); ContentValues values = new ContentValues(); values.put("name", "dqrcsc"); values.put("gender", "male"); values.put("age", 24); Uri uri2 = getContext().getContentResolver().insert(uri, values); Log.i("Test",uri2.toString()); } public void testUpdate(){ Uri uri = Uri.parse("content://cn.csc.content_provider/t_student/2"); ContentValues values = new ContentValues(); values.put("name", "bbbb"); values.put("gender", "female"); values.put("age", 12); int i = getContext().getContentResolver().update(uri, values, null, null); Log.i("Test",i+""); } public void testQuery(){ Uri uri = Uri.parse("content://cn.csc.content_provider/t_student/3"); Cursor cursor = getContext().getContentResolver().query(uri, new String[]{"id","name","gender","age"}, null, null, null); while(cursor != null && cursor.moveToNext()){ Log.i("Test",cursor.getString(0)+","+cursor.getString(1)+","+cursor.getString(2)+","+cursor.getString(3)); } } public void testQueryAll(){ Uri uri = Uri.parse("content://cn.csc.content_provider/t_student"); Cursor cursor = getContext().getContentResolver().query(uri, new String[]{"id","name","gender","age"}, null, null, null); while(cursor != null && cursor.moveToNext()){ Log.i("Test",cursor.getString(0)+","+cursor.getString(1)+","+cursor.getString(2)+","+cursor.getString(3)); } } public void testDelete(){ Uri uri = Uri.parse("content://cn.csc.content_provider/t_student/6"); int i = getContext().getContentResolver().delete(uri, null, null); Log.i("Test",i+""); } }
以上,就是ContentProvider的简单使用。