源码地址:
https://github.com/StarsAaron/UrlSchemeDemo/tree/master
一.URI简介
- 概念:统一资源标识符(Uniform Resource Identifier)
- 组成部分:
- 访问资源的命名机制(scheme)
- 存放资源的主机名(authority)
- 资源自身的名称,由路径表示(path)
Uri地址格式:
[scheme:][//host:port][path][?query][#fragment]
- scheme: 使用的协议
//host:port 地址和端口号
fragment 使用#分隔
path 可以有多个,每个用/连接,比如scheme://authority/path1/path2/path3?- query#fragment
query参数可以带有对应的值,也可以不带,如果带对应的值用=表示,如:scheme://authority/path1/path2/path3?id = 1#fragment,这里有一个参- 数id,它的值是1
query参数可以有多个,每个用&连接
scheme://authority/path1/path2/path3?id = 1&name = mingming&- old#fragment
- 这里有三个参数:
- 参数1:id,其值是:1
- 参数2:name,其值是:mingming
- 参数3:old,没有对它赋值,所以它的值是null
在android中,除了scheme、authority是必须要有的,其它的几个path、query、fragment,它们每一个可以选择性的要或不要,但顺序不能变
- 比如:
- 其中”path”可不要:scheme://authority?query#fragment
- 其中”path”和”query”可都不要:scheme://authority#fragment
- 其中”query”和”fragment”可都不要:scheme://authority/path
“path”,”query”,”fragment”都不要:scheme://authority
- 比如:
几种scheme标识
- Content:主要操作的是ContentProvider,所以它代表的是数据库中 -资源
- http:一个网站资源
- file:本地机器上的某个资源
- git:git仓库中某个资源
- ftp:服务器上的某个资源
- ed2k:(电驴协议)
- 等等……….
提取
http://www.java2s.com:8080/yourpath/fileName.htm?stove=10&path=32&id=4#harvic
- getScheme() :获取Uri中的scheme字符串部分,在这里即,http
- getSchemeSpecificPart():获取Uri中的scheme-specific-part:部分,这里是://www.java2s.com:8080/yourpath/fileName.htm?
- getFragment():获取Uri中的Fragment部分,即harvic
- getAuthority():获取Uri中Authority部分,即www.java2s.com:8080
- getPath():获取Uri中path部分,即/yourpath/fileName.htm
- getQuery():获取Uri中的query部分,即stove=10&path=32&id=4
- getHost():获取Authority中的Host字符串,即www.java2s.com
- getPost():获取Authority中的Port字符串,即8080
另外还有两个常用的:getPathSegments()、getQueryParameter(String key)
- List< String> getPathSegments():上面我们的getPath()是把path部分整个获取下来:/yourpath/fileName.htm,getPathSegments()的作用就是依次提取出Path的各个部分的字符串,以字符串数组的形式输出。以上面的Uri为例:
String mUriStr = "http://www.java2s.com:8080/yourpath/fileName.htm?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);
}
输出:
pathSegItem:yourpath
pathSegItem:fileName.htm
- getQueryParameter(String key):在上面我们通过getQuery()获取整个query字段:stove=10&path=32&id=4,getQueryParameter(String key)作用就是通过传进去path中某个Key的字符串,返回他对应的值。
String mUriStr = "http://www.java2s.com:8080/yourpath/fileName.htm?stove=10&path=32&id#harvic";
mUri = Uri.parse(mUriStr);
Log.d(tag,"getQueryParameter(\"stove\"):"+mUri.getQueryParameter("stove"));
Log.d(tag,"getQueryParameter(\"id\"):"+mUri.getQueryParameter("id"));
输出:
getQueryParameter("stove"):10
getQueryParameter("id"):
可以看到,在path中,即使针对某一个KEY不对它赋值是允许的,但在利用getQueryParameter()获取该KEY对应的值时,获取到的是null;
三.Uri及它的工具类
1. Uri.java
Uri主要的结构如下:
- Uri的内部类:
- StringUri 子孙类,使用不明
- OpaqueUri 子孙类,使用不明
- HierarchicalUri子孙类,Builder构建Uri的实例对象主要是使用了这个类。
- Builder 静态类,用于获取Uri实例对象。
由于Uri的构造方法是私有的,所以它提供了Builder这个静态类用于获取Uri的实例对象。除了获取对象外,它还提供了很多实用的方法,比如:
Public Uri Build()-------获取Uri的实例对象
Public Builder encodedPath(String path)--------根据path构建Builder对象
public Builder authority(String authority)-------根据authority构建Builder对象
Uri的主要方法:
public static Uri withAppendedPath(Uri baseUri, StringpathSegment)
public boolean isPathPrefixMatch(Uri prefix)
public static String encode(String s, String allow)
Uri的两个操作工具类:UriMatcher和ContentUris
UriMatcher.java
构造方法:
private ArrayList<UriMatcher> mChildren;
public UriMatcher(int code) {
mCode = code;
mWhich = -1;
mChildren = new ArrayList<UriMatcher>();
mText = null;
}
UriMatcher维护了一个ArrayList用于保存所有加进来的UriMatcher对象。执行添加操作的方法如下:
public void addURI(String authority, String path, int code)
authority:就是URI对应的authority
path:就是我们在URI中 authority后的那一串
code:表示匹配成功以后的返回值;
- 第一步,初始化:
UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
- 第二步,注册需要的Uri:
matcher.addURI("com.yfz.Lesson", "people", PEOPLE);
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 表示不匹配任何路径的返回码
# 号为通配符
* 号为任意字符
ContentUris
其提供如下两个工具方法:
- withAppendedId(uri, id) :用于为路径加上 ID 部分。
- parseId(uri) :用于从指定 Uri 中解析出所包含的 ID 值。
ContentUris 类用于获取Uri路径后面的ID部分
1) 为路径加上ID: withAppendedId(uri, id)
比如有这样一个Uri:
Uri uri = Uri.parse("content://com.yfz.Lesson/people")
通过withAppendedId方法,为该Uri加上ID
Uri resultUri = ContentUris.withAppendedId(uri, 10);
最后resultUri为: content://com.yfz.Lesson/people/10
2) 从路径中获取ID: parseId(uri)
Uri uri = Uri.parse("content://com.yfz.Lesson/people/10")
long personid = ContentUris.parseId(uri);
最后personid 为 :10
使用自定义Uri启动Activity
1) 新建用于外部启动的Activity
首先,我们先建一个应用,命名为:SchemeURL,在这个应用中我们新建一个Activity命名为:secondActivity
2) 在SecondAcitivity中添加上Intent-filter用于隐式启动Intent,由于我们定义的Uri格式为:qijian://test.uri.activity?action=1,所以我们固定schemeurl和host,通过query来传递参数即可;除了Uri匹配,我这里还添加上了Action:“android.qijian.schemeurl.activity”,所以我们在第三方隐式匹配时要同时通过Uri和action来同时匹配才能通过这里的Intent-filter。
<activity
android:name=".SecondActivity"
android:label="@string/title_activity_second">
<intent-filter>
<action android:name="android.qijian.schemeurl.activity" />
<category android:name="android.intent.category.DEFAULT" />
<data
android:scheme="qijian"
android:host="test.uri.activity" />
</intent-filter>
</activity>
3) 调起SchemeURL的SecondActivity:
Uri uri = Uri.parse("qijian://test.uri.activity?action=1");
Intent intent = new Intent("android.qijian.schemeurl.activity");
intent.setData(uri);
startActivity(intent);
4) 进阶:通过Uri来传递参数,并处理
在上面,我们已经能够通过Uri来进入我们的应用,我们上面只是固定了Uri的scheme部分和host部分,对于其它部分并没有固定,所以我们可以通过其它部分来传递参数,进而完成指定的功能:比较进入指定的页面或做出指定的操作,等
比如,我们在SchemeURL中,对Uri进行接收,并将结果显示出来:
public class SecondActivity extends Activity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_second);
Intent intent = getIntent();
if (null != intent) {
Uri uri = intent.getData();
if (uri == null) {
return;
}
String acionData = uri.getQueryParameter("action");
TextView tv = (TextView)findViewById(R.id.qijian_test_tv);
tv.append("\n传过来的action值为:" + acionData);
}
}
}
从网页中通过Uri启动我们的应用
如果想要从网页中点击一个链接跳转到我们的应用,那除了Intent-filter中的各种匹配工作,还应该加上一个属性:
<category android:name="android.intent.category.BROWSABLE"/>
即,以我们的SecondActivity为例,它完整的AndroidManifest.xml的配置方式为:
<activity
android:name=".SecondActivity"
android:label="@string/title_activity_second">
<intent-filter>
<action android:name="android.qijian.schemeurl.activity" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE"/>
<data
android:scheme="qijian"
android:host="test.uri.activity"/>
</intent-filter>
</activity>