3、ContentProvider基础：什么是ContentProvider、URI与UriMatcher、CRUD操作基础、ContentResolver的使用

好，咱们今天聊聊ContentProvider。说实话，这个组件在Android四大组件里，可能是最容易被忽视的一个。我刚入行那会儿，总觉得它就是个“数据库的包装器”，直到有一次做联系人同步功能，才真正体会到它的价值。

ContentProvider说白了，就是一套跨进程数据共享的标准化接口。你想想看，你的App里存了一堆联系人数据，别的App想读怎么办？直接访问数据库？那不安全，也不符合Android的沙箱机制。ContentProvider就是干这个的——它把你的数据“包装”起来，对外提供统一的增删改查入口。

3.1 什么是ContentProvider

ContentProvider是Android四大组件之一，它的核心使命是：让一个应用的数据可以被其他应用访问。我习惯把它理解成“数据中间人”——你的数据存在SQLite里也好，存在文件里也罢，甚至是从网络获取的实时数据，ContentProvider都能帮你封装成统一的接口。

核心要点：

  • ContentProvider本身不存储数据，它只是数据的“搬运工”
  • 它通过URI来定位数据，就像用URL定位网页一样
  • 它提供了CRUD四个基本操作：增(Create)、查(Read)、改(Update)、删(Delete)
  • 它自动处理跨进程通信（IPC），你不需要关心Binder细节

我记得有一次，一个同事问我：“为什么不用直接暴露数据库文件路径？”我反问他：“你敢把你的银行卡密码写在纸条上贴门口吗？”ContentProvider就是那个带锁的保险箱，你只给需要的人开门的权限。

3.2 URI与UriMatcher

URI（统一资源标识符）是ContentProvider的“门牌号”。它的格式长这样：

content://authority/path/id

拆开来看：

  • content://：固定前缀，表示这是一个ContentProvider的URI
  • authority：唯一标识，通常是包名+类名，比如com.example.contacts.provider
  • path：路径，表示要操作的数据表或数据集合
  • id：可选，表示具体某一条数据

举个例子：

content://com.android.contacts/contacts          // 所有联系人
content://com.android.contacts/contacts/1        // 第1个联系人
content://com.android.contacts/contacts/2/phone  // 第2个联系人的电话

嗯，这里要注意：URI的路径设计是有讲究的。我见过有人把所有数据都放在一个路径下，然后用参数区分，结果维护起来特别痛苦。我的建议是：按数据实体分路径，按ID定位具体记录。

UriMatcher：URI的“路由器”

UriMatcher是Android提供的一个工具类，用来匹配URI。说白了，就是根据URI的不同，决定执行哪个操作。

// 定义匹配码
private static final int CONTACTS = 1;
private static final int CONTACT_ID = 2;

// 初始化UriMatcher
private static final UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);

static {
    uriMatcher.addURI("com.example.contacts.provider", "contacts", CONTACTS);
    uriMatcher.addURI("com.example.contacts.provider", "contacts/#", CONTACT_ID);
}

// 在query方法中使用
@Override
public Cursor query(Uri uri, String[] projection, String selection,
                    String[] selectionArgs, String sortOrder) {
    switch (uriMatcher.match(uri)) {
        case CONTACTS:
            // 查询所有联系人
            break;
        case CONTACT_ID:
            // 查询单个联系人
            String id = uri.getLastPathSegment();
            break;
        default:
            throw new IllegalArgumentException("Unknown URI: " + uri);
    }
}

我的经验：UriMatcher的匹配规则里，#代表数字，*代表任意文本。我建议尽量用#来匹配ID，因为ID通常是数字，这样更精确，不容易误匹配。

3.3 CRUD操作基础

CRUD是ContentProvider的四个核心操作。我习惯把它们叫做“数据四件套”。咱们一个一个来看。

查询（Query）

@Override
public Cursor query(Uri uri, String[] projection, String selection,
                    String[] selectionArgs, String sortOrder) {
    SQLiteDatabase db = dbHelper.getReadableDatabase();
    String tableName = getTableName(uri);
    return db.query(tableName, projection, selection, selectionArgs, null, null, sortOrder);
}

插入（Insert）

