android: UriMatcher的用法

ContentProvider是Android四大组件之一，网上也有不少关于它的文章，基本用法都可以查到，但关于UriMatcher在其中的作用，文章中都有例子，但我觉得还没有说清楚。

先说为什么用UriMatcher。

ContentProvider向外界提供了一个标准的，也是唯一的用于查询的接口：

[java] view plain copy

print?

1. public final Cursor query(Uri uri, String[] projection,
2. String selection, String[] selectionArgs, String sortOrder);

其中uri用于指定哪一个数据源，当一个数据源含有多个内容（比如多个表），就需要用不同的Uri进行区分，例如：

[java] view plain copy

print?

1. public static final Uri CONTENT_URI_A = Uri.parse("content://" + AUTHORITY  + "/" + TABLE_A);
2. public static final Uri CONTENT_URI_B = Uri.parse("content://" + AUTHORITY  + "/" + TABLE_B);

这时候使用UriMatcher就可以帮助我们方便的过滤到TableA还是TableB, 然后进行下一步查询， 如果不用UriMatcher也可以，我们就需要手动过滤字符串，用起来有点麻烦，可维护性也不好。

再说怎么用UriMatcher, 定义如下：

[java] view plain copy

print?

1. // Set up our URL matchers to help us determine what an
2. // incoming URI parameter is.
3. private static final UriMatcher URI_MATCHER;
4. static {
5. URI_MATCHER = new UriMatcher(UriMatcher.NO_MATCH);
6. URI_MATCHER.addURI(AUTHORITY, TABLE_A, TABLE_A_MSG);
7. URI_MATCHER.addURI(AUTHORITY, TABLE_B, TABLE_B_MSG);
8. }

在查询中使用UriMatcher:

[java] view plain copy

print?

1. @Override
2. public Cursor query(Uri uri, String[] projection, String selection,
3. String[] selectionArgs, String sortOrder) {
4. String table = null;
5. switch (URI_MATCHER.match(uri)) {
6. case ALL_MESSAGES:
7. break;
8. case OXFORD_MSG:
9. table = TABLE_A;
10. break;
11. case CHENYU_MSG:
12. table = TABLE_B;
13. break;
14. default:
15. break;
16. }
17. Cursor resultCursor = mDB.query(table, projection, selection, selectionArgs, null, null, sortOrder);
18. return resultCursor;
19. }

总之，UriMatcher本质上是一个文本过滤器，用在contentProvider中帮助我们过滤，分辨出查询者想要查询哪个数据表。