Skip to main content

RFC 6570 - URI Template (URI模板)

标准跟踪文档

发布日期: 2012年3月

作者:

  • J. Gregorio (Google)
  • R. Fielding (Adobe)
  • M. Hadley (MITRE)
  • M. Nottingham (Rackspace)
  • D. Orchard (Salesforce.com)

Abstract (摘要)​

URI Template (URI模板) 是一个紧凑的字符序列，用于通过变量扩展描述一系列统一资源标识符。本规范定义了URI模板语法以及将URI模板扩展为URI引用的过程，以及在Internet上使用URI模板的指南。

Status of This Memo (本备忘录状态)​

这是一个Internet标准跟踪文档。

本文档是Internet工程任务组(IETF)的产品。它代表了IETF社区的共识。它已经接受了公众审查，并已获得Internet工程指导组(IESG)的批准出版。有关Internet标准的更多信息，请参见RFC 5741第2节。

有关本文档当前状态、任何勘误表以及如何提供反馈的信息，可从http://www.rfc-editor.org/info/rfc6570获取。

Copyright (c) 2012 IETF Trust and the persons identified as the document authors. All rights reserved.

本文档受BCP 78和IETF信托有关IETF文档的法律规定(http://trustee.ietf.org/license-info)的约束，这些规定在本文档发布之日有效。请仔细阅读这些文档，因为它们描述了您对本文档的权利和限制。从本文档中提取的代码组件必须包含简化BSD许可证文本，如信托法律规定第4.e节所述，并按简化BSD许可证中所述不提供保证。

Table of Contents (目录)​

主要章节​

  • 1. Introduction (简介)

    • 1.1. Overview (概述)
    • 1.2. Levels and Expression Types (级别和表达式类型)
    • 1.3. Design Considerations (设计考虑)
    • 1.4. Limitations (限制)
    • 1.5. Notational Conventions (符号约定)
    • 1.6. Character Encoding and Unicode Normalization (字符编码和Unicode规范化)

  • 2. Syntax (语法)

    • 2.1. Literals (字面量)
    • 2.2. Expressions (表达式)
    • 2.3. Variables (变量)
    • 2.4. Value Modifiers (值修饰符)
      • 2.4.1. Prefix Values (前缀值)
      • 2.4.2. Composite Values (复合值)

  • 3. Expansion (扩展)

    • 3.1. Literal Expansion (字面扩展)
    • 3.2. Expression Expansion (表达式扩展)
      • 3.2.1. Variable Expansion (变量扩展)
      • 3.2.2. Simple String Expansion: {var} (简单字符串扩展)
      • 3.2.3. Reserved Expansion: {+var} (保留扩展)
      • 3.2.4. Fragment Expansion: {#var} (片段扩展)
      • 3.2.5. Label Expansion with Dot-Prefix: {.var} (带点前缀的标签扩展)
      • 3.2.6. Path Segment Expansion: {/var} (路径段扩展)
      • 3.2.7. Path-Style Parameter Expansion: {;var} (路径样式参数扩展)
      • 3.2.8. Form-Style Query Expansion: {?var} (表单样式查询扩展)
      • 3.2.9. Form-Style Query Continuation: {&var} (表单样式查询继续)

  • 4. Security Considerations (安全考虑)

  • 5. Acknowledgments (致谢)

  • 6. References (参考文献)

    • 6.1. Normative References (规范性参考文献)
    • 6.2. Informative References (信息性参考文献)

附录​

核心概念​

URI模板示例​

http://example.com/~{username}/
http://example.com/dictionary/{term:1}/{term}
http://example.com/search{?q,lang}

表达式类型​

URI模板支持多种表达式操作符：

  • 无操作符 - 简单字符串扩展：{var}
  • + - 保留字符扩展：{+var}
  • # - 片段标识符：{#var}
  • . - 标签扩展：{.var}
  • / - 路径段：{/var}
  • ; - 路径参数：{;var}
  • ? - 查询组件：{?var}
  • & - 查询继续：{&var}

级别系统​

  • Level 1: 基本字符串扩展
  • Level 2: 保留字符和片段扩展
  • Level 3: 多变量和路径/查询操作符
  • Level 4: 值修饰符(前缀和explode)

相关RFC​

  • RFC 3986: URI Generic Syntax
  • RFC 3987: Internationalized Resource Identifiers (IRIs)
  • RFC 5234: Augmented BNF for Syntax Specifications

维护信息​

RFC编号: 6570
类别: Standards Track
更新: 无
ISSN: 2070-1721

Last updated on