Android中的URI

jopen 11年前發布 | 51K 次閱讀 Android Android開發 移動開發


就Android平臺而言,URI主要分三個部分:scheme, authority and path。其中authority又分為host和port。格式如下:
scheme://host:port/path


舉個實際的例子:


content://com.example.project:200/folder/subfolder/etc
\---------/  \---------------------------/ \---/ \--------------------------/
scheme                 host               port        path
                \--------------------------------/
                          authority   


現在大家應該知道data flag中那些屬性的含義了吧,看下data flag
<data android:host="string"
      android:mimeType="string"
      android:path="string"
      android:pathPattern="string"
      android:pathPrefix="string"
      android:port="string"
      android:scheme="string" />


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.

 

使用方法如下。

首先第一步,初始化:


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

第二步注冊需要的Uri:


  1. matcher.addURI("com.yfz.Lesson""people"PEOPLE);  
  2. matcher.addURI("com.yfz.Lesson""person/#"PEOPLE_ID);  

第三部,與已經注冊的Uri進行匹配:
Uri uri = Uri.parse("content://" + "com.yfz.Lesson" + "/people");  
int match = matcher.match(uri);  
       switch (match)  
       {  
           case PEOPLE:  
               return "vnd.android.cursor.dir/people";  
           case PEOPLE_ID:  
               return "vnd.android.cursor.item/people";  
           default:  
               return null;  
       }  

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

 

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

 

總結: 

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

--# 號為通配符

--* 號為任意字符

 

 

另外說一下,官方SDK說明中關于Uri的注冊是這樣寫的:

private static final UriMatcher sURIMatcher = new UriMatcher();  
    static  
    {  
        sURIMatcher.addURI("contacts", "/people", PEOPLE);  
        sURIMatcher.addURI("contacts", "/people/#", PEOPLE_ID);  
        sURIMatcher.addURI("contacts", "/people/#/phones", PEOPLE_PHONES);  
        sURIMatcher.addURI("contacts", "/people/#/phones/#", PEOPLE_PHONES_ID);  
        sURIMatcher.addURI("contacts", "/people/#/contact_methods", PEOPLE_CONTACTMETHODS);  
        sURIMatcher.addURI("contacts", "/people/#/contact_methods/#", PEOPLE_CONTACTMETHODS_ID);  
        sURIMatcher.addURI("contacts", "/deleted_people", DELETED_PEOPLE);  
        sURIMatcher.addURI("contacts", "/phones", PHONES);  
        sURIMatcher.addURI("contacts", "/phones/filter/*", PHONES_FILTER);  
        sURIMatcher.addURI("contacts", "/phones/#", PHONES_ID);  
        sURIMatcher.addURI("contacts", "/contact_methods", CONTACTMETHODS);  
        sURIMatcher.addURI("contacts", "/contact_methods/#", CONTACTMETHODS_ID);  
        sURIMatcher.addURI("call_log", "/calls", CALLS);  
        sURIMatcher.addURI("call_log", "/calls/filter/*", CALLS_FILTER);  
        sURIMatcher.addURI("call_log", "/calls/#", CALLS_ID);  
    }  

這個說明估計已經是Google官方沒有更新,首先是初始化方法,沒有傳參,那么現在初始化時,實際是必須傳參的。 可以看一下Android2.2的源碼,無參數的構造方法已經是private的了。

另外就是addURI這個方法,第二個參數開始時不需要"/", 否則是無法匹配成功的。

 

3.ContentUris

ContentUris 類用于獲取Uri路徑后面的ID部分

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

比如有這樣一個Uri


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

通過withAppendedId方法,為該Uri加上ID


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

