android Uri 介紹及使用

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.

使用方法如下。

首先第一步，初始化：

view plaincopy to clipboardprint?

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

  

第二步註冊需要的Uri:

view plaincopy to clipboardprint?

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

  

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

view plaincopy to clipboardprint?

1. 
   
2. Uri uri = Uri.parse("content://" + "com.yfz.Lesson" + "/people"); 
   
   
3. int match = matcher.match(uri); 
   
   
4. switch (match) 
   
   
5. { 
   
6. case PEOPLE: 
   
   
7. return "vnd.android.cursor.dir/people"; 
   
   
8. case PEOPLE_ID: 
   
   
9. return "vnd.android.cursor.item/people"; 
   
   
10. default: 
    
    
11. return null; 
    
    
12. } 
    

  

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

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

總結:

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

--# 號爲通配符

--* 號爲任意字符

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

view plaincopy to clipboardprint?

1. 
   
2. private static final UriMatcher sURIMatcher = new UriMatcher(); 
   
   
3. static 
   
   
4. { 
   
5. sURIMatcher.addURI("contacts", "/people", PEOPLE); 
   
   
6. sURIMatcher.addURI("contacts", "/people/#", PEOPLE_ID); 
   
   
7. sURIMatcher.addURI("contacts", "/people/#/phones", PEOPLE_PHONES); 
   
   
8. sURIMatcher.addURI("contacts", "/people/#/phones/#", PEOPLE_PHONES_ID); 
   
   
9. sURIMatcher.addURI("contacts", "/people/#/contact_methods", PEOPLE_CONTACTMETHODS); 
   
   
10. sURIMatcher.addURI("contacts", "/people/#/contact_methods/#", PEOPLE_CONTACTMETHODS_ID); 
    
    
11. sURIMatcher.addURI("contacts", "/deleted_people", DELETED_PEOPLE); 
    
    
12. sURIMatcher.addURI("contacts", "/phones", PHONES); 
    
    
13. sURIMatcher.addURI("contacts", "/phones/filter/*", PHONES_FILTER); 
    
    
14. sURIMatcher.addURI("contacts", "/phones/#", PHONES_ID); 
    
    
15. sURIMatcher.addURI("contacts", "/contact_methods", CONTACTMETHODS); 
    
    
16. sURIMatcher.addURI("contacts", "/contact_methods/#", CONTACTMETHODS_ID); 
    
    
17. sURIMatcher.addURI("call_log", "/calls", CALLS); 
    
    
18. sURIMatcher.addURI("call_log", "/calls/filter/*", CALLS_FILTER); 
    
    
19. sURIMatcher.addURI("call_log", "/calls/#", CALLS_ID); 
    
    
20. }

  

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

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

3.ContentUris

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

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

比如有這樣一個Uri

view plaincopy to clipboardprint?

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

  

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

view plaincopy to clipboardprint?

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

  

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

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

view plaincopy to clipboardprint?

1. 
   
2. Uri uri = Uri.parse("content://com.yfz.Lesson/people/10") 
   
   
3. 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:定位記錄。確定對應類型的數據中的哪條記錄。

 

 

下面是一些常用的Uri

 

顯示網頁:
  1. Uri uri = Uri.parse("http://www.google.com");
  2. Intent it = new Intent(Intent.ACTION_VIEW,uri);
  3. startActivity(it);

顯示地圖:
1. Uri uri = Uri.parse("geo:38.899533,-77.036476");
  2. Intent it = new Intent(Intent.Action_VIEW,uri);
  3. startActivity(it);

路徑規劃:
  1. Uri uri = Uri.parse("http://maps.google.com/maps?f=d&saddr=startLat%20startLng&daddr=endLat%20endLng&hl=en");
  2. Intent it = new Intent(Intent.ACTION_VIEW,URI);
  3. startActivity(it);

撥打電話:
調用撥號程序
  1. Uri uri = Uri.parse("tel:xxxxxx");
  2. Intent it = new Intent(Intent.ACTION_DIAL, uri);   
  3. startActivity(it);   
  1. Uri uri = Uri.parse("tel.xxxxxx");
  2. Intent it =new Intent(Intent.ACTION_CALL,uri);
  3. 要使用這個必須在配置文件中加入<uses-permission id="Android.permission.CALL_PHONE" />

發送SMS/MMS
調用發送短信的程序
  1. Intent it = new Intent(Intent.ACTION_VIEW);
  2. it.putExtra("sms_body", "The SMS text");
  3. it.setType("vnd.android-dir/mms-sms");
  4. startActivity(it);   
發送短信
  1. Uri uri = Uri.parse("smsto:0800000123");
  2. Intent it = new Intent(Intent.ACTION_SENDTO, uri);
  3. it.putExtra("sms_body", "The SMS text");
  4. startActivity(it);   
