Android学习笔记37:使用Content Providers方式共享数据

  在Android中一共提供了5种数据存储方式,分别为:

  (1)Files:通过FileInputStream和FileOutputStream对文件进行操作。具体使用方法可以参阅博文《Android学习笔记34:使用文件存储数据》。

  (2)Shared Preferences:常用来存储键值对形式的数据,对系统配置信息进行保存。具体使用方法可以参阅博文《Android学习笔记35:使用Shared Preferences方式存储数据》。

  (3)Content Providers:数据共享,用于应用程序之间数据的访问。

  (4)SQLite:Android自带的轻量级关系型数据库,支持SQL语言,用来存储大量的数据,并且能够对数据进行使用、更新、维护等操作。具体使用方法可以参阅博文《Android学习笔记36:使用SQLite方式存储数据》。

  (5)Network:通过网络来存储和获取数据。

  本篇博文介绍第三种方式,通过Content Providers实现应用程序之间的数据共享。

 

1.Content Providers简介

  在Android系统中,不存在一个公共的数据存储区供所有的应用程序访问,也就是说数据在各个应用程序中是私有的。那么,如何在一个应用程序中访问另一个应用程序中的数据,实现应用程序之间的数据共享呢?

  当然,你可以通过《Android学习笔记34:使用文件存储数据》一文中讲到的设置openFileOutput()方法中的第二个参数mode为Context.MODE_WORLD_READABLE和Context.MODE_WORLD_WRITEABLE,让别的应用程序可以读写该应用程序中的文件。但是,使用这种方式的弊端也是显而易见的,不仅需要知道该文件的存储路径,而且会将该文件内容完全的暴露出去,对于内容提供者和内容访问者来说都是不方便和不安全的。

  为此,Android系统提供了Content Providers,用以方便安全的实现应用程序间的数据共享。

1.1ContentResolver

  所有的Content Providers都会实现一些共同的接口,包括数据的查询、添加、更改和删除。在应用程序中,我们可以通过使用getContentResolver()方法来取得一个ContentResolver对象,然后就可以通过这个ContentResolver对象来操作你需要的Content Provider了。ContentResolver类提供的用来操作Content Provider的方法主要有insert()、delete()、update()和query()。

  通常,对于开发者而言,并不需要同Content Provider对象直接打交道。系统运行时,会将所有的ContentProvider对象实例化,对于每一种类型的ContentProvider只有一个实例。这个实例可以与在不同的程序或进程中的多个ContentResolver对象进行通信。而这些进程间的交互则是由ContentResolver和ContentProvider类进行处理的。

  对于Content Providers而言,最重要的就是数据存储结构和URI。

1.2数据存储结构

  Content Providers将其存储的数据以数据表的形式提供给访问者,在数据表中,每一行为一条记录,每一列为具有特定类型和意义的数据。比如,联系人的Content Provider数据存储结构如图1所示。

Android学习笔记37:使用Content Providers方式共享数据_第1张图片

图1 Content Provider数据存储结构示例

  可以看出,每条记录都有一个_ID字段用来唯一的标识该记录,类似于数据库中的主键。

1.3URI

  每一个Content Provider都对外提供一个能够唯一标识自己数据集的公开URI,如果一个Content Provider管理多个数据集,则需要为每一个数据集都分配一个独立的URI。

  Android规定,所有Content Provider的URI都必须以“content://”开头。通常,URI由3部分组成:“content://”、数据的路径、标识ID(可选)。

  比如,以下是系统提供的一些URI:

  (1)content://media/internal/images

  (2)content://contacts/people/2

  (3)content://contacts/people

  其中,(1)将返回设备上存储的所有图片;(2)将返回联系人信息中ID为5的联系人记录;(3)将返回设备上所有的联系人信息。

  每个ContentResolver对象都将URI作为其第一个参数,URI决定了ContentResolver将与哪一个Content Provider对话。

 

2.获取Content Provider内容

  Android系统为一些常见的数据类型(如音频、视频、图像、通讯录联系人等)内置了一系列的Content Provider。以下就以通讯录联系人为例,讲讲如何获取Content Provider内容。

  首先,我们需要在模拟器中运行“联系人”应用程序程序,并在其中添加联系人。如图2所示。

