URI 术语

注： 后面大量章节涉及到 URI 标准中的诸多术语，为了概念清晰，单独开一章来介绍。

URI的语法

通用 URI 和绝对 URI 的语法参考最初定义在 RFC 2396,发布于1998年，并定稿于 RFC 3986， 发布于 2005年。

通用 URI 的形式如下：

  1. scheme:[//[user:password@]host[:port]][/]path[?query][#fragment]

它包括：

  • scheme

    由一系列字符组成，以字母开头，跟着有字母，数字，加号(+)，点号(.)或者中划线(-)的任何组合。

    虽然 scheme 是大小写不敏感，但是权威形式是小写并注明特定 scheme 必须也同样是小写。后面跟一个冒号(:)。流行的 scheme 例子包括 http, ftp, mailto, file, 和 data 。URI scheme 应该在 Internet Assigned Numbers Authority (IANA) 注册,虽然不注册的 scheme 实际也在使用。

  • 双斜杠(//)

    某些 scheme 要求有这个， 而有些 scheme 不要求。当 authority 部分缺失时， path 部分不能以双斜杠开始。

  • authority部分

    包括：

    • 可选的认证部分，有用户名和密码，冒号分隔，带一个@符号
    • host,包括一个被注册名字(包括但是不限于hostname)，或者 IP 地址。IPv4 地址必须以点号分割的形式，而 IPv6 地址必须加[]符号。
    • 可选的端口号，和hostname之间用冒号分隔。

  • 路径

    包含数据，通常以层次形式组织，表现为一系列斜杠分隔的部分。这样一个序列可能类似或者映射到文件系统路径，但是并不暗示一定和某个路径有关系。如果有 authortity 部分，则路径必须以单斜杠开始，

  • 可选的query

    和之前的部分以问号(?)分隔，包含非层次数据的 query string 。它的语法没有很好的定义，但是习惯上通常是一系列的属性值对，以分隔符分隔。

  • 可选的fragment/片段*

    和之前的部分以#分隔。fragment 包括一个 fragment identifier / 片段标识，提供到间接资源的引导，就像文章中的章节头，通过URI的剩余部分定位。当首要资源是 HTML 文档时，fragment 通常是一个特别原始的 id 属性，而web浏览器将滚动这个元素到视野中。

例子

下面的图片展示了两种URI的例子，和他们的组成部分。

  1.                     hierarchical part
  2.         ┌───────────────────┴─────────────────────┐
  3.                     authority               path
  4.         ┌───────────────┴───────────────┐┌───┴────┐
  5.   abc://username:password@example.com:123/path/data?key=value&key2=value2#fragid1
  6.   └┬┘   └───────┬───────┘ └────┬────┘ └┬┘           └─────────┬─────────┘ └──┬──┘
  7. scheme  user information     host     port                  query         fragment
  1.   urn:example:mammal:monotreme:echidna
  2.   └┬┘ └──────────────┬───────────────┘
  3. scheme              path

特别强调

authority代表URI中的 [userinfo@]host[:port]，包括host(或者ip)和可选的port和userinfo。

这个术语平时用的不多，但是在gRPC中频繁出现，请牢记：authority 代表 username:password@example.com:123 这一段。

参考资料