Android URI（通用資源標志符）的使用

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 。
雖然這兩類不是非常重要，但是掌握它們的使用，會便於我們的開發工作。
下面就一起看一下這兩個類的作用。



二、在INTENT中作為參數傳遞


1、打開一個網頁，類別是Intent.ACTION_VIEW
 
Uri uri = Uri.parse("http://www.android-study.com/");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
2二、打開地圖並定位到一個點
 
Uri uri = Uri.parse("geo:52.76,-79.0342");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
3、打開撥號界面，類型是Intent.ACTION_DIAL
 
Uri uri = Uri.parse("tel:10086");
Intent intent = new Intent(Intent.ACTION_DIAL, uri);
4、直接撥打電話，與三不同的是，這個直接撥打電話，而不是打開撥號界面
 
Uri uri = Uri.parse("tel:10086");
Intent intent = new Intent(Intent.ACTION_CALL, uri);
5、卸載一個應用，Intent的類別是Intent.ACTION_DELETE
 
Uri uri = Uri.fromParts("package", "xxx", null);
Intent intent = new Intent(Intent.ACTION_DELETE, uri);
6、安裝應用程序,Intent的類別是Intent.ACTION_PACKAGE_ADDED
 
Uri uri = Uri.fromParts("package", "xxx", null);
Intent intent = new Intent(Intent.ACTION_PACKAGE_ADDED, uri);
7、播放音頻文件
 
Uri uri = Uri.parse("file:///sdcard/download/everything.mp3");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
intent.setType("audio/mp3");
8、打開發郵件界面
 
Uri uri= Uri.parse("mailto:[email protected]");
Intent intent = new Intent(Intent.ACTION_SENDTO, uri);
9、發郵件,與八不同這裡是將郵件發送出去
 
Intent intent = new Intent(Intent.ACTION_SEND);
String[] tos = { "[email protected]" };
String[] ccs = { "[email protected]" };
intent.putExtra(Intent.EXTRA_EMAIL, tos);
intent.putExtra(Intent.EXTRA_CC, ccs);
intent.putExtra(Intent.EXTRA_TEXT, "I come from http://www.android-study.com");
intent.putExtra(Intent.EXTRA_SUBJECT, "http://www.android-study.com");intent.setType("message/rfc882");
Intent.createChooser(intent, "Choose Email Client");
//發送帶附件的郵件
?
 
Intent intent = new Intent(Intent.ACTION_SEND);
intent.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");
intent.putExtra(Intent.EXTRA_STREAM, "file:///sdcard/mysong.mp3");
intent.setType("audio/mp3");
startActivity(Intent.createChooser(intent, "Choose Email Client"));
10、發短信
 
Uri uri= Uri.parse("tel:10086");
Intent intent = new Intent(Intent.ACTION_VIEW, uri);
intent.putExtra("sms_body", "I come from http://www.android-study.com");
intent.setType("vnd.Android-dir/mms-sms");
11、直接發短信
 
Uri uri= Uri.parse("smsto://100861");
Intent intent = new Intent(Intent.ACTION_SENDTO, uri);
intent.putExtra("sms_body", "3g android http://www.android-study.com");
12、發彩信
 
Uri uri= Uri.parse("content://media/external/images/media/23");
Intent intent = new Intent(Intent.ACTION_SEND);
intent.putExtra("sms_body", "3g android http://www.android-study.com");
intent.putExtra(Intent.EXTRA_STREAM, uri);
intent.setType("image/png");
13、# Market 相關
 
1 //尋找某個應用
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
 
2 //顯示某個應用的相關信息
Uri uri = Uri.parse("market://details?id=app_id");
Intent it = new Intent(Intent.ACTION_VIEW, uri);
startActivity(it);
//where app_id is the application ID, find the ID
//by clicking on your application on Market home
//page, and notice the ID from the address bar
14、路徑規劃
 
Uri uri = Uri.parse("http://maps.google.com/maps?f=d&saddr=startLat%20startLng&daddr=endLat%20endLng&hl=en");
Intent it = new Intent(Intent.ACTION_VIEW, uri);
startActivity(it);
//where startLat, startLng, endLat, endLng are a long with 6 decimals like: 50.123456
15、安裝指定apk
 
public void setupAPK(String apkname){
    String fileName = Environment.getExternalStorageDirectory() + "/" + apkname;
    Intent intent = new Intent(Intent.ACTION_VIEW);
    intent.setDataAndType(Uri.fromFile(new File(fileName)),"application/vnd.android.package-archive");
    mService.startActivity(intent);
}
16、進入聯系人頁面
 
Intent intent = new Intent();
intent.setAction(Intent.ACTION_VIEW);
intent.setData(People.CONTENT_URI);
startActivity(intent);
17、查看指定聯系人
 

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);
18、調用相冊
 
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);
19、調用系統相機應用程序，並存儲拍下來的照片
 
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)

android中的UriMatcher和ContentUris


用於操作Uri的工具類，分別為UriMatcher 和ContentUris。
UriMatcher
用於匹配Uri。
用法如下： 
首先把你需要匹配Uri路徑全部給注冊上：
注冊完需要匹配的Uri後，就可以使用sMatcher.match(uri)方法對輸入的Uri進行匹配，如果匹配就返回匹配碼，匹配碼是調用 addURI()方法傳入的第三個參數，例如匹配content://com.test.provider.personprovider/person 路徑，返回的匹配碼為1。

//常量UriMatcher.NO_MATCH表示不匹配任何路徑的返回碼 
UriMatcher sUriMatcher = new UriMatcher(UriMatcher.NO_MATCH);

//添加需要匹配的uri，如果匹配就會返回匹配碼 
//如果match()方法匹配content://com.test.provider.personprovider/person路徑，返回匹配碼為1 
sUriMatcher.addURI(“com.test.provider.personprovider”, “person”, 1);

//如果match()方法匹配content://com.test.provider.personprovider/person/530路徑，返回匹配碼為2
//#號為通配符 
sUriMatcher.addURI(“com.test.provider.personprovider”, “person/#”, 2);

switch(sUriMatcher.match(Uri.parse("content://com.test.provider.personprovider/person/10"))) {
 case 1 break;
 case 2 break; 
default:
//不匹配 break; 
}


ContentUris類
用於獲取Uri路徑後面的ID部分：
1、ContentUris.withAppendedId(Uri contentUri, long id)用於為路徑加上ID部分：
Uri uri = Uri.parse("content://com.test.provider.personprovider/person")
Uri resultUri = ContentUris.withAppendedId(uri, 5);
//生成後的Uri為：content://com.test.provider.personprovider/person/5

其結果等價於Uri.withAppendedPath(Uri baseUri, String pathSegment)
Uri resultUri = Uri.withAppendedPath(uri, "5");

2、ContentUris.parseId(uri)方法用於從路徑中獲取ID部分：
Uri uri = Uri.parse("content://com.test.provider.personprovider/person/5")
long personid = ContentUris.parseId(uri);
//獲取的結果為:5


ContentResolver
通過URI來添加、刪除、修改和查詢ContentProvider中提供的數據。除了URI以外，還必須知道需要獲取的數據段的名稱，以及此數據段的數據類型。如果你需要獲取一個特定的記錄，你就必須知道當前記錄的ID，也就是URI中D部分。
可以使用Activity提供的getContentResolver()方法。 
ContentResolver使用insert、delete、update、query方法來操作數據。
1、final Cursor query(Uri uri, String[] projection, String selection, String[] selectionArgs, String sortOrder)Query the given URI, returning a Cursor over the result set. 
2、final Uri insert(Uri url, ContentValues values)Inserts a row into a table at the given URL. 
3、final int update(Uri uri, ContentValues values, String where, String[] selectionArgs)Update row(s) in a content URI.
4、final int delete(Uri url, String where, String[] selectionArgs)Deletes row(s) specified by a content URI.