Android学习笔记37:使用Content Providers方式共享数据_第2张图片

图2 添加联系人

  如图2所示,我在“联系人”应用程序程序中添加了两个联系人:李明和王磊。

  然后,我们需要创建一个自己的工程,该工程的主要功能就是得到持有联系人信息的Content Provider中的数据。这里,我在布局文件中定义了一个TextView控件,用来将获得的联系人数据显示出来,运行后的效果如图3所示。

Android学习笔记37:使用Content Providers方式共享数据_第3张图片

图3 获取Content Provider内容

  由图3可以看出,我们自己创建的应用程序确实从“联系人”应用程序程序中获得了数据(ID和Name字段),当然,如果你需要,你可以获取图1中的更多的字段信息。

  下面的代码给出了实现这一功能的一种方案。

 1     /*
 2      * Function  :    获取联系人列表信息
 3      * Author    :    博客园-依旧淡然
 4      */
 5     public String getResult() {
 6         
 7         String result = "";
 8         Uri uri = Uri.parse("content://contacts/people");        //联系人Content Provider的URI
 9         String[] columns = {People._ID, People.NAME};            //联系人的ID和Name
10         
11         ContentResolver contentResolver = getContentResolver();     //获取ContentResolver对象
12         Cursor cursor = contentResolver.query(uri, columns, null, null, null);    //查询Content Provider
13             int peopleId = cursor.getColumnIndex(People._ID);       //获得ID字段的列索引
14             int peopleName = cursor.getColumnIndex(People.NAME);    //获得Name字段的列索引
15             
16         //遍历Cursor对象,提取数据
17         for(cursor.moveToFirst(); (!cursor.isAfterLast()); cursor.moveToNext()) {
18             result = result + cursor.getString(peopleId) + "\t\t";
19             result = result + cursor.getString(peopleName) + "\t\n";
20         }
21         cursor.close();
22         return result;
23     }

  通过以上的代码可以看出,要获取Content Provider内容,我们需要知道Content Provider的URI以及Content Provider的数据存储形式(字段名称和字段类型)。然后,我们便可以通过使用ContentResolver对象的query()方法对Content Provider进行查询了,查询的结果需要使用Cursor对象存储(有关Cursor的介绍可以参阅《Android学习笔记36:使用SQLite方式存储数据》一文)。最后遍历Cursor对象,取出各个字段的信息即可。

  因为该应用程序需要访问联系人信息,所以还需要在AndroidManifest.xml文件中加入相应的权限许可,具体如下:

  <uses-permission android:name="android.permission.READ_CONTACTS"/>

  至此,我们便完成了获取联系人Content Provider内容的功能。

 

3.提供Content Provider内容

  上面介绍了如何从别的应用程序中获取Content Provider内容,那么如何在自己的应用程序中提供Content Provider内容供别的应用程序访问呢?

  一般来说,让自己的数据被别的应用程序访问有两种方式:创建自己的Content Provider(即继承自Content Provider的子类),或者是将自己的数据加入到已有的Content Provider中去。将自己的数据加入到已有的Content Provider中去有一定的局限性,因为要保证自己的数据和现有的Content Provider数据类型相同,并且具有该Content Provider的写入权限。

  下面将说说如何创建一个自己的Content Provider,大致可以分为3个步骤。

3.1建立数据的存储系统

  很显然,要将自己应用程序中的数据共享给他人,肯定需要建立自己的数据存储系统。当然了,选择什么样的存储系统(文件存储系统、SQLite数据库等)完全由开发者决定。

  在《Android学习笔记36:使用SQLite方式存储数据》一文中,我们搭建了一个简单的SQLite数据库系统。在该数据库中,我们新建了一张具有3个字段(studentId、studentName、studentAge)的表,用来存储学生信息。

  这里,我们就以该工程为例,讲讲如何将该工程中的学生信息通过Content Provider方式共享出去。

