语言

URI 类

定义

表示统一资源标识符 (URI) 引用。

[Android.Runtime.Register("java/net/URI", DoNotGenerateAcw=true)]
public sealed class URI : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.IComparable
[<Android.Runtime.Register("java/net/URI", DoNotGenerateAcw=true)>]
type URI = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface IComparable
继承
特性
实现

注解

表示统一资源标识符 (URI) 引用。

除了下面记下的一些小偏差外,此类的实例表示 RFC  定义的 URI 引用;2396:统一资源标识符(URI):通用语法http://www.ietf.org/rfc/rfc2396.txt,由 RFC  修正;2732:URL 中文本 IPv6 地址的格式。http://www.ietf.org/rfc/rfc2732.txt 文本 IPv6 地址格式还支持scope_ids。 此处介绍了scope_ids的语法和用法。 此类提供用于从其组件创建 URI 实例的构造函数,或通过分析其字符串形式、访问实例的各种组件的方法以及用于规范化、解析和相对化 URI 实例的方法。 此类的实例是不可变的。

<h3> URI 语法和组件 </h3>

在最高级别,字符串形式的 URI 引用(以下简称“URI”)具有语法

<blockquote> [scheme b<>/b:]<>[<b/b>#<>fragment] </blockquote>

其中方括号 = 描述可选组件以及字符 <b>:</b> 和 b<>#/<b> 本身。

绝对 URI 指定方案;一个不是绝对的 URI 据说是相对的。 URI 也根据 URI 不 透明 还是 分层进行分类。

不透明 URI 是一个绝对 URI,其方案特定的部分不以斜杠字符 ('/') 开头。 不透明的 URI 不受进一步分析的约束。 不透明 URI 的一些示例包括:

<blockquote><table cellpadding=0 cellspacing=0 summary=“layout”><tr><td td>mailto:java-net@java.sun.com<td></tr td td><></>news:comp.lang.java<tr td></><><tr td>urn:isbn:096139210x<></tr></table></blockquote>

分层 URI 是一个绝对 URI,其方案特定的部分以斜杠字符或相对 URI 开头,即不指定方案的 URI。 分层 URI 的一些示例包括:

<块状>http://java.sun.com/j2se/1.3/<br>docs/guide/collections/designfaq.html#28<br br>../../../demo/jfc/SwingSet2/src/SwingSet2.java<>file:///~/calendar</blockquote>

分层 URI 根据语法进行进一步分析

<blockquote> [scheme<b>:</b>][<b/b>//<>authority][path][b/b<>][?<b><>#</b>fragment] </blockquote>

其中字符 <b>:</b>、<b>/</b>、<b>?</>b< 和 >b#<> 代表自己。 分层 URI 的特定于方案的部分由方案组件和片段组件之间的字符组成。

分层 URI 的颁发机构组件(如果指定) 基于服务器 或 基于注册表。 基于服务器的颁发机构根据熟悉的语法进行分析

<blockquote> [user-info<b>@</b>]host[<b/b>:<>port] </blockquote>

其中字符 <b>@</b> 和 <b>:</b> 代表自己。 目前使用的所有 URI 方案都基于服务器。 不以这种方式分析的颁发机构组件被视为基于注册表的组件。

如果分层 URI 以斜杠字符开头,则其路径部分本身是绝对的;'/'否则为相对。 分层 URI 的路径,可以是绝对 URI,要么指定颁发机构始终是绝对的。

全部告知,然后,URI 实例具有以下 9 个组件:

<blockquote><表 summary=“描述 URI:scheme、scheme-specific-part、authority、user-info、host、port、path、query、fragment”><tr th><>/th<>< th>/th</><>tr<tr><td scheme>/td<td></td>String<></tr><><td>scheme-specific-part    </td><td/td>String<></tr><><td>authority</td><td/td>String<></tr><tr><td>user-info</td><td>String</td></tr><><td>host</><>String<td td/tr td/><><><>tr td port</><>int<><td td td/td/><><>tr td path</td><>String<>< td/tr><tr><td>query</td td></td>/trString<><td><><> fragment</td td><>String</tr></table><></blockquote>

在给定实例中,任何特定组件都是 未定义 或使用非重复值 定义的 。 未定义的字符串组件由未定义的整数组件表示null。-1 字符串组件可以定义为将空字符串作为其值;这与未定义的组件不等效。

特定组件是否在实例中定义取决于所表示 URI 的类型。 绝对 URI 具有方案组件。 不透明 URI 有一个方案、一个特定于方案的部件,也可能是一个片段,但没有其他组件。 分层 URI 始终具有路径(尽管路径可能为空)和方案特定的部分(至少包含路径),并且可能具有任何其他组件。 如果颁发机构组件存在且基于服务器,则将定义主机组件,并定义用户信息和端口组件。

<针对 URI 实例>的 h4< 操作 /h4>

此类支持的关键操作是 规范化、 解析和 相对化。

规范化 是从分层 URI 的路径组件中删除不必要的 "." 段的过程 ".." 。 只需删除每个 "." 段。 ".."仅当段前面是非".."段时,才会删除该段。 规范化对不透明的 URI 没有影响。

解析 是针对另一个 基 URI 解析一个 URI 的过程。 根据 RFC  指定的方式,从这两个 URI 的组件构造生成的 URI;2396,从原始 URI 中未指定组件的基 URI 获取组件。 对于分层 URI,原始路径根据基的路径解析,然后规范化。 例如解析的结果

<blockquote>docs/guide/collections/designfaq.html#28                 (1) </blockquote>

针对基 URI http://java.sun.com/j2se/1.3/ 的结果 URI

<blockquote/blockquote>http://java.sun.com/j2se/1.3/docs/guide/collections/designfaq.html#28<>

解析相对 URI

<blockquote>../../../demo/jfc/SwingSet2/src/SwingSet2.java    (2) </blockquote>

针对此结果生成,反过来又生成

<blockquote/blockquote>http://java.sun.com/j2se/1.3/demo/jfc/SwingSet2/src/SwingSet2.java<>

支持绝对 URI 和相对 URI 以及分层 URI 时绝对路径和相对路径的解析。 针对任何其他 URI 解析 URI file:///~calendar 只会生成原始 URI,因为它是绝对 URI。 针对相对基 URI(1)解析上面的相对 URI (2)会生成规范化 URI,但仍相对 URI

<blockquote/blockquote>demo/jfc/SwingSet2/src/SwingSet2.java<>

归根结底是反解析:对于任何两个规范化 URI u 和 v、

<blockquote>u.relativize(.resolve(v v)).equals()  和<br>u.resolve(v.relativize(v)).equals(v) nbsp; 。<br></blockquote>

在构造包含必须尽可能相对于文档基 URI 的 URI 的文档时,此操作通常很有用。 例如,将 URI 相对化

<blockquote/blockquote>http://java.sun.com/j2se/1.3/docs/guide/index.html<>

针对基 URI

<blockquote/blockquote>http://java.sun.com/j2se/1.3<>

生成相对 URI docs/guide/index.html。

<h4> 字符类别 </h4>

RFC 2396 指定 URI 引用的各个组件中允许的字符。 以下类别(其中大部分来自该规范)用于描述这些约束:

<blockquote><表 cellspacing=2 summary=“Describes categories alpha,digit,alphanum,unreserved,punct,reserved,escaped,other”><tr><th valign=top>alpha</th><td>The US-ASCII 字母字符, 'A' through 'Z'和 'a' through 'z'</td></tr><><th valign=top> digit/th<td>The US-ASCII decimal<> characters, '0' through '9'</td></tr><tr><th valign=top>alphanum</th><td>All alpha and digit characters</td></tr><th><valign=top>unreserved    </th><td>All alphanum characters with the string "_-!.~'()*"</td></tr><><th valign=top> punct</th><td>The characters in the string /td",;:$&+="/<><tr tr>th valign=top<>< reserved>/th<td>All < characters with the string >"?/[]@"</td></tr><tr><th valign=top>escaped</th><td>Escaped octets,即由百分比字符('%')组成的三元组,后跟两个十六进制数字('0'-'9','A'-'F'和'a'-'f' )</td></tr><tr><th valign=top> other</th><td td>不在 US-ASCII 字符集中的 Unicode 字符,不是控制字符(根据java.lang.Character#isISOControl(char) Character.isISOControlmethod),不是空格字符(根据java.lang.Character#isSpaceChar(char) Character.isSpaceChar方法)  (<b>与 RFC 2396</b> 的偏差,限制为 US-ASCII)</td></tr></table></blockquote>

“legal-chars”>所有法定 URI 字符集由未保留、保留、转义和其他字符组成。

<h4> 转义八进制数、引号、编码和解码 </h4>

RFC 2396 允许转义的八进制数显示在用户信息、路径、查询和片段组件中。 转义在 URI 中提供两个目的:

<ul>

<li>

当需要 URI 严格符合 RFC  时,对非US-ASCII 字符 进行编码 ;2396 不包含 任何其他 字符。

</li>

<li>

引用组件中其他为非法的字符。 用户信息、路径、查询和片段组件在哪些字符被视为合法和非法方面略有不同。

</li>

</ul>

这些用途由三个相关操作在此类中提供:

<ul>

<li>

>通过将字符替换为表示 UTF-8 字符集中的字符的转义八进制集序列来编码字符。 例如,欧元货币符号('\u005Cu20AC')编码为 "%E2%82%AC"。 (<b>与 RFC  的偏差;2396</b>,它未指定任何特定的字符集。

</li>

<li>

“quote”> 只是通过编码来 引用 非法字符。 例如,空格字符通过将空格字符替换为 "%20"引号。 UTF-8 包含 US-ASCII,因此对于 US-ASCII 字符,此转换正是 RFC 2396 所需的效果。

</li>

<li>

“解码”> 转义的八进制集序列通过将其替换为它在 UTF-8 字符集中表示的字符序列来 解码 。 UTF-8 包含 US-ASCII,因此解码可以取消引用任何带引号的 US-ASCII 字符以及解码任何编码的非US-ASCII 字符的效果。 如果在解码转义八进制数时发生解码错误,则错误八进制数将替换为 '\u005CuFFFD'Unicode 替换字符。

</li>

</ul>

此类的构造函数和方法中公开了这些操作,如下所示:

<ul>

<li>

#URI(java.lang.String) 单参数构造函数要求引用其参数中的任何非法字符,并保留存在的任何转义八进制数 和其他 字符。

</li>

<li>

#URI(java.lang.String,java.lang.String,java.lang.String,int,java.lang.String,java.lang.String,java.lang.String,java.lang.String)多参数构造函数根据出现的组件的要求引用非法字符。 这些构造函数始终引用百分比字符 ('%')。 保留任何其他字符。

</li>

<li>

#getRawUserInfo() getRawUserInfo、#getRawPath() getRawPath、#getRawQuery() getRawQuery#getRawFragment() getRawFragment和#getRawAuthority() getRawAuthority#getRawSchemeSpecificPart() getRawSchemeSpecificPart方法以原始形式返回其相应组件的值,而不解释任何转义的八进制值。 这些方法返回的字符串可以同时包含转义的八进制数 和其他 字符,并且不包含任何非法字符。

</li>

<li>

#getUserInfo() getUserInfo、#getPath() getPath、#getQuery() getQuery#getFragment() getFragment、#getAuthority() getAuthority和#getSchemeSpecificPart() getSchemeSpecificPart方法解码其相应组件中的任何转义八进制数。 这些方法返回的字符串可能包含 其他 字符和非法字符,并且不包含任何转义的八进制数。

</li>

<li>

该方法 #toString() toString 返回一个 URI 字符串,其中包含所有必需的引号,但可能包含 其他 字符。

</li>

<li>

该方法 #toASCIIString() toASCIIString 返回不包含 任何其他 字符的完全带引号和编码的 URI 字符串。

</li>

</ul>

<h4> 标识 </h4>

对于任何 URI u,始终存在这种情况

<blockquote>new URI(u.toString()).equals() 。 </blockquote>

对于不包含冗余语法的任何 URI u (如空颁发机构(如在 &nbsp;中) 或主机名之后的冒号(如

new URI(<i>u</i>.getScheme(),
<i>u</i>.getSchemeSpecificPart(),
<i>u</i>.getFragment())
                .equals(<i>u</i>)

在所有情况下,

new URI(<i>u</i>.getScheme(),
<i>u</i>.getUserInfo(), <i>u</i>.getAuthority(),
<i>u</i>.getPath(), <i>u</i>.getQuery(),
<i>u</i>.getFragment())
                .equals(<i>u</i>)

如果 u 是分层的,则为

new URI(<i>u</i>.getScheme(),
<i>u</i>.getUserInfo(), <i>u</i>.getHost(), <i>u</i>.getPort(),
<i>u</i>.getPath(), <i>u</i>.getQuery(),
<i>u</i>.getFragment())
                .equals(<i>u</i>)

如果 u 是分层的,并且没有颁发机构或基于服务器的颁发机构。

<h4> URI、URL 和 URN </h4>

URI 是一个统一的资源 标识符 ,而 URL 是统一的资源 定位符。 因此,每个 URL 都是一个 URI,抽象地说,但并非每个 URI 都是 URL。 这是因为 URI 有另一个子类别,统一的资源 名称 (URN),它命名资源,但不指定如何查找它们。 上面所示的 mailtoURI news和 isbn URI 是 URN 的示例。

URI 和 URL 之间的概念区别反映在此类和 URL 类之间的差异中。

此类的实例表示 RFC 2396 定义的语法意义上的 URI 引用。 URI 可以是绝对 URI 或相对 URI。 URI 字符串根据泛型语法进行分析,而不考虑方案(如果有的话)。它指定。 不查找执行主机(如果有)且未构造依赖于方案的流处理程序。 在实例的字符内容方面,严格定义相等、哈希和比较。 换句话说,URI 实例只不过是一个结构化字符串,它支持比较、规范化、解析和相对化的语法、与方案无关的操作。

相比之下,类的 URL 实例表示 URL 的语法组件以及访问所描述的资源所需的一些信息。 URL 必须是绝对的,也就是说,它必须始终指定方案。 URL 字符串根据其方案进行分析。 流处理程序始终为 URL 建立,事实上,无法为没有可用的处理程序的方案创建 URL 实例。 相等和哈希取决于主机的方案和 Internet 地址(如果有);未定义比较。 换句话说,URL 是一个结构化字符串,支持解析语法操作,以及查找主机并打开与指定资源的连接的网络 I/O 操作。

在 1.4 中添加。

Java文档java.net.URI。

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

构造函数

名称 说明
URI(String, String, String, Int32, String, String, String)

从给定组件构造分层 URI。

URI(String, String, String, String, String)

从给定组件构造分层 URI。

URI(String, String, String, String)

从给定组件构造分层 URI。

URI(String, String, String)

从给定组件构造 URI。

URI(String)

通过分析给定字符串来构造 URI。

属性

名称 说明
Authority

返回此 URI 的已解码颁发机构组件。

Class

返回此 Object的运行时类。

(继承自 Object)
Fragment

返回此 URI 的解码片段组件。

Handle

基础 Android 实例的句柄。

(继承自 Object)
Host

返回此 URI 的主机组件。

IsAbsolute

指示此 URI 是否为绝对 URI。

IsOpaque

指示此 URI 是否不透明。

JniIdentityHashCode

获取互操作运行时分配给此Java对等的标识哈希代码。

(继承自 Object)
JniManagedPeerState

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
JniPeerMembers

获取用于访问此Java绑定成员的 JNI 元数据。

Path

返回此 URI 的解码路径组件。

PeerReference

获取此Java对等方的 JNI 对象引用。

(继承自 Object)
Port

返回此 URI 的端口号。

Query

返回此 URI 的已解码查询组件。

RawAuthority

返回此 URI 的原始颁发机构组件。

RawFragment

返回此 URI 的原始片段组件。

RawPath

返回此 URI 的原始路径组件。

RawQuery

返回此 URI 的原始查询组件。

RawSchemeSpecificPart

返回此 URI 的原始方案特定部分。

RawUserInfo

返回此 URI 的原始用户信息组件。

Scheme

返回此 URI 的方案组件。

SchemeSpecificPart

返回此 URI 中解码的方案特定部分。

ThresholdClass

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
ThresholdType

此 API 支持 Mono for Android 基础结构,不打算直接从代码使用。

(继承自 Object)
UserInfo

返回此 URI 的已解码用户信息组件。

方法

名称 说明
Clone()

创建并返回此对象的副本。

(继承自 Object)
CompareTo(URI)

将此 URI 与另一个对象进行比较,该对象必须是 URI。

Construct(JniObjectReference, JniObjectReferenceOptions)

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
Create(String)

通过分析给定字符串来创建 URI。

Dispose()

释放此Java对等方持有的资源。

(继承自 Object)
Dispose(Boolean)

释放此Java对等方持有的资源。

(继承自 Object)
DisposeUnlessReferenced()

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
Equals(Object)

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
Equals(Object)

指示其他对象是否“等于”此对象。

(继承自 Object)
GetHashCode()

返回对象的哈希代码值。

(继承自 Object)
JavaFinalize()
已过时.

当垃圾回收确定不再引用该对象时,由对象上的垃圾回收器调用。

(继承自 Object)
Normalize()

规范化此 URI 的路径。

Notify()

唤醒正在等待此对象的监视器的单个线程。

(继承自 Object)
NotifyAll()

唤醒正在等待此对象的监视器的所有线程。

(继承自 Object)
ParseServerAuthority()

尝试将此 URI 的颁发机构组件(如果已定义)分析为用户信息、主机和端口组件。

Relativize(URI)

将给定 URI 与此 URI 相对化。

Resolve(String)

通过分析给定的字符串并针对此 URI 解析它来构造一个新 URI。

Resolve(URI)

解析针对此 URI 的给定 URI。

SetHandle(IntPtr, JniHandleOwnership)

设置 Handle 属性。

(继承自 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
ToArray<T>()

从此Java数组包装器创建托管数组。

(继承自 Object)
ToASCIIString()

以 US-ASCII 字符串的形式返回此 URI 的内容。

ToString()

返回对象的字符串表示形式。

(继承自 Object)
ToURL()

从此 URI 构造 URL。

UnregisterFromRuntime()

从互操作运行时取消注册此Java对等。

(继承自 Object)
Wait()

使当前线程等待,直到唤醒它,通常是通过 em 通知/em< 或 >em<interrupted>/em<。><>

(继承自 Object)
Wait(Int64, Int32)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)
Wait(Int64)

使当前线程等待直到唤醒,通常是通过 <em>通知</em> 或 <em interrupted>/em<>,或直到经过一定数量的实时。

(继承自 Object)

显式接口实现

名称 说明
IComparable.CompareTo(Object)

将此对象与指定的顺序对象进行比较。

IJavaPeerable.Disposed()

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
IJavaPeerable.Finalized()

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

表示统一资源标识符 (URI) 引用。

(继承自 JavaObject)
IJavaPeerable.UnregisterFromRuntime()

从运行时的Java对象查找中删除此实例。

扩展方法

名称 说明
GetJniTypeName(IJavaPeerable)

获取实例 self类型的 JNI 名称。

JavaAs<TResult>(IJavaPeerable)

尝试强制self键入TResult,检查强制是否在Java端有效。

JavaCast<TResult>(IJavaObject)

执行 Android 运行时检查的类型转换。

JavaCast<TResult>(IJavaObject)

表示统一资源标识符 (URI) 引用。

TryJavaCast<TResult>(IJavaPeerable, TResult)

尝试强制self键入TResult,检查强制是否在Java端有效。

适用于