發送彩信
  1. Uri uri = Uri.parse("content://media/external/images/media/23");
  2. Intent it = new Intent(Intent.ACTION_SEND);
  3. it.putExtra("sms_body", "some text");
  4. it.putExtra(Intent.EXTRA_STREAM, uri);
  5. it.setType("image/png");
  6. startActivity(it);

發送Email
  1.
  2. Uri uri = Uri.parse("mailto:[email protected]");
  3. Intent it = new Intent(Intent.ACTION_SENDTO, uri);
  4. startActivity(it);
  1. Intent it = new Intent(Intent.ACTION_SEND);
  2. it.putExtra(Intent.EXTRA_EMAIL, "[email protected]");
  3. it.putExtra(Intent.EXTRA_TEXT, "The email body text");
  4. it.setType("text/plain");
  5. startActivity(Intent.createChooser(it, "Choose Email Client"));   
  1. Intent it=new Intent(Intent.ACTION_SEND);   
  2. String[] tos={"[email protected]"};   
  3. String[] ccs={"[email protected]"};   
  4. it.putExtra(Intent.EXTRA_EMAIL, tos);   
  5. it.putExtra(Intent.EXTRA_CC, ccs);   
  6. it.putExtra(Intent.EXTRA_TEXT, "The email body text");   
  7. it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");   
  8. it.setType("message/rfc822");   
  9. startActivity(Intent.createChooser(it, "Choose Email Client"));

添加附件
  1. Intent it = new Intent(Intent.ACTION_SEND);
  2. it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");
  3. it.putExtra(Intent.EXTRA_STREAM, "[url=]file:///sdcard/mysong.mp3[/url]");
  4. sendIntent.setType("audio/mp3");
  5. startActivity(Intent.createChooser(it, "Choose Email Client"));

播放多媒體
  1.   
  2. Intent it = new Intent(Intent.ACTION_VIEW);
  3. Uri uri = Uri.parse("[url=]file:///sdcard/song.mp3[/url]");
  4. it.setDataAndType(uri, "audio/mp3");
  5. startActivity(it);
  1. Uri uri = Uri.withAppendedPath(MediaStore.Audio.Media.INTERNAL_CONTENT_URI, "1");
  2. Intent it = new Intent(Intent.ACTION_VIEW, uri);
  3. startActivity(it);   

Uninstall 程序
  1. Uri uri = Uri.fromParts("package", strPackageName, null);
  2. Intent it = new Intent(Intent.ACTION_DELETE, uri);
  3. startActivity(it);

//調用相冊
public static final String MIME_TYPE_IMAGE_JPEG = "image/*";
public static final int ACTIVITY_GET_IMAGE = 0;
Intent getImage = new Intent(Intent.ACTION_GET_CONTENT); 
getImage.addCategory(Intent.CATEGORY_OPENABLE); 
getImage.setType(MIME_TYPE_IMAGE_JPEG);
startActivityForResult(getImage, ACTIVITY_GET_IMAGE);

//調用系統相機應用程序，並存儲拍下來的照片
Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE); 
time = Calendar.getInstance().getTimeInMillis();
intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(new File(Environment
.getExternalStorageDirectory().getAbsolutePath()+"/tucue", time + ".jpg")));
startActivityForResult(intent, ACTIVITY_GET_CAMERA_IMAGE);

uninstall apk
/**未測試
Uri uninstallUri = Uri.fromParts("package", "xxx", null);
returnIt = new Intent(Intent.ACTION_DELETE, uninstallUri);
*/
Uri packageURI = Uri.parse("package:"+wistatmap);   
Intent uninstallIntent = new Intent(Intent.ACTION_DELETE, packageURI);   
startActivity(uninstallIntent);

install apk
Uri installUri = Uri.fromParts("package", "xxx", null);
returnIt = new Intent(Intent.ACTION_PACKAGE_ADDED, installUri);
play audio
Uri playUri = Uri.parse("[url=]file:///sdcard/download/everything.mp3[/url]");
returnIt = new Intent(Intent.ACTION_VIEW, playUri);

//發送附件
Intent it = new Intent(Intent.ACTION_SEND);   
it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");   
it.putExtra(Intent.EXTRA_STREAM, "[url=]file:///sdcard/eoe.mp3[/url]");   
sendIntent.setType("audio/mp3");   
startActivity(Intent.createChooser(it, "Choose Email Client"));

//搜索應用
Uri uri = Uri.parse("market://search?q=pname:pkg_name");   
Intent it = new Intent(Intent.ACTION_VIEW, uri);   
startActivity(it);   
//where pkg_name is the full package path for an application

//進入聯繫人頁面
Intent intent = new Intent();
intent.setAction(Intent.ACTION_VIEW);
intent.setData(People.CONTENT_URI);
startActivity(intent);

//查看指定聯繫人
Uri personUri = ContentUris.withAppendedId(People.CONTENT_URI, info.id);//info.id聯繫人ID
Intent intent = new Intent();
intent.setAction(Intent.ACTION_VIEW);
intent.setData(personUri);
startActivity(intent);

轉自http://blog.csdn.net/moiyer/article/details/6915029