android菜鸟学习笔记21----ContentProvider(一)ContentProvider的简单使用

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的简单使用。