Android 内容提供器（Content Provider）
一、内容提供器（Content Provider）简介
内容提供器（Content Provider）主要用于在不同的应用程序之间实现数据共享的功能，它提供了一套完整的机制，允许一个程序访问另一个程序中的数据，同时还能保证被访数据的安全性。目前，使用内容提供器是Android实现跨程序共享数据的标准方式。
内容提供器的用法一般有两种，一种是使用现有的内容提供器来读取和操作相应程序中的数据，另一种是创建自己的内容提供器给我们程序的数据提供外部访问接口。
二、访问其他程序中的数据
对于每一个应用程序来说，如果想要访问内容提供器*享的数据，就一定要借助ContentResolve类，可以通过Context中的getContentResolver()方法获取到该类的实例。ContentResolver中提供了一系列的方法用于对数据进行CRUD操作，其中insert()方法用于添加数据，update()方法用于更新数据，delete()方法用于删除数据，query()方法用于查询数据。ContentResolver中的增删改查方法都是不接收表名参数的，而是使用一个内容Uri参数代替。它由权限（authority）和路径（path）组成。权限采用程序包名的方式来进行命名，路径则是用于对同一应用程序中不同的表做区分的，通常都会添加到权限的后面。内容URI最标准的格式写法如下：
content://com.example.app.provider/table1/[1]
协议声明+权限（包名）+路径（表名+[ID]）
我们可以使用通配符的方式来分别匹配这两种格式的内容URI，规则如下。
1. *：表示匹配任意长度的任意字符
2. #：表示匹配任意长度的数字
所以，一个能够匹配任意表的内容URI格式就可以写成：
content://com.example.app.provider/*
而一个能够匹配table1表中任意一行数据的内容URI格式就可以写成：
content://com.example.app.provider/table1/#
在得到了内容URI字符串之后，我们还需要将它解析成Uri对象才可以作为参数传入。
Uri uri = Uri.parse("content://com.example.app.provider/table1")
1.查询例子：
Cursor cursor = getContentResolver().query( uri, projection, selection,
selectionArgs, sortOrder);
取出数据
if (cursor != null) {
while (cursor.moveToNext()) {
String column1 = cursor.getString(cursor.getColumnIndex("column1"));
int column2 = cursor.getInt(cursor.getColumnIndex("column2"));
}
cursor.close();
}
query()方法参数 |
对应SQL部分 |
描述 |
uri |
from table_name |
指定查询某个应用程序下的某一张表 |
projection |
select column1, column2 |
指定查询的列名 |
selection |
where column = value |
指定where的约束条件 |
selectionArgs |
- |
为where中的占位符提供具体的值 |
orderBy |
order by column1, column2 |
指定查询结果的排序方式 |
2.添加数据
ContentValues values = new ContentValues();
values.put("column1", "text");
values.put("column2", 1);
getContentResolver().insert(uri, values);
3.更新数据
ContentValues values = new ContentValues();
values.put("column1", "");
getContentResolver().update(uri, values, "column1 = ? and column2 = ?", new String[] {"text", "1"});
4.删除数据
getContentResolver().delete(uri, "column2 = ?", new String[] { "1" });
5.读取系统联系人例子
权限： <uses-permission android:name="android.permission.READ_CONTACTS" />
contactsView = (ListView) findViewById(R.id.contacts_view);
adapter = new ArrayAdapter<String>(this,
android.R.layout.simple_list_item_1, contactsList);
contactsView.setAdapter(adapter);
readContacts();
函数：
private void readContacts() {
Cursor cursor = null;
try {
// 查询联系人数据
cursor = getContentResolver().query(ContactsContract.CommonDataKinds.Phone.CONTENT_URI, null,
null, null, null);
while (cursor.moveToNext()) {
// 获取联系人姓名
String displayName = cursor
.getString(cursor
.getColumnIndex(ContactsContract.CommonDataKinds.Phone.DISPLAY_NAME));
// 获取联系人手机号
String number = cursor
.getString(cursor
.getColumnIndex(ContactsContract.CommonDataKinds.Phone.NUMBER));
contactsList.add(displayName + "\n" + number);
}
} catch (Exception e) {
e.printStackTrace();
} finally {
if (cursor != null) {
cursor.close();
}
}
}
三、创建自己的内容提供器
新建一个类去继承ContentProvider的方式来创建一个自己的内容提供器。
public class MyProvider extends ContentProvider {
public static final int TABLE1_DIR = 0;
public static final int TABLE1_ITEM = 1;
public static final int TABLE2_DIR = 2;
public static final int TABLE2_ITEM = 3;
private static UriMatcher uriMatcher;
/*UriMatcher中提供了一个addURI()方法，这个方法接收三个参数，可以分别把权限、路径和一个自定义代码传进去。这样，当调用UriMatcher的match()方法时，就可以将一个Uri对象传入，返回值是某个能够匹配这个Uri对象所对应的自定义代码，利用这个代码，我们就可以判断出调用方期望访问的是哪张表中的数据了。*/
static {
uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI("com.example.app.provider", "table1", TABLE1_DIR);
uriMatcher.addURI("com.example.app.provider ", "table1/#", TABLE1_ITEM);
uriMatcher.addURI("com.example.app.provider ", "table2", TABLE2_ITEM);
uriMatcher.addURI("com.example.app.provider ", "table2/#", TABLE2_ITEM);
}
@Override
public boolean onCreate() {
return false;
}
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
switch (uriMatcher.match(uri)) {
case TABLE1_DIR:
// 查询table1表中的所有数据
break;
case TABLE1_ITEM:
// 查询table1表中的单条数据
break;
case TABLE2_DIR:
// 查询table2表中的所有数据
break;
case TABLE2_ITEM:
// 查询table2表中的单条数据
break;
default:
break;
}
……
}
@Override
public Uri insert(Uri uri, ContentValues values) {
return null;
}
@Override
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
return 0;
}
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
return 0;
}
@Override
public String getType(Uri uri) {
switch (uriMatcher.match(uri)) {
case TABLE1_DIR:
return "vnd.android.cursor.dir/vnd.com.example.app.provider. table1";
case TABLE1_ITEM:
return "vnd.android.cursor.item/vnd.com.example.app.provider. table1";
case TABLE2_DIR:
return "vnd.android.cursor.dir/vnd.com.example.app.provider. table2";
case TABLE2_ITEM:
return "vnd.android.cursor.item/vnd.com.example.app.provider. table2";
default:
break;
}
return null;
}
}
1. onCreate()
初始化内容提供器的时候调用。通常会在这里完成对数据库的创建和升级等操作，返回true表示内容提供器初始化成功，返回false则表示失败。注意，只有当存在ContentResolver尝试访问我们程序中的数据时，内容提供器才会被初始化。
2. query()
从内容提供器中查询数据。使用uri参数来确定查询哪张表，projection参数用于确定查询哪些列，selection和selectionArgs参数用于约束查询哪些行，sortOrder参数用于对结果进行排序，查询的结果存放在Cursor对象中返回。
3. insert()
向内容提供器中添加一条数据。使用uri参数来确定要添加到的表，待添加的数据保存在values参数中。添加完成后，返回一个用于表示这条新记录的URI。
4. update()
更新内容提供器中已有的数据。使用uri参数来确定更新哪一张表中的数据，新数据保存在values参数中，selection和selectionArgs参数用于约束更新哪些行，受影响的行数将作为返回值返回。
5. delete()
从内容提供器中删除数据。使用uri参数来确定删除哪一张表中的数据，selection和selectionArgs参数用于约束删除哪些行，被删除的行数将作为返回值返回。
6. getType()
根据传入的内容URI来返回相应的MIME类型。
一个内容URI所对应的MIME字符串主要由三部分组分，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.app.provider.table1
对于content://com.example.app.provider/table1/1这个内容URI，它所对应的MIME类型就可以写成：
vnd.android.cursor.item/vnd. com.example.app.provider.table1
四、实现跨程序数据共享
待编辑