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.      
9. }  

 

在查詢中使用UriMatcher:

 

[java] view plain copy  print?

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

總之，UriMatcher本質上是一個文本過濾器，用在contentProvider中協助我們過濾，分辨出查詢者想要查詢哪個資料表。

android: UriMatcher的用法