了解 ContentProvider 中 Uri 的奥秘：创建、匹配和 ID 操作

2023-11-29 22:02:37

Uri：ContentProvider 中的数据导航灯塔

在浩瀚的 Android 应用开发海洋中，ContentProvider 犹如一艘不可或缺的利器，承载着数据共享和管理的重任。而 Uri（Uniform Resource Identifier） ，则是 ContentProvider 中至关重要的导航灯塔，指引着我们通往数据之门的正确路径。

扬帆启航：创建 Uri

Uri 是一个字符串，用于标识资源。在 ContentProvider 中，Uri 不仅指定了要访问的数据集，还包含指向特定数据项的 id。

创建 Uri 有两种方式：

使用 Uri.parse() 方法解析字符串，格式为 content://authority/path/id。
使用 Uri.Builder 类逐个部分构建 Uri，设置权限、路径和查询参数。

航行途中：使用 ContentUris 操作 id

ContentUris 是一个工具类，用于操作 Uri 中的 id 部分。最常用的方法是 withAppendedId() ，可以在 Uri 末尾附加一个 id。

到达目的地：UriMatcher 匹配 Uri

UriMatcher 允许我们根据 Uri 的模式来匹配 Uri。这在 ContentProvider 中非常有用，因为我们可以使用 UriMatcher 来确定要执行哪个操作或返回哪个数据集。

UriMatcher 使用 addURI() 方法注册要匹配的 Uri 模式，每个模式都与一个匹配码相关联。

代码示例

创建 Uri

// 使用 Uri.parse()
Uri uri = Uri.parse("content://com.example.android.contacts/contacts");

// 使用 Uri.Builder
Uri.Builder uriBuilder = new Uri.Builder();
uriBuilder.scheme("content")
        .authority("com.example.android.contacts")
        .path("contacts");
Uri uri = uriBuilder.build();

使用 ContentUris 操作 id

// 附加 id
Uri contactUri = ContentUris.withAppendedId(uri, 10);

使用 UriMatcher 匹配 Uri

UriMatcher uriMatcher = new UriMatcher(UriMatcher.NO_MATCH);
uriMatcher.addURI("com.example.android.contacts", "contacts", CONTACTS);
uriMatcher.addURI("com.example.android.contacts", "contacts/#", CONTACT_ID);

int match = uriMatcher.match(uri);