首页 > 代码库 > 安卓学习之数据共享、内容提供器Content Provider
安卓学习之数据共享、内容提供器Content Provider
内容提供器Content Provider 能够实现不同程序之间内容的共享。安卓提供了这样的一套机制，让一个程序访问另一个程序的数据，同时保证了安全性。
一个程序可以通过内容提供器对其数据提供外部访问接口，这样其它程序就能通过接口来访问数据。
ContentResolver
首先我们先介绍这个类。如果想要访问数据提供器中的数据，我们需要借助ContentResolver类。该对象实例可以在Context中调用getContentResolver()方法来获得。ContentResolver中提供了一系列对数据 操作的方法。ContentResolver中增删改方法不接收表名，而是使用Uri参数，称为内容URI。这个URI由2部分组成，权限authority和路径path组成。一般权限命名如：com.example.app.provider 。 路径则是对 同一个应用中不同表名的区分。 现在在一个程序中我们有2个数据库表叫table1，table2。 那么内容URI就是com.example.app.provider/table1和com.example.app.provider/table2 。我们还需要在这字符串头部加
上协议声明。那么内容URI标准写法是 : "content://com.example.app.provider/table1" 和 "content://com.example.app.provider/table2" 。
由于上述的还是字符串，我们要转化为Uri对象，可以调用Uri.parse解析。Uri uri = Uri.parse("content://com.example.app.provider/table1");
- Uri查询table1中的数据
注意ContentResolver中的query方法返回的是一个Cursor对象。 那么查询可以如下表示:
Cursor cursor = getContentResolver().query(uri, projection, selection, selectionArgs, sortOrder);
query()方法参数 对应 SQL 部分 描述
uri from table_name 指定查询某个应用程序下的某一张表
projection select column1, column2 指定查询的列名
selection where column = value 指定 where 的约束条件
selectionArgs --- 为 where 中的占位符提供具体的值
orderBy order by column1, column2 指定查询结果的排序方式
然后我们可以从cursor中取出每一行相应的数据：
if (cursor != null) { while (cursor.moveToNext()) { String column1 = cursor.getString(cursor.getColumnIndex("column1")); int column2 = cursor.getInt(cursor.getColumnIndex("column2")); } cursor.close();}
- 向table1中添加数据:
和向数据库中添加一条数据一样，通过ContentValues来实现。
ContentValues values = new ContentValues();values.put("column1", "text");values.put("column2", 1);getContentResolver().insert(uri, values);
- 更新一条数据
ContentValues values = new ContentValues();values.put("column1", "");getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new String[] {"text", "1"});
- 删除一条数据
getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });
ContentProvider
继承ContentProvider创建一个自己的内容提供器，让其它程序能够访问到当前程序的数据。ContentProvider类中有6个抽象方法。
- 在这里我们要在回顾一下URI写法和如何匹配。
content://com.example.app.provider/table1 表示访问com.example.app 这个应用的 table1 表中的数据。我们还可以在后面添加id值 content://com.example.app.provider/table1/1，表示访问的是 com.example.app 这个应用的 table1 表中 id 为 1 的数据。
内容 URI 的格式主要就只有以上两种,以路径结尾就表示期望访问该表中所有的数据,以 id 结尾就表示期望访问该表中拥有相应 id 的数据。我们可以使用通配符的方式来分别匹配这两种格式的内容 URI,规则如下。
1. *:表示匹配任意长度的任意字符
2. #:表示匹配任意长度的数字
所以,一个能够匹配任意表的内容 URI 格式就可以写成:
content://com.example.app.provider/*
而一个能够匹配 table1 表中任意一行数据的内容 URI 格式就可以写成:
content://com.example.app.provider/table1/#
这样,当调用 UriMatcher 的 match()方法时,就可以将一个 Uri 对象传入,返回值是某个能够匹配这个 Uri 对象所对应的自定义代码,利用这个代码,我们就可以判断出调用方期望访问的是哪张表中的数据了。
- getType()方法
它是所有的内容提供器都必须提供的一个方法,用于获取 Uri 对象所对应的 MIME 类型。
对应的MIME类型由3部分组成，android中对其进行了规定:
1. 必须以 vnd 开头。
2. 如果内容 URI 以路径结尾,则后接 android.cursor.dir/,如果内容 URI 以 id 结尾,则后接 android.cursor.item/。
3. 最后接上 vnd.<authority>.<path>。
对于 content://com.example.app.provider/table1 这个内容 URI,它所对应的 MIME类型就可以写成:
vnd.android.cursor.dir/vnd.com.example.provider.table1
对于 content://com.example.app.provider/table1/1 这个内容 URI,它所对应的 MIME 类型就可以写成:
vnd.android.cursor.item/vnd. com.example.app.provider.table1
- 实现一个内容提供器
package com.example.databasetest;import android.content.ContentProvider;import android.content.ContentValues;import android.content.UriMatcher;import android.database.Cursor;import android.database.sqlite.SQLiteDatabase;import android.net.Uri;import android.widget.Toast;public class DatabaseProvider extends ContentProvider { private static final int BOOK_DIR = 0; //dir is end with path private static final int BOOK_ITEM = 1; //item is end with number private static final int CATEGORY_DIR = 2; private static final int CATEGORY_ITEM = 3; private static final String AUTHORITY = "com.example.databasetest.provider"; private static UriMatcher uriMatcher; private MyDatabaseHelper dbHelper; static { uriMatcher = new UriMatcher(UriMatcher.NO_MATCH); uriMatcher.addURI(AUTHORITY, "book", BOOK_DIR); uriMatcher.addURI(AUTHORITY, "book/#", BOOK_ITEM); uriMatcher.addURI(AUTHORITY, "category", CATEGORY_DIR); uriMatcher.addURI(AUTHORITY, "category/#", CATEGORY_ITEM); } @Override public boolean onCreate() { //Toast.makeText(getContext(), "Provider create", Toast.LENGTH_SHORT).show(); dbHelper = new MyDatabaseHelper(getContext(), "BookStore.db", null, 2); return true; } @Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { // TODO Auto-generated method stub SQLiteDatabase db = dbHelper.getReadableDatabase(); Cursor cursor = null; switch (uriMatcher.match(uri)) { case BOOK_DIR: cursor = db.query("book", projection, selection, selectionArgs, null, null, sortOrder); break; case BOOK_ITEM: String bookId = uri.getPathSegments().get(1); cursor = db.query("book", projection, "id = ?", new String[]{bookId}, null, null, sortOrder); break; case CATEGORY_DIR: cursor = db.query("category", projection, selection, selectionArgs, null, null, sortOrder); break; case CATEGORY_ITEM: String categoryId = uri.getPathSegments().get(1); cursor = db.query("category", projection, "id = ?", new String[] {categoryId}, null, null, sortOrder); break; default: break; } return cursor; } @Override public String getType(Uri uri) { // TODO Auto-generated method stub switch (uriMatcher.match(uri)) { case BOOK_DIR: return "vnd.android.cursor.dir/vnd.com.example.databasetest.provider.book"; case BOOK_ITEM: return "vnd.android.cursor.item/vnd.com.example.databasetest.provider.book"; case CATEGORY_DIR: return "vnd.android.cursor.dir/vnd.com.example.databasetest.provider.category"; case CATEGORY_ITEM: return "vnd.android.cursor.item/vnd.com.example.databasetest.provider.category"; default: return null; } } @Override public Uri insert(Uri uri, ContentValues values) { // TODO Auto-generated method stub Uri uriReturn = null; SQLiteDatabase db = dbHelper.getReadableDatabase(); switch (uriMatcher.match(uri)) { case BOOK_DIR: case BOOK_ITEM: //插入都是在一张表中 long newBookId = db.insert("book", null, values); uriReturn = Uri.parse("content://" + AUTHORITY + "/book/" + newBookId); break; case CATEGORY_DIR: case CATEGORY_ITEM: long newCategoryId = db.insert("category", null, values); uriReturn = Uri.parse("content://" + AUTHORITY + "/category/" + newCategoryId); break; default: break; } return uriReturn; } @Override public int delete(Uri uri, String selection, String[] selectionArgs) { // TODO Auto-generated method stub int deleteRows = 0; SQLiteDatabase db = dbHelper.getReadableDatabase(); switch (uriMatcher.match(uri)) { case BOOK_DIR: deleteRows = db.delete("book", selection, selectionArgs); break; case BOOK_ITEM: String bookId = uri.getPathSegments().get(1); deleteRows = db.delete("book", "id = ?", new String[]{bookId}); break; case CATEGORY_DIR: deleteRows = db.delete("category", selection, selectionArgs); break; case CATEGORY_ITEM: String categoryId = uri.getPathSegments().get(1); deleteRows = db.delete("category", "id = ?", new String[]{categoryId}); break; default: break; } return deleteRows; } @Override public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) { // TODO Auto-generated method stub int updateRows = 0; SQLiteDatabase db = dbHelper.getReadableDatabase(); switch (uriMatcher.match(uri)) { case BOOK_DIR: updateRows = db.update("book", values, selection, selectionArgs); break; case BOOK_ITEM: String bookId = uri.getPathSegments().get(1); updateRows = db.update("book", values, "id = ?", new String[]{bookId}); break; case CATEGORY_DIR: updateRows = db.update("category", values, selection, selectionArgs); break; case CATEGORY_ITEM: String categoryId = uri.getPathSegments().get(1); updateRows = db.update("category", values, "id = ?", new String[]{categoryId}); break; default: break; } return updateRows; }}
这是一个我写好的内容提供器，在每一个方法内，我们通过uriMacther.matcher()来匹配uri，根据匹配到的值来进行所需的操作。
之后我们要在这个程序的AndroidManifest.xml文件中注册:
<!-- :name 指定类的全名 :authorities 指定内容提供器的权限 --> <provider android:name="com.example.databasetest.DatabaseProvider" android:authorities="com.example.databasetest.provider" android:exported="true"> </provider>
注意这里要加 android:exported="true" 这个属性用于指示该服务是否能够被其他应用程序组件调用或跟它交互。
这样我们就完成了一个内容提供器，我们可以新建一个程序通过ContentReslover来访问这个内容提供器了。
到这里学习了安卓如何实现程序间数据的共享，内容提供器的创建。
安卓学习之数据共享、内容提供器Content Provider