最后resultUri為: content://com.yfz.Lesson/people/10

 

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


  1. Uri uri Uri.parse("content://com.yfz.Lesson/people/10" 
  2. long personid ContentUris.parseId(uri);  
 

最后personid 為 :10


實驗代碼:
package com.yfz;  
import com.yfz.log.Logger;  
import android.app.Activity;  
import android.content.ContentUris;  
import android.content.UriMatcher;  
import android.net.Uri;  
import android.os.Bundle;  
public class Lesson_14 extends Activity {  

        private static final String AUTHORITY = "com.yfz.Lesson";  
        private static final int PEOPLE = 1;  
        private static final int PEOPLE_ID = 2;  

        //NO_MATCH表示不匹配任何路徑的返回碼   
        private static final UriMatcher sURIMatcher = new UriMatcher(UriMatcher.NO_MATCH);  
        static  
        {  
            sURIMatcher.addURI(AUTHORITY, "people", PEOPLE);  

            //這里的#代表匹配任意數字,另外還可以用*來匹配任意文本   
            sURIMatcher.addURI(AUTHORITY, "people/#", PEOPLE_ID);  
        }  

        @Override  
        protected void onCreate(Bundle savedInstanceState) {  
            super.onCreate(savedInstanceState);  
            Logger.d("------ Start Activity !!! ------");  

            Uri uri1 = Uri.parse("content://" + AUTHORITY + "/people");  
            Logger.e("Uri:" + uri1);  
            Logger.d("Match 1" + getType(uri1));  

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

            Logger.e("Uri:" + uri2);  
            Logger.d("Match 2" + getType(uri2));  

            //拼接Uri   
            Uri cUri = ContentUris.withAppendedId(uri1, 15);  
            Logger.e("Uri:" + cUri);  
            //獲取ID   
            long id = ContentUris.parseId(cUri);  
            Logger.d("Uri ID: " + id);  
        }  

        private String getType(Uri uri) {  
            int match = sURIMatcher.match(uri);  
            switch (match)  
            {  
                case PEOPLE:  
                    return "vnd.android.cursor.dir/person";  
                case PEOPLE_ID:  
                    return "vnd.android.cursor.item/person";  
                default:  
                    return null;  
            }  
        }  
}  

附:Android Uri命名格式:

ContentProvider進行數據交互時就需要用到URI。為了讓客戶端程序能夠使用你的數據,你必須要定義一個公開的URI,它由一些固定格式的文字組成,可以分成下面幾個部分:

content://

一個標準的URI前綴,它用來指示Android必須從ContentProvider中挑出一個來處理這個URI。

authority

一個唯一的標識符,標示這個URI需要查找的ContentProvider是由哪個組織開發的,一般用跟java包命名規范相似的方式來署名這個開發組織。如果是Android內置的provider,則這個authority可以省略掉,否則authority是必須的,Google建議使用用戶自定義的繼承ContentProvider的類的全名來作為,這個ContentProvider所要處理的URI的authority

path(路徑)

ContentProvider根據這個路徑信息來判斷要返回什么類型的數據,所以這個后綴路徑可以自由定義,但是有一些條件限制:

如果一個ContentProvider能查詢返回很多種不同類型的數據,URI后綴要設置不同類型的數據所對應不同的URI后綴如內置的Contact ContentProvider就是用來處理名片夾,它可以返回很多種類型的數據:聯系人、電話、聯系方式等。所以對應這些不同類型的數據就有不同的URI后綴匹配:

1 content://contacts/people/1

上面是返回一個人員

1 content://contacts/people/1/phone/3

返回一個電話號碼。

而且我們要為不同的數據類型設置不同的MIME類型,第一個MIME類型是:vnd.android.cursor.item/person第二個MIME類型是:vnd.android.cursor.item/phone。

同時ContentProvider不僅可以返回單條數據,也可能以目錄的形式返回多條數據。以上面2個URI來說,后綴的結尾都是數字,這表示查詢對應某條記錄,所以返回的數據是單條的,而如果是查詢目錄的形式就要去掉后面的數字如:

1
2
content://contacts/people/1/phone
content://contacts/people

上面就是目錄形式,對應他們的MIME類型也不同,所以我們將單條的MIME類型中的item改為dir,所以MIME類型是:vnd.android.cursor.dir/phone和vnd.android.cursor.dir/person。

A: 標準前綴,表達的意思是使用ContentProvider來處理信息。

B: authority

C: 后綴1,一般用來表示請求需要獲取的是哪種類型的數據(確定MIME類型的功能)。

D:定位記錄。確定對應類型的數據中的哪條記錄。


 本文由用戶 jopen 自行上傳分享,僅供網友學習交流。所有權歸原作者,若您的權利被侵害,請聯系管理員。
 轉載本站原創文章,請注明出處,并保留原始鏈接、圖片水印。
 本站是一個以用戶分享為主的開源技術平臺,歡迎各類分享!