Android学习笔记十六.使用ContentProvider实现数据共享(二).URI...工具类

转载请表明出处：http://blog.csdn.net/u012637501(嵌入式_小J的天空)

一、UriMatcher与ContentUris工具类

UriMatcher

1.功能概述
开发ContentProvider时所实现的query()、insert()、delete()、update()方法的第一个参数为Uri参数，该参数由ContentResolver调用这些方法时传入。在上一篇博文中的实例，并没有真正对数据进行操作，因此ContentProvider并未对Uri参数进行任何判断。所以为了确定该ContentProvider实际能处理的Uri,以确定每个方法中Uri参数所操作的数据，Android系统提供了UriMatcher工具类。
2.主要方法
void addUri(String authority,String path,int
code)：该方法用于向UriMatcher对象注册Uri。其中，authority和path组合成一个Uri，而code则代表该Uri对应的标识码
int match(Uri uri)：根据前面注册的Uri来判断指定Uri对应的标识码。如果找不到匹配的标识码，该方法将会返回-1。
3.UriMatcher工具类的使用
(1)创建UriMatcher对象，并向其注册两个Uri.
UriMatcher matcher = new UriMatcher(UriMatcher.NO_MATCH);
matcher.addUri("com.example.Android.Content_3","words",1);
//资源部分为words，即访问所有数据项

