【Android】Uri、UriMatcher、ContentUris詳解

1.Uri

通用資源標誌符（Universal Resource Identifier, 簡稱"URI"）。

Uri表明要操做的數據，Android上可用的每種資源 - 圖像、視頻片斷等均可以用Uri來表示。

 

URI通常由三部分組成：

訪問資源的命名機制。 

存放資源的主機名。 

資源自身的名稱，由路徑表示。 

 

 

 

 

Android的Uri由如下三部分組成： "content://"、數據的路徑、標示ID(可選)

舉些例子，如： 

全部聯繫人的Uri： content://contacts/people

某個聯繫人的Uri: content://contacts/people/5

全部圖片Uri: content://media/external

某個圖片的Uri：content://media/external/images/media/4

 

 

 

 

咱們很常常須要解析Uri，並從Uri中獲取數據。

Android系統提供了兩個用於操做Uri的工具類，分別爲UriMatcher 和ContentUris 。

雖然這兩類不是很是重要，可是掌握它們的使用，會便於咱們的開發工做。

下面就一塊兒看一下這兩個類的做用。

 

 

2.UriMatcher

UriMatcher 類主要用於匹配Uri.

 

使用方法以下。

首先第一步，初始化：

[java] view plaincopyprint?

1. UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);  

 

第二步註冊須要的Uri:

[java] view plaincopyprint?

1. matcher.addURI("com.yfz.Lesson", "people", PEOPLE);  

2. matcher.addURI("com.yfz.Lesson", "person/#", PEOPLE_ID);  

 

 

第三部，與已經註冊的Uri進行匹配:

[java] view plaincopyprint?

1. Uri uri = Uri.parse("content://" + "com.yfz.Lesson" + "/people");  

2. int match = matcher.match(uri);  

3.        switch (match)  

4.        {  

5.            case PEOPLE:  

6.                return "vnd.android.cursor.dir/people";  

7.            case PEOPLE_ID:  

8.                return "vnd.android.cursor.item/people";  

9.            default:  

10.                return null;  

11.        }  

 

match方法匹配後會返回一個匹配碼Code，即在使用註冊方法addURI時傳入的第三個參數。

 

上述方法會返回"vnd.android.cursor.dir/person".

 

總結: 

--常量 UriMatcher.NO_MATCH 表示不匹配任何路徑的返回碼

--# 號爲通配符

--* 號爲任意字符

 

 

另外說一下，官方SDK說明中關於Uri的註冊是這樣寫的：

[java] view plaincopyprint?

1. private static final UriMatcher sURIMatcher = new UriMatcher();  

2.     static  

3.     {  

4.         sURIMatcher.addURI("contacts", "/people", PEOPLE);  

5.         sURIMatcher.addURI("contacts", "/people/#", PEOPLE_ID);  

6.         sURIMatcher.addURI("contacts", "/people/#/phones", PEOPLE_PHONES);  

7.         sURIMatcher.addURI("contacts", "/people/#/phones/#", PEOPLE_PHONES_ID);  

8.         sURIMatcher.addURI("contacts", "/people/#/contact_methods", PEOPLE_CONTACTMETHODS);  

9.         sURIMatcher.addURI("contacts", "/people/#/contact_methods/#", PEOPLE_CONTACTMETHODS_ID);  

10.         sURIMatcher.addURI("contacts", "/deleted_people", DELETED_PEOPLE);  

11.         sURIMatcher.addURI("contacts", "/phones", PHONES);  

12.         sURIMatcher.addURI("contacts", "/phones/filter/*", PHONES_FILTER);  

13.         sURIMatcher.addURI("contacts", "/phones/#", PHONES_ID);  

14.         sURIMatcher.addURI("contacts", "/contact_methods", CONTACTMETHODS);  

15.         sURIMatcher.addURI("contacts", "/contact_methods/#", CONTACTMETHODS_ID);  

16.         sURIMatcher.addURI("call_log", "/calls", CALLS);  

17.         sURIMatcher.addURI("call_log", "/calls/filter/*", CALLS_FILTER);  

18.         sURIMatcher.addURI("call_log", "/calls/#", CALLS_ID);  

19.     }  

 

 