@Override
public Uri insert(Uri uri, ContentValues values) {
    SQLiteDatabase db = dbHelper.getWritableDatabase();
    String tableName = getTableName(uri);
    long id = db.insert(tableName, null, values);
    // 通知数据变化
    getContext().getContentResolver().notifyChange(uri, null);
    return ContentUris.withAppendedId(uri, id);
}

更新（Update）

@Override
public int update(Uri uri, ContentValues values, String selection,
                  String[] selectionArgs) {
    SQLiteDatabase db = dbHelper.getWritableDatabase();
    String tableName = getTableName(uri);
    int count = db.update(tableName, values, selection, selectionArgs);
    if (count > 0) {
        getContext().getContentResolver().notifyChange(uri, null);
    }
    return count;
}

删除（Delete）

@Override
public int delete(Uri uri, String selection, String[] selectionArgs) {
    SQLiteDatabase db = dbHelper.getWritableDatabase();
    String tableName = getTableName(uri);
    int count = db.delete(tableName, selection, selectionArgs);
    if (count > 0) {
        getContext().getContentResolver().notifyChange(uri, null);
    }
    return count;
}

我曾经踩过的坑：在insert和delete操作后，一定要调用notifyChange()通知数据变化。否则，使用ContentObserver监听数据的UI不会自动刷新。有一次我调试了半天，发现数据明明写进去了，界面就是不更新，最后发现是忘了通知。

3.4 ContentResolver的使用

ContentResolver是ContentProvider的“客户端”。你的App不需要直接和ContentProvider打交道，而是通过ContentResolver来调用它。我习惯把ContentResolver比作“遥控器”——你按按钮（调用方法），电视（ContentProvider）执行操作。

使用方式很简单：

// 获取ContentResolver
ContentResolver resolver = getContentResolver();

// 查询联系人
Uri uri = ContactsContract.Contacts.CONTENT_URI;
Cursor cursor = resolver.query(uri, null, null, null, null);

if (cursor != null) {
    while (cursor.moveToNext()) {
        String name = cursor.getString(cursor.getColumnIndex(ContactsContract.Contacts.DISPLAY_NAME));
        Log.d("Contact", "Name: " + name);
    }
    cursor.close();
}

// 插入新联系人
ContentValues values = new ContentValues();
values.put(ContactsContract.Contacts.DISPLAY_NAME, "张三");
Uri newUri = resolver.insert(uri, values);

// 更新联系人
values.put(ContactsContract.Contacts.DISPLAY_NAME, "李四");
resolver.update(newUri, values, null, null);

// 删除联系人
resolver.delete(newUri, null, null);

你可能会问：“为什么不用直接操作数据库？”原因有三：

  1. 安全性：ContentProvider可以控制访问权限，比如只读、只写、需要特定权限等
  2. 统一性：不管数据存在哪里，对外接口都一样
  3. 跨进程：ContentProvider自动处理跨进程通信，你不需要写Binder代码

我的建议：在操作Cursor时，一定要记得关闭。我习惯用try-finally或者Kotlin的use块来确保Cursor被正确释放。否则，Cursor泄漏会导致内存问题，严重时还会触发StaleDataException。

知识体系总览

下面这张图，是我梳理的ContentProvider核心知识结构。你可以把它当作学习地图：

ContentProvider 知识体系 ContentProvider URI 与 UriMatcher CRUD 操作 ContentResolver 权限控制 content:// 前缀 authority 标识 path 路径 id 标识 query insert update delete getContentResolver() query/insert/update/delete ContentObserver 监听 readPermission writePermission AndroidManifest 声明

这张图把ContentProvider拆成了四个核心模块。URI和UriMatcher负责“寻址”，CRUD负责“操作”，ContentResolver负责“调用”，权限控制负责“安全”。四者缺一不可。

好了，这一章的内容就到这里。ContentProvider是Android数据共享的基石，理解了它，你就能更好地理解联系人系统、媒体库、日历等系统级数据的运作方式。下一章咱们会深入联系人系统的具体实现，到时候这些知识都会用上。

公众号:蓝海资料掘金营，微信deep3321

← 上一章 📖 返回目录 下一章 →