matcher.addUri("com.example.Android.Content_3","word/#",2);//访问指定数据项
com.example.Android.Content_3/words
(2)根据前面注册的Uri来判断指定Uri对应的标识码
com.example.Android.Content_3/words
matcher.match("Uri.parse("
matcher.match("Uri.parse("com.example.Android.Content_3/word/10"));

ContentUris

1.功能概述
用于操作Uri字符串的工具类。

2.主要方法

withAppendedId(Uri,id):用于为路径加上ID部分
parseId(uri):用于从指定Uri中解析出所包含的ID值

3.ContentUris工具类的使用

(1)为Uri添加ID,生成后的uri为“content://com.example.Android.Content_3/word/2”

Uri uri = Uri.parse("content://com.example.Android.Content_3/word");
Uri resultUri = ContentUris.withAppendedId(uri,2);
(2)从指定Uri中解析出所包含的ID值

Uri uri = Uri.parse("content://com.example.Android.Content_3/word/2");
long wordId=ContentUris.parseId(Uri); //获取的结果为2

二、URI与Uri

1.URI (public final class)

java.lang.Object
↳ java.net.URI
(1)功能概述：统一资源标识符，用于标识一个抽象或物理资源。同时，URI类不但可以用来解析一个URI字符串，也可以将几部分组成一个URI统一资源标识符。构造方法如下：

URI(String spec) Creates a new URI instance by parsing spec .

URI(String scheme, String schemeSpecificPart, String fragment) Creates a new URI instance of the given unencoded component parts.

URI(String scheme, String userInfo, String host, int port, String path, String query, String fragment) Creates a new URI instance of the given unencoded component parts.

URI(String scheme, String host, String path, String fragment) Creates a new URI instance of the given unencoded component parts.

URI(String scheme, String authority, String path, String query, String fragment) Creates a new URI instance of the given unencoded component parts.

(2)URI组成(如URI：http://username:password@host:8080/directory/file?query#fragment)

Component	Example value	Also known as
Scheme(方案/协议)	http	protocol
Scheme-specific part	//username:password@host:8080/directory/file?query#fragment
Authority(身份认证)	username:password@host:8080
User Info(用户信息)	username:password
Host(主机)	host
Port(串口)	8080
Path(资源路径)	/directory/file
Query	query
Fragment(资源名称)	fragment	ref

升华笔记一：
举例：在浏览器中输入如下Uri：http://www.crazyit.org:80/ethos.php

对于上面的这个URL,可分为如下三个部分： http://：URL的协议部分，只要通过HTTP协议来访问网站，这个部分是固定的; www.crazyit.org：域名部分。只要访问指定的网站，这个部分总是固定的;
ethos.php：网站资源部分。房访问这需要访问不同资源时，这个部分总是改变的。

(3)Absolute vs. Relative URIs

URIs
are either

absolute
 or relative

.

Absolute:

http://android.com/robots.txt

Relative:

robots.txt

注意：
绝对URIs包含scheme部分，并且如果该scheme部分被URL支持的话，我们可以通过是同toURL()方法将绝对URI转换为URL;
相对URIs不包含scheme部分并且不能被转换为URLs，可以通过URI的resolve(String)方法、relativize(URI)方法进行相互转换。

[code]URI absolute = new URI("http://android.com/");
   URI relative = new URI("robots.txt");
   URI resolved = new URI("http://android.com/robots.txt");

   // print "http://android.com/robots.txt"
   System.out.println(absolute.resolve(relative));

   // print "robots.txt"
   System.out.println(absolute.relativize(resolved));

(4) Opaque vs. Hierarchical URIs
Absolute URIs are either

opaque
 or hierarchical

. Relative URIs are always hierarchical.

Hierarchical:

http://android.com/robots.txt

Opaque:

mailto:robots@example.com

Opaque URIs同时也包含scheme和scheme-specific
part，但是需要注意的是其scheme-specific part不是以斜杠'/'开头并且不能被解析，所有一个opaque URI是没有authority, user info, host, port, path or query这几部分的。一个典型的opaque URI： mailto:robots@example.com

Component	Example value
Scheme	mailto
Scheme-specific part（不是斜杠'/'开头）	robots@example.com
Fragment

(5)编码和解码URI

解码URI:http : //user:pa55w%3Frd@host：80/doc%7Csearch?q=green%20robots#over%206%22

Component	Legal Characters（合法字符）	Other Constraints （其他限制条件）	Raw Value（原始值）	Value（解码得到的值）
Scheme	0-9 , a-z , A-Z , +-.	First character must be in a-z , A-Z		http
Scheme-specific part	0-9 , a-z , A-Z , _-!.~'()*,;:$&+=?/[]@	Non-ASCII characters okay (非ASCII字符即可)	//user:pa55w%3Frd@host:80/doc%7Csearch?q=green%20robots	//user:pa55w?rd@host:80/doc|search?q=green robots
Authority	0-9 , a-z , A-Z , _-!.~'()*,;:$&+=@[]	Non-ASCII characters okay	user:pa55w%3Frd@host:80	user:pa55w?rd@host:80
User Info	0-9 , a-z , A-Z , _-!.~'()*,;:$&+=	Non-ASCII characters okay	user:pa55w%3Frd	user:pa55w?rd
Host	0-9 , a-z , A-Z , -.[]	Domain name, IPv4 address or [IPv6 address]		host
Port	0-9			80
Path	0-9 , a-z , A-Z , _-!.~'()*,;:$&+ =/@	Non-ASCII characters okay	/doc%7Csearch	/doc|search
Query	0-9 , a-z , A-Z , _-!.~'()*,;:$&+=?/[]@	Non-ASCII characters okay	q=green%20robots	q=green robots
Fragment	0-9 , a-z , A-Z , _-!.~'()*,;:$&+=?/[]@	Non-ASCII characters okay	over%206%22	over 6"

2.Uri (public
abstract class)

java.lang.Object
↳ java.net.Uri

(1)ContentProvider要求的Uri
content://com.example.Android_Content_3/words
其可分为三个部分：
A.content://：这个部分是Android的ContentProvider规定的，就像上网的协议默认是http://一样。暴露ContentProvider、访问
ContentProvider的协议默认是content://。
B.com.example.Android_Content_3：这个部分就是COntentProvider的authority。系统就是由这个部分来找到操作哪个ContentProvider。只要访问指定的ContentProvider，这个部分总是固定的。
C.words：资源部分(数据部分)。当访问者需要访问不同资源时，这个部分是动态改变的。

升华笔记二：Android的Uri所能表达的功能更丰富
1.content://com.example.Android_Content_3/words
作用：访问资源为所有数据项words

2.content://com.example.Android_Content_3/word/2

作用：访问资源为word/2，即访问word数据中ID为2的记录

3.content://com.example.Android_Content_3/word/2/word

作用：访问资源为word/2，即访问word数据中ID为2的记录的word字段。
注意：虽然大部分使用ContentProvider所操作的数据都来自于数据库，但有时候这些数据也可来自于文件、XML或网络等其他存储放方式，此时支持的Uri也可以改为如下形式：content://com.example.Android_Content_3/word/detail/,该Uri表示操作word节点下的detail节点。

(2)Uri嵌入类

Nested Classes
class	Uri.Builder	Helper class for building or manipulating URI references.

(3)常用方法
static Uri parse(String uriString)：将一个字符串转换成Uri
应用：Uri uri = Uri.parse("content://com.example.Android_Content_3/word/2");

参考：http://wear.techbrood.com/reference/java/net/URI.html