尧图网站建设 
1. UriMatcher 是什么UriMatcher 是 Android 开发中一个非常实用的工具类主要用于对 URI统一资源标识符进行分类和匹配。在 Android 系统中URI 常用于标识 ContentProvider 中的数据资源而 UriMatcher 则帮助我们高效地处理这些 URI。作为一个在 Android 开发领域深耕多年的开发者我可以告诉你 UriMatcher 在以下场景特别有用当你的应用需要实现 ContentProvider 时需要处理多种不同类型的 URI 请求时需要根据不同的 URI 路径执行不同操作时2. UriMatcher 的核心工作原理2.1 URI 的结构解析在深入了解 UriMatcher 之前我们需要先理解 Android 中 URI 的标准格式。一个典型的 ContentProvider URI 通常如下所示content://com.example.app.provider/table1/123这个 URI 可以分解为以下几个部分content://- 协议头表示这是一个 ContentProvider 的 URIcom.example.app.provider- 授权Authority唯一标识 ContentProvidertable1- 路径Path表示要操作的数据表123- ID表示要操作的特定记录2.2 UriMatcher 的匹配机制UriMatcher 的工作原理其实很简单 - 它维护了一个 URI 模式与对应代码的映射表。当传入一个 URI 时UriMatcher 会尝试匹配已注册的模式并返回对应的代码。UriMatcher 支持两种通配符#- 匹配数字*- 匹配任意文本例如我们可以注册以下模式content://com.example.app.provider/table1- 匹配整个表content://com.example.app.provider/table1/#- 匹配表中的特定记录content://com.example.app.provider/table1/*- 匹配表1下的任意路径3. 如何使用 UriMatcher3.1 初始化 UriMatcher首先我们需要创建 UriMatcher 实例并注册各种 URI 模式// 创建 UriMatcher 实例NO_MATCH 表示没有匹配时的返回值 private static final UriMatcher sUriMatcher new UriMatcher(UriMatcher.NO_MATCH); // 定义匹配代码常量 private static final int CODE_TABLE1 1; private static final int CODE_TABLE1_ID 2; private static final int CODE_TABLE2 3; static { // 添加 URI 模式 sUriMatcher.addURI(com.example.app.provider, table1, CODE_TABLE1); sUriMatcher.addURI(com.example.app.provider, table1/#, CODE_TABLE1_ID); sUriMatcher.addURI(com.example.app.provider, table2, CODE_TABLE2); }3.2 在实际代码中使用 UriMatcher在 ContentProvider 的实现中我们通常会这样使用 UriMatcherOverride public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { SQLiteDatabase db mOpenHelper.getReadableDatabase(); SQLiteQueryBuilder queryBuilder new SQLiteQueryBuilder(); // 使用 UriMatcher 匹配 URI int match sUriMatcher.match(uri); switch (match) { case CODE_TABLE1: queryBuilder.setTables(table1); break; case CODE_TABLE1_ID: queryBuilder.setTables(table1); queryBuilder.appendWhere(_id uri.getLastPathSegment()); break; case CODE_TABLE2: queryBuilder.setTables(table2); break; default: throw new IllegalArgumentException(Unknown URI: uri); } Cursor cursor queryBuilder.query(db, projection, selection, selectionArgs, null, null, sortOrder); cursor.setNotificationUri(getContext().getContentResolver(), uri); return cursor; }4. UriMatcher 的高级用法4.1 处理复杂路径UriMatcher 可以处理多级路径这在需要支持复杂数据结构的场景下非常有用// 注册多级路径 sUriMatcher.addURI(com.example.app.provider, user/#/posts, CODE_USER_POSTS); sUriMatcher.addURI(com.example.app.provider, user/#/posts/#, CODE_USER_POST_DETAIL); // 使用时可以这样获取路径段 Uri uri Uri.parse(content://com.example.app.provider/user/123/posts/456); ListString pathSegments uri.getPathSegments(); // pathSegments [user, 123, posts, 456] String userId pathSegments.get(1); // 123 String postId pathSegments.get(3); // 4564.2 与 ContentUris 配合使用ContentUris 是另一个有用的工具类可以与 UriMatcher 配合使用Uri uri Uri.parse(content://com.example.app.provider/table1/123); long id ContentUris.parseId(uri); // 获取ID部分返回123 // 添加ID到URI Uri newUri ContentUris.withAppendedId( Uri.parse(content://com.example.app.provider/table1), 456); // newUri content://com.example.app.provider/table1/4565. 实际开发中的经验分享5.1 性能优化建议在 ContentProvider 的实现中UriMatcher 的匹配操作会频繁执行。以下是一些优化建议将 UriMatcher 声明为静态变量避免每次调用都重新创建和初始化使用常量定义匹配代码提高代码可读性和维护性避免过于复杂的匹配模式过多的通配符会影响匹配效率5.2 常见问题排查在实际开发中我遇到过一些 UriMatcher 相关的问题这里分享排查经验问题1匹配总是返回 NO_MATCH检查 Authority 是否完全匹配包括大小写确认路径是否注册正确检查 URI 是否被正确解析问题2通配符不按预期工作#只能匹配数字*可以匹配任意文本通配符必须位于路径段的末尾问题3多级路径匹配失败确保路径段数量与注册的模式一致使用uri.getPathSegments()调试实际路径段5.3 替代方案考虑虽然 UriMatcher 是官方提供的工具但在某些复杂场景下可能需要考虑其他方案使用正则表达式对于极其复杂的 URI 模式可以使用 Pattern 和 Matcher自定义匹配逻辑实现自己的 URI 解析和匹配逻辑第三方库如 Android-URI-Matcher 等不过在大多数情况下UriMatcher 已经足够强大且高效建议优先使用。6. 实际案例实现一个完整的 ContentProvider让我们通过一个完整的例子来展示 UriMatcher 的实际应用。假设我们要实现一个笔记应用的 ContentProviderpublic class NotesProvider extends ContentProvider { private static final String AUTHORITY com.example.notes.provider; private static final String PATH_NOTES notes; private static final String PATH_NOTE_ID notes/#; // 匹配代码 private static final int CODE_NOTES 1; private static final int CODE_NOTE_ID 2; private static final UriMatcher sUriMatcher new UriMatcher(UriMatcher.NO_MATCH); static { sUriMatcher.addURI(AUTHORITY, PATH_NOTES, CODE_NOTES); sUriMatcher.addURI(AUTHORITY, PATH_NOTE_ID, CODE_NOTE_ID); } private NotesDatabaseHelper mDbHelper; Override public boolean onCreate() { mDbHelper new NotesDatabaseHelper(getContext()); return true; } Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { SQLiteDatabase db mDbHelper.getReadableDatabase(); SQLiteQueryBuilder queryBuilder new SQLiteQueryBuilder(); queryBuilder.setTables(NotesDatabaseHelper.TABLE_NOTES); int match sUriMatcher.match(uri); switch (match) { case CODE_NOTES: // 查询所有笔记 break; case CODE_NOTE_ID: // 查询特定笔记 String id uri.getLastPathSegment(); queryBuilder.appendWhere(NotesDatabaseHelper.COLUMN_ID id); break; default: throw new IllegalArgumentException(Unknown URI: uri); } Cursor cursor queryBuilder.query(db, projection, selection, selectionArgs, null, null, sortOrder); cursor.setNotificationUri(getContext().getContentResolver(), uri); return cursor; } Override public Uri insert(Uri uri, ContentValues values) { int match sUriMatcher.match(uri); if (match ! CODE_NOTES) { throw new IllegalArgumentException(Insertion not supported for uri); } SQLiteDatabase db mDbHelper.getWritableDatabase(); long id db.insert(NotesDatabaseHelper.TABLE_NOTES, null, values); if (id -1) { return null; } getContext().getContentResolver().notifyChange(uri, null); return ContentUris.withAppendedId(uri, id); } // 其他方法实现类似... }在这个例子中我们定义了两种 URI 模式查询所有笔记和查询特定笔记在 query 方法中使用 UriMatcher 来区分不同的请求在 insert 方法中验证 URI 是否支持插入操作使用了 ContentUris 来处理 ID 相关的 URI 操作7. 测试与调试技巧7.1 单元测试 UriMatcher为了确保 UriMatcher 的正确性我们应该编写单元测试public class NotesProviderTest { Test public void testUriMatcher() { UriMatcher matcher NotesProvider.getUriMatcher(); Uri notesUri Uri.parse(content://com.example.notes.provider/notes); assertEquals(NotesProvider.CODE_NOTES, matcher.match(notesUri)); Uri noteIdUri Uri.parse(content://com.example.notes.provider/notes/123); assertEquals(NotesProvider.CODE_NOTE_ID, matcher.match(noteIdUri)); Uri unknownUri Uri.parse(content://com.example.notes.provider/unknown); assertEquals(UriMatcher.NO_MATCH, matcher.match(unknownUri)); } }7.2 使用 ADB 测试 ContentProvider我们可以通过 ADB 命令来测试 ContentProvider# 查询所有笔记 adb shell content query --uri content://com.example.notes.provider/notes # 查询特定笔记 adb shell content query --uri content://com.example.notes.provider/notes/1 # 插入新笔记 adb shell content insert --uri content://com.example.notes.provider/notes \ --bind title:s:New Note --bind content:s:This is a test note7.3 日志调试技巧在开发过程中添加适当的日志可以帮助调试 UriMatcherOverride public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { Log.d(NotesProvider, Query URI: uri.toString()); int match sUriMatcher.match(uri); Log.d(NotesProvider, Match result: match); // 其余代码... }8. 最佳实践总结根据我多年的 Android 开发经验以下是使用 UriMatcher 的最佳实践保持 URI 设计简洁避免过于复杂的 URI 结构使用常量定义为 Authority、路径和匹配代码定义常量合理使用通配符只在必要时使用#和*考虑扩展性URI 设计应考虑到未来可能的扩展充分测试编写单元测试验证各种 URI 匹配情况文档化 URI 结构为你的 ContentProvider 提供清晰的 API 文档UriMatcher 虽然是一个简单的工具但在 Android 数据共享和 ContentProvider 实现中扮演着重要角色。掌握它的使用技巧可以显著提高开发效率和代码质量。 Android UriMatcher详解：ContentProvider URI匹配实践
1. UriMatcher 是什么UriMatcher 是 Android 开发中一个非常实用的工具类主要用于对 URI统一资源标识符进行分类和匹配。在 Android 系统中URI 常用于标识 ContentProvider 中的数据资源而 UriMatcher 则帮助我们高效地处理这些 URI。作为一个在 Android 开发领域深耕多年的开发者我可以告诉你 UriMatcher 在以下场景特别有用当你的应用需要实现 ContentProvider 时需要处理多种不同类型的 URI 请求时需要根据不同的 URI 路径执行不同操作时2. UriMatcher 的核心工作原理2.1 URI 的结构解析在深入了解 UriMatcher 之前我们需要先理解 Android 中 URI 的标准格式。一个典型的 ContentProvider URI 通常如下所示content://com.example.app.provider/table1/123这个 URI 可以分解为以下几个部分content://- 协议头表示这是一个 ContentProvider 的 URIcom.example.app.provider- 授权Authority唯一标识 ContentProvidertable1- 路径Path表示要操作的数据表123- ID表示要操作的特定记录2.2 UriMatcher 的匹配机制UriMatcher 的工作原理其实很简单 - 它维护了一个 URI 模式与对应代码的映射表。当传入一个 URI 时UriMatcher 会尝试匹配已注册的模式并返回对应的代码。UriMatcher 支持两种通配符#- 匹配数字*- 匹配任意文本例如我们可以注册以下模式content://com.example.app.provider/table1- 匹配整个表content://com.example.app.provider/table1/#- 匹配表中的特定记录content://com.example.app.provider/table1/*- 匹配表1下的任意路径3. 如何使用 UriMatcher3.1 初始化 UriMatcher首先我们需要创建 UriMatcher 实例并注册各种 URI 模式// 创建 UriMatcher 实例NO_MATCH 表示没有匹配时的返回值 private static final UriMatcher sUriMatcher new UriMatcher(UriMatcher.NO_MATCH); // 定义匹配代码常量 private static final int CODE_TABLE1 1; private static final int CODE_TABLE1_ID 2; private static final int CODE_TABLE2 3; static { // 添加 URI 模式 sUriMatcher.addURI(com.example.app.provider, table1, CODE_TABLE1); sUriMatcher.addURI(com.example.app.provider, table1/#, CODE_TABLE1_ID); sUriMatcher.addURI(com.example.app.provider, table2, CODE_TABLE2); }3.2 在实际代码中使用 UriMatcher在 ContentProvider 的实现中我们通常会这样使用 UriMatcherOverride public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { SQLiteDatabase db mOpenHelper.getReadableDatabase(); SQLiteQueryBuilder queryBuilder new SQLiteQueryBuilder(); // 使用 UriMatcher 匹配 URI int match sUriMatcher.match(uri); switch (match) { case CODE_TABLE1: queryBuilder.setTables(table1); break; case CODE_TABLE1_ID: queryBuilder.setTables(table1); queryBuilder.appendWhere(_id uri.getLastPathSegment()); break; case CODE_TABLE2: queryBuilder.setTables(table2); break; default: throw new IllegalArgumentException(Unknown URI: uri); } Cursor cursor queryBuilder.query(db, projection, selection, selectionArgs, null, null, sortOrder); cursor.setNotificationUri(getContext().getContentResolver(), uri); return cursor; }4. UriMatcher 的高级用法4.1 处理复杂路径UriMatcher 可以处理多级路径这在需要支持复杂数据结构的场景下非常有用// 注册多级路径 sUriMatcher.addURI(com.example.app.provider, user/#/posts, CODE_USER_POSTS); sUriMatcher.addURI(com.example.app.provider, user/#/posts/#, CODE_USER_POST_DETAIL); // 使用时可以这样获取路径段 Uri uri Uri.parse(content://com.example.app.provider/user/123/posts/456); ListString pathSegments uri.getPathSegments(); // pathSegments [user, 123, posts, 456] String userId pathSegments.get(1); // 123 String postId pathSegments.get(3); // 4564.2 与 ContentUris 配合使用ContentUris 是另一个有用的工具类可以与 UriMatcher 配合使用Uri uri Uri.parse(content://com.example.app.provider/table1/123); long id ContentUris.parseId(uri); // 获取ID部分返回123 // 添加ID到URI Uri newUri ContentUris.withAppendedId( Uri.parse(content://com.example.app.provider/table1), 456); // newUri content://com.example.app.provider/table1/4565. 实际开发中的经验分享5.1 性能优化建议在 ContentProvider 的实现中UriMatcher 的匹配操作会频繁执行。以下是一些优化建议将 UriMatcher 声明为静态变量避免每次调用都重新创建和初始化使用常量定义匹配代码提高代码可读性和维护性避免过于复杂的匹配模式过多的通配符会影响匹配效率5.2 常见问题排查在实际开发中我遇到过一些 UriMatcher 相关的问题这里分享排查经验问题1匹配总是返回 NO_MATCH检查 Authority 是否完全匹配包括大小写确认路径是否注册正确检查 URI 是否被正确解析问题2通配符不按预期工作#只能匹配数字*可以匹配任意文本通配符必须位于路径段的末尾问题3多级路径匹配失败确保路径段数量与注册的模式一致使用uri.getPathSegments()调试实际路径段5.3 替代方案考虑虽然 UriMatcher 是官方提供的工具但在某些复杂场景下可能需要考虑其他方案使用正则表达式对于极其复杂的 URI 模式可以使用 Pattern 和 Matcher自定义匹配逻辑实现自己的 URI 解析和匹配逻辑第三方库如 Android-URI-Matcher 等不过在大多数情况下UriMatcher 已经足够强大且高效建议优先使用。6. 实际案例实现一个完整的 ContentProvider让我们通过一个完整的例子来展示 UriMatcher 的实际应用。假设我们要实现一个笔记应用的 ContentProviderpublic class NotesProvider extends ContentProvider { private static final String AUTHORITY com.example.notes.provider; private static final String PATH_NOTES notes; private static final String PATH_NOTE_ID notes/#; // 匹配代码 private static final int CODE_NOTES 1; private static final int CODE_NOTE_ID 2; private static final UriMatcher sUriMatcher new UriMatcher(UriMatcher.NO_MATCH); static { sUriMatcher.addURI(AUTHORITY, PATH_NOTES, CODE_NOTES); sUriMatcher.addURI(AUTHORITY, PATH_NOTE_ID, CODE_NOTE_ID); } private NotesDatabaseHelper mDbHelper; Override public boolean onCreate() { mDbHelper new NotesDatabaseHelper(getContext()); return true; } Override public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { SQLiteDatabase db mDbHelper.getReadableDatabase(); SQLiteQueryBuilder queryBuilder new SQLiteQueryBuilder(); queryBuilder.setTables(NotesDatabaseHelper.TABLE_NOTES); int match sUriMatcher.match(uri); switch (match) { case CODE_NOTES: // 查询所有笔记 break; case CODE_NOTE_ID: // 查询特定笔记 String id uri.getLastPathSegment(); queryBuilder.appendWhere(NotesDatabaseHelper.COLUMN_ID id); break; default: throw new IllegalArgumentException(Unknown URI: uri); } Cursor cursor queryBuilder.query(db, projection, selection, selectionArgs, null, null, sortOrder); cursor.setNotificationUri(getContext().getContentResolver(), uri); return cursor; } Override public Uri insert(Uri uri, ContentValues values) { int match sUriMatcher.match(uri); if (match ! CODE_NOTES) { throw new IllegalArgumentException(Insertion not supported for uri); } SQLiteDatabase db mDbHelper.getWritableDatabase(); long id db.insert(NotesDatabaseHelper.TABLE_NOTES, null, values); if (id -1) { return null; } getContext().getContentResolver().notifyChange(uri, null); return ContentUris.withAppendedId(uri, id); } // 其他方法实现类似... }在这个例子中我们定义了两种 URI 模式查询所有笔记和查询特定笔记在 query 方法中使用 UriMatcher 来区分不同的请求在 insert 方法中验证 URI 是否支持插入操作使用了 ContentUris 来处理 ID 相关的 URI 操作7. 测试与调试技巧7.1 单元测试 UriMatcher为了确保 UriMatcher 的正确性我们应该编写单元测试public class NotesProviderTest { Test public void testUriMatcher() { UriMatcher matcher NotesProvider.getUriMatcher(); Uri notesUri Uri.parse(content://com.example.notes.provider/notes); assertEquals(NotesProvider.CODE_NOTES, matcher.match(notesUri)); Uri noteIdUri Uri.parse(content://com.example.notes.provider/notes/123); assertEquals(NotesProvider.CODE_NOTE_ID, matcher.match(noteIdUri)); Uri unknownUri Uri.parse(content://com.example.notes.provider/unknown); assertEquals(UriMatcher.NO_MATCH, matcher.match(unknownUri)); } }7.2 使用 ADB 测试 ContentProvider我们可以通过 ADB 命令来测试 ContentProvider# 查询所有笔记 adb shell content query --uri content://com.example.notes.provider/notes # 查询特定笔记 adb shell content query --uri content://com.example.notes.provider/notes/1 # 插入新笔记 adb shell content insert --uri content://com.example.notes.provider/notes \ --bind title:s:New Note --bind content:s:This is a test note7.3 日志调试技巧在开发过程中添加适当的日志可以帮助调试 UriMatcherOverride public Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder) { Log.d(NotesProvider, Query URI: uri.toString()); int match sUriMatcher.match(uri); Log.d(NotesProvider, Match result: match); // 其余代码... }8. 最佳实践总结根据我多年的 Android 开发经验以下是使用 UriMatcher 的最佳实践保持 URI 设计简洁避免过于复杂的 URI 结构使用常量定义为 Authority、路径和匹配代码定义常量合理使用通配符只在必要时使用#和*考虑扩展性URI 设计应考虑到未来可能的扩展充分测试编写单元测试验证各种 URI 匹配情况文档化 URI 结构为你的 ContentProvider 提供清晰的 API 文档UriMatcher 虽然是一个简单的工具但在 Android 数据共享和 ContentProvider 实现中扮演着重要角色。掌握它的使用技巧可以显著提高开发效率和代码质量。