3.2扩展Content Provider类

  在该工程中,我们需要新建了一个继承自ContentProvider的类。用来将要共享的数据进行包装并以ContentResolver对象和Cursor对象能够访问的形式对外展示。这里,我将这个类命名为了“StudentContentProvider”。

  在ContentProvider类中提供了6个抽象方法,分别为:

  (1)public abstract Cursor query (Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder);

  (2)public abstract Uri insert (Uri uri, ContentValues values);

  (3)public abstract int update (Uri uri, ContentValues values, String selection, String[] selectionArgs);

  (4)public abstract int delete (Uri uri, String selection, String[] selectionArgs);

  (5)public abstract String getType (Uri uri);

  (6)public abstract boolean onCreate ();

  其中,query()方法用于将查询到的数据以Cursor对象的形式返回;insert()方法用于向Content Provider中插入新数据记录,该方法中的第二个参数ContentValues对象表示数据记录的列名和列值的映射;update()方法用于更新Content Provider中的已存在的数据记录;delete()方法用于从Content Provider中删除数据记录;getType()方法用于返回Content Provider中数据的(MIME)类型;onCreate()方法当Content Provider启动时被调用。

  以上的6个方法将会在ContentResolver对象中被调用,所以很好的实现这些抽象方法就会为ContentResolver提供一个完善的外部接口。

  当然了,你可以根据自己应用程序的需要,有选择的实现上述6个方法,比如,你可以只实现query()方法,这样别的应用程序就自能对你提供的Content Provider进行查询操作,而无法对你提供的Content Provider进行添加、删除等操作,从而保证了数据的安全性。

  如下的代码实现了query()方法。

1     /*
2      * Function  :    查询方法
3      * Author    :    博客园-依旧淡然
4      */
5     public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
6         db = mySQLiteOpenHelper.getWritableDatabase();
7         Cursor cursor = db.query("tab_student", projection, selection, selectionArgs, null, null, sortOrder);
8         return cursor;
9     }

  可以看出,查询的核心其实还是调用SQLiteDatabase类提供的query()方法,将查询到的结果存储在Cursor对象中,最后直接将Cursor对象返回即可。

  此外,在继承自ContentProvider类的“StudentContentProvider”中,我们还需要做一件很重要的事,那就是指定Content Provider的URI。该URI必须是唯一的,不能和系统的URI相同,更不能与其他应用程序提供的Content Provider的URI相同。

  这里我定义了Content Provider的URI为“content://com.example.sqlite.studentProvider/student”。

3.3声明Content Provider的权限

  创建好的Content Provider必须在应用程序的AndroidManifest.xml文件中进行声明,否则,该Content Provider对于Android系统是不可见的。

  具体的声明方式如下:

1     <!-- 声明内容提供者 -->
2     <provider                    
      android:name="com.example.android_datastorage_sqlite.provider.StudentContentProvider" 3 android:authorities="com.example.sqlite.studentProvider" > 4 </provider>

  其中,<provider></provider>标签位于<application></application>标签下。android:name属性用于指明StudentContentProvider的全称类名,android:authorities属性唯一的标识了一个Content Provider。

  至此,我们便在该工程中创建了自己的Content Provider,并提供了query()方法供别的应用程序查询该工程中的SQLite数据表。

3.4验证

  在应用程序Android_DataStorage_SQLite的SQLite数据表中,我们添加了3条记录,如图4所示。

Android学习笔记37:使用Content Providers方式共享数据_第4张图片
图4 SQLite数据表信息

  新建一个应用程序Android_DataStorage_ContentProviders,用来获取自定义的Content Provider内容。获取自定义的Content Provider内容的方法,和前面讲的获取联系人应用程序的Content Provider内容的方法类似。使用自定义的Content Provider的URI,并查询数据表中相应的字段即可。可以看到查询到的信息如图5所示。

Android学习笔记37:使用Content Providers方式共享数据_第5张图片

图5 查询自定义的Content Provider内容

  可以看出,在应用程序Android_DataStorage_ContentProviders中确实访问到了应用程序Android_DataStorage_SQLite中的数据表信息,通过Content Provider方式实现了数据在应用程序之间的共享。

你可能感兴趣的:(Provider,content)