Android笔记系列--Uri

源码地址：
https://github.com/StarsAaron/UrlSchemeDemo/tree/master

一.URI简介

• 概念：统一资源标识符（Uniform Resource Identifier）
• 组成部分：
  
  1. 访问资源的命名机制（scheme）
  2. 存放资源的主机名（authority）
  3. 资源自身的名称，由路径表示（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标识

1. Content：主要操作的是ContentProvider，所以它代表的是数据库中 -资源
2. http：一个网站资源
3. file：本地机器上的某个资源
4. git：git仓库中某个资源
5. ftp：服务器上的某个资源
6. ed2k：（电驴协议）
7. 等等……….

提取

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>