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中帮助我们过滤,分辨出查询者想要查询哪个数据表。

demo:

UriMatcher类用于匹配Uri,它的用法如下:

首先第一步把你需要匹配Uri路径全部给注册上,如下:

//常量UriMatcher.NO_MATCH表示不匹配任何路径的返回码

UriMatcher  sMatcher = new UriMatcher(UriMatcher.NO_MATCH);

//如果match()方法匹配content://cn.xxt.provider.personprovider/person路径,返回匹配码为1

sMatcher.addURI(“cn.xxt.provider.personprovider”, “person”, 1);//添加需要匹配uri,如果匹配就会返回匹配码

//如果match()方法匹配content://cn.xxt.provider.personprovider/person/230路径,返回匹配码为2

sMatcher.addURI(“cn.xxt.provider.personprovider”, “person/#”, 2);//#号为通配符

switch (sMatcher.match(Uri.parse("content://cn.xxt.provider.personprovider/person/10"))) {

   case 1

    break;

   case 2

    break;

   default://不匹配

    break;

}

注册完需要匹配的Uri后,就可以使用sMatcher.match(uri)方法对输入的Uri进行匹配,如果匹配就返回匹配码,匹配码是调用addURI()方法传入的第三个参数,假设匹配content://cn.xxt.provider.personprovider/person路径,返回的匹配码为1

 

posted @ 2016-03-03 18:52  dodo-yufan  阅读(...)  评论(... 编辑 收藏