首页 > 代码库 > ContentPriver
ContentPriver
共享应用程序内的数据, 在数据修改时可以监听
1、特点
①、可以将应用中的数据对外进行共享；
②、数据访问方式统一，不必针对不同数据类型采取不同的访问策略；
③、内容提供者将数据封装，只暴露出我们希望提供给其他程序的数据（这点有点类似Javabeans）；
④、内容提供者中数据更改可被监听；
2、创建内容提供者
- 定义类继承ContentProvider，根据需要重写其内容方法(6个方法)：
l onCreate() 创建内容提供者时，会调用这个方法，完成一些初始化操作；
l crud相应的4个方法 用于对外提供CRUD操作；
l getType() 返回当前Url所代表数据的MIME类型：
返回的是单条记录：以vnd.android.cursor.item/ 开头，如：vnd.android.cursor.item/person
返回的是多条记录：以vnd.android.cursor.dir/ 开头，如：vnd.android.cursor.dir/person
- 在清单文件的<application>节点下进行配置，<provider>标签中需要指定name、authorities、exported属性
l name： 为全类名；
l authorities： 是访问Provider时的路径，要唯一；
l exported： 用于指示该服务是否能够被其他应用程序组件调用或跟它交互
- URI代表要操作的数据，由scheme、authorites、path三部分组成：
l content://com.itheima.sqlite.provider/person
l scheme： 固定为content，代表访问内容提供者；
l authorites： <provider>节点中的authorites属性；
l path： 程序定义的路径，可根据业务逻辑定义；
- 操作 URI的UriMather与ContentUris工具类：
当程序调用CRUD方法时会传入Uri
l UriMatcher：表示URI匹配器，可用于添加Uri匹配模式，与匹配Uri（见下代码）；
l ContentUris：用于操作Uri路径后面的ID部分,2个重要的方法：
- withAppendedId(uri, id) 为路径加上ID部分；
- parseId(uri) 用于从路径中获取ID部分；
示例代码（内容提供者类）：
public class HeimaProvider extends ContentProvider {
private static final int PERSON = 1; // 匹配码
private static final int STUDENT = 2; // 匹配码
private static final int PERSON_ID = 3; // 匹配码
private MyHelper helper;
/** Uri匹配器 */
private UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
@Override
public boolean onCreate() {
System.out.println("onCreate...");
helper = new MyHelper(getContext());
// == 添加 uri 匹配模式, 设置匹配码（参数3） Uri如果匹配就会返回相应的匹配码 ==
uriMatcher.addURI("com.itheima.sqlite.provider", "person", PERSON);
uriMatcher.addURI("com.itheima.sqlite.provider", "#", PERSON_ID); // #表示匹配数字，*表示匹配文本
uriMatcher.addURI("com.itheima.sqlite.provider", "student", STUDENT);
return true;
}
@Override
public Uri insert(Uri uri, ContentValues values) {
SQLiteDatabase db = helper.getWritableDatabase();
switch (uriMatcher.match(uri)) { // 匹配uri
case PERSON:
long id = db.insert("person", "id", values);
db.close();
return ContentUris.withAppendedId(uri, id); // 在原uri上拼上id，生成新的uri并返回；
case STUDENT:
long insert = db.insert("student", "id", values);
System.out.println("数据文件中，没有student表，也不会报错");
db.close();
return ContentUris.withAppendedId(uri, insert); // 为路径上，加上ID
default:
throw new IllegalArgumentException(String.format("Uri：%s 不是合法的uri地址", uri));
}
}
@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
SQLiteDatabase db = helper.getWritableDatabase();
switch (uriMatcher.match(uri)) { // 匹配uri
case PERSON_ID:
long parseId = ContentUris.parseId(uri); // 获取传过来的ID值
selection = "id=?"; // 设置查询条件
selectionArgs = new String[] { parseId + "" }; // 查询条件值
case PERSON:
int delete = db.delete("person", selection, selectionArgs);
db.close();
return delete;
default:
throw new IllegalArgumentException(String.format("Uri：%s 不是合法的uri地址", uri));
}
}
@Override
public int update(Uri uri, ContentValues values, String selection, String[] selectionArgs) {
SQLiteDatabase db = helper.getWritableDatabase();
switch (uriMatcher.match(uri)) {
case PERSON_ID:
long parseId = ContentUris.parseId(uri); // 获取传过来的ID值
selection = "id=?"; // 设置查询条件
selectionArgs = new String[] { parseId + "" }; // 查询条件值
case PERSON:
int update = db.update("person", values, selection, selectionArgs);
db.close();
return update;
default:
throw new IllegalArgumentException(String.format("Uri：%s 不是合法的uri地址", uri));
}
}
@Override
public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) {
SQLiteDatabase db = helper.getWritableDatabase();
switch (uriMatcher.match(uri)) {
case PERSON_ID:
// == 根据ID查询 ==
long parseId = ContentUris.parseId(uri); // 获取传过来的ID值
selection = "id=?"; // 设置查询条件
selectionArgs = new String[] { parseId + "" }; // 查询条件值
case PERSON:
Cursor cursor = db.query("person", projection, selection, selectionArgs, null, null, sortOrder);
// == 注意：此处的 db与cursor不能关闭 ==
return cursor;
default:
throw new IllegalArgumentException(String.format("Uri：%s 不是合法的uri地址", uri));
}
}
// 返回传入URI的类型，可用于测试URI是否正确
@Override
public String getType(Uri uri) {
switch (uriMatcher.match(uri)) {
case PERSON_ID:
return "vnd.android.cursor.item/person"; // 表示单条person记录
case PERSON:
return "vnd.android.cursor.dir/person"; // 表单多个person记录
default:
return null;
}
}
}
清单中的配置：
<provider
android:exported="true"
android:name="com.itheima.sqlite.provider.HeimaProvider"
android:authorities="com.itheima.sqlite.provider" />
authorities 可以配置成如下形式（系统联系人的）：
android:authorities="contacts;com.android.contacts"
“;” 表示的是可使用 contacts, 与 com.android.contacts
3、内容解析者ContentResolver
? 通过Context获得ContentResolver内容访问者对象（内容提供者的解析器对象）；
? 调用ContentResolver对象的方法即可访问内容提供者
测试类代码：
public class HeimaProviderTest extends AndroidTestCase {
/** 测试添加数据 */
public void testInsert() {
ContentResolver resolver = this.getContext().getContentResolver();
Uri uri = Uri.parse("content://com.itheima.sqlite.provider/person");
ContentValues values = new ContentValues();
values.put("name", "小翼");
values.put("balance", 13000);
Uri insert = resolver.insert(uri, values); // 获取返回的uri，如：content://com.itheima.sqlite.provider/7
System.out.println(insert);
}
/** 测试删除 */
public void testRemove() {
ContentResolver resolver = this.getContext().getContentResolver();
Uri uri = Uri.parse("content://com.itheima.sqlite.provider/person");
int count = resolver.delete(uri, "id=?", new String[] { 3 + "" });
System.out.println("删除了" + count + "行");
}
/** 测试更新 */
public void testUpdate() {
ContentResolver resolver = this.getContext().getContentResolver();
Uri uri = Uri.parse("content://com.itheima.sqlite.provider/person");
ContentValues values = new ContentValues();
values.put("name", "小赵 update");
values.put("balance", 56789);
int update = resolver.update(uri, values, "id=?", new String[] { 6 + "" });
System.out.println("更新了" + update + "行");
}
/** 测试查询 */
public void testQueryOne() {
ContentResolver resolver = this.getContext().getContentResolver();
Uri uri = Uri.parse("content://com.itheima.sqlite.provider/person");
Cursor c = resolver.query(uri, new String[] { "name", "balance" }, "id=?", new String[] { 101 + "" }, null);
if (c.moveToNext()) {
System.out.print(c.getString(0));
System.out.println(" " + c.getInt(1));
}
c.close();
}
/**测试查询全部 */
public void testQueryAll() {
ContentResolver resolver = this.getContext().getContentResolver();
Uri uri = Uri.parse("content://com.itheima.sqlite.provider/person");
Cursor c = resolver.query(uri, new String[] { "id", "name", "balance" }, null, null, "name desc");
while (c.moveToNext()) {
System.out.println(c.getInt(0) + ", " + c.getString(1) + ", " + c.getInt(2));
}
c.close();
}
/** 测试查询一条 */
public void testQueryOneWithUriId() {
ContentResolver resolver = this.getContext().getContentResolver();
Uri uri = Uri.parse("content://com.itheima.sqlite.provider/3"); // 查询ID为3的记录
Cursor c = resolver.query(uri, new String[] { "id", "name", "balance" }, null, null, null);
if (c.moveToNext()) {
System.out.println(c.getInt(0) + ", " + c.getString(1) + ", " + c.getInt(2));
}
c.close();
}
/** 测试获取内容提供者的返回类型 */
public void testGetType() {
ContentResolver resolver = this.getContext().getContentResolver();
System.out.println(resolver.getType(Uri.parse("content://com.itheima.sqlite.provider/2")));
System.out.println(resolver.getType(Uri.parse("content://com.itheima.sqlite.provider/person")));
}
}
4、监听内容提供者的数据变化
? 在内容提供者中可以通知其他程序数据发生变化
通过Context的getContentResolver()方法获取ContentResolver
调用其notifyChange()方法发送数据修改通知，发送到系统的公共内存（消息信箱中）
? 在其他程序中可以通过ContentObserver监听数据变化
通过Context的getContentResolver()方法获取ContentResolver
调用其registerContentObserver()方法指定对某个Uri注册ContentObserver
自定义ContentObserver，重写onChange()方法获取数据
示例代码（发通知部分）：
public int delete(Uri uri, String selection, String[] selectionArgs) {
SQLiteDatabase db = helper.getWritableDatabase();
int delete = db.delete("person", selection, selectionArgs);
// == 通过内容访问者对象ContentResolve 发通知给所有的Observer ==
getContext().getContentResolver().notifyChange(uri, null);
db.close();
return delete;
}
}
监听部分：
// 注册内容观察者事件
private void initRegisterContentObserver() {
Uri uri = Uri.parse("content://com.itheima.sqlite.provider"); // 监听的URI
// == 第2个参数：true表示监听的uri的后代都可以监听到 ==
getContentResolver().registerContentObserver(uri, true, new ContentObserver(new Handler()) {
public void onChange(boolean selfChange) { // 接到通知就执行
personList = personDao.queryAll();
((BaseAdapter) personListView.getAdapter()).notifyDataSetChanged();
}
});
}
5、区别Provider/Resolver/Observer
1）ContentProvider：内容提供者
把一个应用程序的私有数据（如数据库）信息暴露给别的应用程序，让别的应用程序可以访问；
在数据库中有对应的增删改查的方法，如果要让别的应用程序访问，需要有一个路径uri：
通过content:// 路径对外暴露，uri写法：content://主机名/表名
2）ContentResolver：内容解析者
根据内容提供者的路径，对数据进行操作（crud）；
3）ContentObserver：内容观察者
可以理解成android系统包装好的回调，数据发送变化时，会执行回调中的方法；
ContentResolver发送通知，ContentObserver监听通知；
当A的数据发生变化的时候，A就会显示的通知一个内容观察者，不指定观察者，就会发消息给一个路径
ContentPriver