這個說明估計已是Google官方沒有更新，首先是初始化方法，沒有傳參，那麼如今初始化時，實際是必須傳參的。 能夠看一下Android2.2的源碼，無參數的構造方法已是private的了。

另外就是addURI這個方法，第二個參數開始時不須要"/"， 不然是沒法匹配成功的。

 

3.ContentUris

ContentUris 類用於獲取Uri路徑後面的ID部分

1)爲路徑加上ID: withAppendedId(uri, id)

好比有這樣一個Uri

[java] view plaincopyprint?

1. Uri uri = Uri.parse("content://com.yfz.Lesson/people")  

 

經過withAppendedId方法，爲該Uri加上ID

[java] view plaincopyprint?

1. Uri resultUri = ContentUris.withAppendedId(uri, 10);  

 

最後resultUri爲: content://com.yfz.Lesson/people/10

 

2)從路徑中獲取ID: parseId(uri)

[java] view plaincopyprint?

1. Uri uri = Uri.parse("content://com.yfz.Lesson/people/10")  

2. long personid = ContentUris.parseId(uri);  

 

最後personid 爲 :10

 

附上實驗的代碼：

[java] view plaincopyprint?

1. package com.yfz;  

2. import com.yfz.log.Logger;  

3. import android.app.Activity;  

4. import android.content.ContentUris;  

5. import android.content.UriMatcher;  

6. import android.net.Uri;  

7. import android.os.Bundle;  

8. public class Lesson_14 extends Activity {  

9.           

10.         private static final String AUTHORITY = "com.yfz.Lesson";  

11.         private static final int PEOPLE = 1;  

12.         private static final int PEOPLE_ID = 2;  

13.           

14.         //NO_MATCH表示不匹配任何路徑的返回碼  

15.         private static final UriMatcher sURIMatcher = new UriMatcher(UriMatcher.NO_MATCH);  

16.         static  

17.         {  

18.             sURIMatcher.addURI(AUTHORITY, "people", PEOPLE);  

19.               

20.             //這裏的#表明匹配任意數字，另外還能夠用*來匹配任意文本  

21.             sURIMatcher.addURI(AUTHORITY, "people/#", PEOPLE_ID);  

22.         }  

23.           

24.         @Override  

25.         protected void onCreate(Bundle savedInstanceState) {  

26.             super.onCreate(savedInstanceState);  

27.             Logger.d("------ Start Activity !!! ------");  

28.               

29.             Uri uri1 = Uri.parse("content://" + AUTHORITY + "/people");  

30.             Logger.e("Uri:" + uri1);  

31.             Logger.d("Match 1" + getType(uri1));  

32.               

33.             Uri uri2 = Uri.parse("content://" + AUTHORITY + "/people" + "/2");  

34.               

35.             Logger.e("Uri:" + uri2);  

36.             Logger.d("Match 2" + getType(uri2));  

37.               

38.             //拼接Uri  

39.             Uri cUri = ContentUris.withAppendedId(uri1, 15);  

40.             Logger.e("Uri:" + cUri);  

41.             //獲取ID  

42.             long id = ContentUris.parseId(cUri);  

43.             Logger.d("Uri ID: " + id);  

44.         }  

45.           

46.         private String getType(Uri uri) {  

47.             int match = sURIMatcher.match(uri);  

48.             switch (match)  

49.             {  

50.                 case PEOPLE:  

51.                     return "vnd.android.cursor.dir/person";  

52.                 case PEOPLE_ID:  

53.                     return "vnd.android.cursor.item/person";  

54.                 default:  

55.                     return null;  

56.             }  

57.         }  

58. }  

 

 

好了，就講這麼多。