跳到主要内容

3. Links - 链接

link 是由 IRI (Internationalised Resource Identifier) 标识的两个资源之间的 typed connection.

一个 link 由以下部分组成:

  • context IRI - link 的来源
  • link relation type - 该关系的语义 (见 Section 4)
  • target IRI - 目标资源
  • target attributes (可选) - 关于该 link 或 target 的附加元数据

link 可以表达为:

{context IRI} has a {relation type} resource at {target IRI},
which has {target attributes}

实现说明

IRI vs URI

  • 在常见情况下, context IRI 会是 URI (RFC 3986)
  • 许多协议 (例如 HTTP) 不支持对 IRI 进行解引用
  • 在不支持 IRI 的序列化中, target IRI 会被转换为 URI

本规范对以下内容不作限制:

  • 指向或来自某个特定 IRI 的多个 link
  • 两个 IRI 之间具有不同类型的多个 link
  • 不同序列化之间 link 的相对顺序

target attributes

  • 描述该 link 或其 target 的键/值对
  • 示例: media type 提示, language 提示
  • 本规范不在全局范围内协调名称或用法
  • Link HTTP header 的通用属性在 Section 5 中定义

语法与 context

  • 不强制规定通用语法 - 由各序列化方式决定
  • 不要求特定 context - 由序列化方式定义
  • HTTP header 序列化在 Section 5 中规定

相关章节: