第3章 ContentProvider 定制与跨进程数据共享

3.1 核心原理

ContentProvider 是 Android 四大组件之一，用于在不同进程之间提供结构化数据访问接口。其本质是一个 Binder 驱动的 IPC 桥梁——服务端 Provider 将数据暴露给客户端，客户端通过 ContentResolver 发起跨进程查询，Binder 线程池负责序列化/反序列化与线程调度。

3.2 实现流程

自定义 ContentProvider 的完整步骤分为以下五个阶段：

3.3 代码实现与配置

3.3.1 URI 匹配与 Matcher 初始化

public class BookProvider extends ContentProvider {
    private static final String AUTHORITY = "com.example.library.provider";
    private static final int CODE_BOOKS = 100;
    private static final int CODE_BOOK_ID = 101;
    private static final UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);

    static {
        uriMatcher.addURI(AUTHORITY, "books", CODE_BOOKS);
        uriMatcher.addURI(AUTHORITY, "books/#", CODE_BOOK_ID);
    }

    @Override
    public Cursor query(Uri uri, String[] projection, String selection,
                        String[] selectionArgs, String sortOrder) {
        int code = uriMatcher.match(uri);
        if (code == UriMatcher.NO_MATCH) throw new IllegalArgumentException("Unknown URI " + uri);
        // 根据 code 分发查询逻辑
        return doQuery(code, uri, projection, selection, selectionArgs, sortOrder);
    }
}

3.3.2 权限声明（Manifest 片段）

<permission android:name="com.example.library.provider.READ_BOOKS"
    android:protectionLevel="signatureOrSystem"/>
<permission android:name="com.example.library.provider.WRITE_BOOKS"
    android:protectionLevel="signature"/>

<provider
    android:name=".BookProvider"
    android:authorities="com.example.library.provider"
    android:readPermission="com.example.library.provider.READ_BOOKS"
    android:writePermission="com.example.library.provider.WRITE_BOOKS"
    android:exported="true" />

3.3.3 客户端调用示例

ContentResolver resolver = context.getContentResolver();
Uri booksUri = Uri.parse("content://com.example.library.provider/books");
Cursor cursor = resolver.query(booksUri, null, null, null, null);
if (cursor != null) {
    while (cursor.moveToNext()) {
        String title = cursor.getString(cursor.getColumnIndex("title"));
        // 处理数据
    }
    cursor.close();
}

3.4 跨进程调试命令

# 查看当前所有 ContentProvider 的状态（包括调用的信息）
adb shell dumpsys provider

# 仅检查特定 authority 的 provider
adb shell dumpsys provider com.example.library.provider

# 模拟权限不足时的访问（通过 shell 以非签名身份调用）
adb shell am broadcast -a android.intent.action.PROVIDER_EXAMPLE

3.5 性能优化要点

• 使用 CursorWindow：query 时尽量返回 Cursor 而非手动序列化列表，系统会自动利用共享内存区域，减少跨进程拷贝。
• 批量操作：实现 ContentProvider.applyBatch() 将多次插入/更新合并为一个 Binder 事务。
• 通知观察者精简：仅在数据真正修改时调用 getContext().getContentResolver().notifyChange(uri, null)，避免频繁唤醒客户端。
• 线程池隔离：Provider 默认运行在 Binder 线程池，长耗时操作（如文件读写）应切换到后台 HandlerThread，防止阻塞其他 IPC 请求。

3.6 常见错误与解决

3.7 知识结构图：ContentProvider 跨进程流程

3.8 稳定性与上线检查清单

• ✅ 所有 URI 路径已在 UriMatcher 中注册，且未遗漏 # 通配符。
• ✅ 权限保护级别与实际签名环境匹配（debug 签名可用 dangerous 临时测试，release 切回 signature）。
• ✅ 实现 shutdown() 方法释放数据库连接，防止 provider 销毁时泄露。
• ✅ 关键操作（如批量插入）使用事务 db.beginTransaction() 确保原子性。
• ✅ 客户端异步调用 AsyncQueryHandler 避免主线程阻塞。