问题
Android 中常用的 uri 如何使用呢 ?(此篇分析基础为Android 7.1.1系统源码),参看Android官方说明:https://developer.android.com/reference/android/net/Uri,代码可在此查看:https://github.com/LineageOS/android_frameworks_base/blob/lineage-20.0/core/java/android/net/Uri.java
1 概述
通用资源标志符 URI (Universal Resource Identifier),URI 在 java.net.URI 中定义,显然是 Java 提供的一个类。而 Uri 位置在 android.net.Uri 中定义(Android 源码内位置:frameworks/base/core/java/android/net/Uri.java),是特有针对 Android 系统定义的类。Uri 代表要操作的数据,Android 上可用的每种资源(图像、视频片段、网页等)都可以用 Uri 来表示。
Uri 的组成部分:
- 访问资源的命名机制(scheme)
- 存放资源的主机名(authority)
- 资源自身的名称,由路径表示(path)
Uri 的结构:
# 基本形式
[scheme:]scheme-specific-part[#fragment]
# 第二形式
[scheme:][//authority][path][?query][#fragment]
# 第三形式
[scheme:][//host:port][path][?query][#fragment]
特别针对scheme说明下,Uri中有这么几种常用标识:
- content : 主要操作的是ContentProvider,它代表的是数据库中的某个资源
- http : 某网站资源
- file : 本地机器上的资源
- git : git仓库中的资源
- ftp : ftp服务器上的资源
2 Uri 的结构
2.1 基本形式
# 基本形式
[scheme:]scheme-specific-part[#fragment]
2.2 第二形式
# 第二形式
[scheme:][//authority][path][?query][#fragment]
注意其中规则:
-
path 可以有多个,每个用 / 连接,比如:```
scheme://authority/path1/path2/path3?query#fragment -
query 参数可以带有对应的值,也可以不带,如果带对应的值用 = 表示,如:```
//这里有一个参数id,它的值是1
scheme://authority/path1/path2/path3?id=1#fragment -
query 参数可以有多个,每个用 & 连接,如:```
/*
这里有3个参数:
参数1:id,其值是:1
参数2:name,其值是:pedro
参数3:old,没有对它赋值,所以它的值是null
*/
scheme://authority/path1/path2/path3?id = 1&name=pedro&old#fragment
在android中,除了scheme、authority是必须要有的,其它的几个path、query、fragment,它们每一个可以选择性的要或不要,但顺序不能变
2.3 第三形式
第二形式中 authority 又可以分为 host:port 的形式,这是划分最细的形式:
# 第三形式
[scheme:][//host:port][path][?query][#fragment]
2.4 例子
可以通过这个例子检测下学习效果:
http://www.pedro11.com:8080/yourpath/fileName.html?stove=10&path=32&id=4#harvic
3 Uri 的UML类图
我把 Android 源码中 frameworks/base/core/java/android/net/Uri.java (也可在此查看:https://github.com/LineageOS/android_frameworks_base/blob/lineage-20.0/core/java/android/net/Uri.java)导入到 IDEA 工程中,通过 IDEA 的 Diagram 工具生成了它的 UML 类图(注意其中紫色方法为抽象方法),更方便分析这个有意思的类(在Uri.java中可以看出它有很多内部类,而且内部类又继承了Uri类本身)。\
类图中各个小图标的含义可查看这里:https://jetbrains.design/intellij/resources/icons_list/
4 从 Uri 中提取 String
- getScheme() : 获取Uri中的scheme字符串部分,即 http
- getSchemeSpecificPart() : 获取Uri中的scheme-specific-part:部分,即 //www.pedro11.com:8080/yourpath/fileName.html
- getFragment() : 获取Uri中的Fragment部分,即 harvic
- getAuthority() : 获取Uri中Authority部分,即 www.pedro11.com:8080
- getPath() : 获取Uri中path部分,即 /yourpath/fileName.html
- getQuery() : 获取Uri中的query部分,即 stove=10&path=32&id=4
- getHost() : 获取Authority中的Host字符串,即 www.pedro11.com
- getPost() : 获取Authority中的Port字符串,即 8080
- getPathSegments() : 依次提取出Path的各个部分的字符串,存入List< String>
- getQueryParameter(String key) : 通过传进去query中某个Key的字符串,返回它对应的值
String mUriStr = "http://www.pedro11.com:8080/yourpath/fileName.html?stove=10&path=32&id=4#harvic";
Uri mUri = Uri.parse(mUriStr);
List<String> pathSegList = mUri.getPathSegments();
for (String pathItem:pathSegList){
Log.d("qijian","pathSegItem:"+pathItem);
}
Log.d(tag,"getQueryParameter(\"stove\"):"+mUri.getQueryParameter("stove"));
Log.d(tag,"getQueryParameter(\"id\"):"+mUri.getQueryParameter("id"));
6 Uri操作工具类
6.1 ContentUris 处理 Uri
ContentUris 有两个作用:
- 为路径加上ID
- 从Uri路径中获取ID
-
为Uri路径加上ID: withAppendedId(uri, id)```
//比如有这样一个Uri
Uri uri = Uri.parse("content://com.example.yy/book");//通过ContentUris的withAppendedId()方法,为该Uri加上ID
Uri resultUri = ContentUris.withAppendedId(uri, 10);//最后resultUri为:
//content://com.example.yy/book/10 -
从Uri路径中获取ID—parseId(uri)```
Uri uri = Uri.parse("content://com.example.yy/book/10")
long bookId= ContentUris.parseId(uri);
6.2 UriMatcher 处理 Uri
待添加
6.3 uri与file、path相互转化
-
uri 转 file```
file = new File(new URI(uri.toString())); -
file 转 uri```
URI uri = file.toURI(); -
uri 转 path```
private String getPath(Context context, Uri uri) {
String path = null;
Cursor cursor = context.getContentResolver().query(uri, null, null, null, null);
if (cursor == null) {
return null;
}
if (cursor.moveToFirst()) {
try {
path = cursor.getString(cursor.getColumnIndex(MediaStore.Images.Media.DATA));
} catch (Exception e) {
e.printStackTrace();
}
}
cursor.close();
return path;
} -
path 转 uri```
Uri uri = Uri.parse(path); -
file 转 path```
String path = file.getPath(); -
path 转 file```
File file = new File(path);
8 常用Uri
//显示网页:
Uri uri = Uri.parse("http://www.google.com");
Intent it = new Intent(Intent.ACTION_VIEW,uri);
startActivity(it);
//显示地图:
Uri uri = Uri.parse("geo:38.899533,-77.036476");
Intent it = new Intent(Intent.Action_VIEW,uri);
startActivity(it);
//路径规划:
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);
//调用拨号程序,要使用这个必须在配置文件中加入<uses-permission id="Android.permission.CALL_PHONE" />
Uri uri = Uri.parse("tel:xxxxxx");
Intent it = new Intent(Intent.ACTION_DIAL, uri);
startActivity(it);
Uri uri = Uri.parse("tel.xxxxxx");
Intent it =new Intent(Intent.ACTION_CALL,uri);
//调用发送短信的程序
Intent it = new Intent(Intent.ACTION_VIEW);
it.putExtra("sms_body", "The SMS text");
it.setType("vnd.android-dir/mms-sms");
startActivity(it);
//发送短信
Uri uri = Uri.parse("smsto:0800000123");
Intent it = new Intent(Intent.ACTION_SENDTO, uri);
it.putExtra("sms_body", "The SMS text");
startActivity(it);
//发送彩信
Uri uri = Uri.parse("content://media/external/images/media/23");
Intent it = new Intent(Intent.ACTION_SEND);
it.putExtra("sms_body", "some text");
it.putExtra(Intent.EXTRA_STREAM, uri);
it.setType("image/png");
startActivity(it);
//发送Email
Uri uri = Uri.parse("mailto:xxx@abc.com");
Intent it = new Intent(Intent.ACTION_SENDTO, uri);
startActivity(it);
Intent it = new Intent(Intent.ACTION_SEND);
it.putExtra(Intent.EXTRA_EMAIL, "me@abc.com");
it.putExtra(Intent.EXTRA_TEXT, "The email body text");
it.setType("text/plain");
startActivity(Intent.createChooser(it, "Choose Email Client"));
Intent it=new Intent(Intent.ACTION_SEND);
String[] tos={"me@abc.com"};
String[] ccs={"you@abc.com"};
it.putExtra(Intent.EXTRA_EMAIL, tos);
it.putExtra(Intent.EXTRA_CC, ccs);
it.putExtra(Intent.EXTRA_TEXT, "The email body text");
it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");
it.setType("message/rfc822");
startActivity(Intent.createChooser(it, "Choose Email Client"));
//添加附件
Intent it = new Intent(Intent.ACTION_SEND);
it.putExtra(Intent.EXTRA_SUBJECT, "The email subject text");
it.putExtra(Intent.EXTRA_STREAM, "[url=]file:///sdcard/mysong.mp3[/url]");
sendIntent.setType("audio/mp3");
startActivity(Intent.createChooser(it, "Choose Email Client"));
//播放多媒体
Intent it = new Intent(Intent.ACTION_VIEW);
Uri uri = Uri.parse("[url=]file:///sdcard/song.mp3[/url]");
it.setDataAndType(uri, "audio/mp3");
startActivity(it);
Uri uri = Uri.withAppendedPath(MediaStore.Audio.Media.INTERNAL_CONTENT_URI, "1");
Intent it = new Intent(Intent.ACTION_VIEW, uri);
startActivity(it);
//Uninstall APP
Uri uri = Uri.fromParts("package", strPackageName, null);
Intent it = new Intent(Intent.ACTION_DELETE, uri);
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);
//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);
//进入联系人页面
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);