coap协议RFC中文文档
main
main
  • Introduction
  • 1 简介
    • 1.1 特性
    • 1.2 术语解释
  • 2 受限应用协议CoAP
    • 2.1 消息模型
    • 2.2 请求响应模型
    • 2.3 中间人和缓存
    • 2.4 资源发现
  • 3 消息格式
    • 3.1 Option的格式
    • 3.2 Option Value的格式
  • 4 消息传递
    • 4.1 消息和端
    • 4.2 可靠的消息传输
    • 4.3 没有可靠性保障的消息传输
    • 4.4 消息之间的关联
    • 4.5 去除重复消息
    • 4.6 消息大小
    • 4.7 拥塞控制
    • 4.8 传输参数
      • 4.8.1 改变参数
      • 4.8.2 传输参数的衍生时间
  • 5 请求/响应的语意
    • 5.1 请求
    • 5.2 响应
      • 5.2.1 附带响应
      • 5.2.2 单独响应
      • 5.2.3 无需确认消息NON
    • 5.3 请求/响应的匹配
      • 5.3.1 令牌(token)
      • 5.3.2 请求响应的匹配规则
    • 5.4 选项(option)
      • 5.4.1 重要选项/非重要选项Critical/Elective
      • 5.4.2 代理不安全或安全转发和无缓存键
      • 5.4.3 长度
      • 5.4.4 默认值
      • 5.4.5 可重复选项
      • 5.4.6 选项编号
    • 5.5 Payload和表现
      • 5.5.1 表现
      • 5.5.2 诊断式的payload
      • 5.5.3 经由选择的表现
      • 5.5.4 内容协商
    • 5.6 缓存
      • 5.6.1 新鲜度模型
      • 5.6.2 校验模型
    • 5.7 代理
      • 5.7.1 代理操作
      • 5.7.2 正向代理
      • 5.7.3 反向代理
    • 5.8 方法定义
      • 5.8.1 GET
      • 5.8.2 POST
      • 5.8.3 PUT
      • 5.8.4 DELETE
    • 5.9 返回码定义
      • 5.9.1 成功2.xx
        • 5.9.1.1 2.01 Created
        • 5.9.1.2 2.02 Deleted
        • 5.9.1.3 2.03 Valid
        • 5.9.1.4 2.04 Changed
        • 5.9.1.5 2.05 Content
      • 5.9.2 客户端错误4.xx
        • 5.9.2.1 4.00 Bad Request
        • 5.9.2.2 4.01 Unauthorized
        • 5.9.2.3 4.02 Bad Option
        • 5.9.2.4 4.03 Forbidden
        • 5.9.2.5 4.04 Not Found
        • 5.9.2.6 4.05 Method Not Allowed
        • 5.9.2.7 4.06 Not Acceptable
        • 5.9.2.8 4.12 Precondition Failed
        • 5.9.2.9 4.13 Request Entity Too Large
        • 5.9.2.10 4.15 Unsupported Content-Format
      • 5.9.3 服务端错误5.xx
        • 5.9.3.1 5.00 Internal Server Error
        • 5.9.3.2 5.01 Not Implemented
        • 5.9.3.3 5.02 Bad Gateway
        • 5.9.3.4 5.03 Service Unavailable
        • 5.9.3.5 5.04 Gateway Timeout
        • 5.9.3.6 5.05 Proxying Not Supported
    • 5.10 Option定义
      • 5.10.1 Uri-Host,Uri-Port,Uri-Path,Uri-Query
      • 5.10.2 Proxy-Uri和Proxy-Scheme
      • 5.10.3 Content-Format
      • 5.10.4 Accept
      • 5.10.5 Max-Age
      • 5.10.6 ETag
        • 5.10.6.1 作为响应选项的ETag
        • 5.10.6.2 作为请求选项的ETag
      • 5.10.7 Location-Path和Location-Query
      • 5.10.8 条件请求选项
        • 5.10.8.1 If-Match
        • 5.10.8.2 If-None-Match
      • 5.10.9 Size1选项
  • 6 CoAP URI
    • 6.1 Coap URI scheme
    • 6.2 Coaps URI scheme
    • 6.3 标准化和比较规则
    • 6.4 将URI解码为选项
  • 7 发现
    • 7.1 服务发现
    • 7.2 资源发现
      • 7.2.1 ‘ct’特性
  • 8 多播CoAP
    • 8.1 消息层
    • 8.2 请求响应层
      • 8.2.1 Caching
      • 8.2.2 代理
  • 9 安全CoAP
    • 9.1 DTLS-Secured CoAP
      • 9.1.1 消息层
      • 9.1.2 请求响应层
      • 9.1.3 端点身份
        • 9.1.3.1 Pre-Shared Keys
        • 9.1.3.2 原始公钥证书
          • 9.1.3.2.1 配置
        • 9.1.3.3 X.509证书
  • 10 CoAP和HTTP的跨协议代理
    • 10.1 CoAP-HTTP代理
      • 10.1.1 GET
      • 10.1.2_PUT
      • 10.1.3 DELETE
      • 10.1.4 POST
    • 10.2 HTTP-CoAP代理
      • 10.2.1 OPTIONS and TRACE
      • 10.2.2 GET
      • 10.2.3 HEAD
      • 10.2.4 POST
      • 10.2.5 PUT
      • 10.2.6 DELETE
      • 10.2.7 CONNECT
  • 11 安全事项
    • 11.1 解析协议和处理URIs
    • 11.2 代理和缓存
    • 11.3 增幅的风险
    • 11.4 地址欺骗攻击
    • 11.5 跨协议攻击
    • 11.6 受限节点的注意事项
  • 12 互联网地址分配注意事项(IANA Considerations)
    • 12.1 CoAP代码注册
      • 12.1.1 方法码
      • 12.1.1 响应码
    • 12.2 CoAP选项码注册(CoAP Option Number Registry)
    • 12.3 CoAP内容格式注册(CoAP Cotent-Formats Registry)
    • 12.4 URI方案注册(URI Scheme Registration)
    • 12.5 安全URI规范注册表
    • 12.6 服务名称和端口号注册表
    • 12.7 安全服务名称和端口号注册表
    • 12.8 多播地址表
由 GitBook 提供支持
在本页

这有帮助吗?

  1. 6 CoAP URI

6.4 将URI解码为选项

上一页6.3 标准化和比较规则下一页7 发现

最后更新于3年前

这有帮助吗?

将请求的URI解析成option的步骤如下所述。经过这些步骤后,要么生成包含0个或多个Uri-Host、Uri-Port、Uri-Path和Uri-Query选项的请求,要么会失败。

  1. 如果URI不是一个绝对URI(),那么解析失败。

  2. 采用中的解决方案来处理URL。在这一步,即使在第5、8、9步后会被解码成UTF-8,URL是ASCII编码。

    注意:不用关心这个URL是和谁相关的,因为我们知道此时它是一个绝对URL。

  3. 如果被转化成为小写ASCII字符后的URL不含有值为“coap”或者“coaps”的scheme组件,那么解析失败。

  4. 如果URL有一个fragment组件,那么解析失败。

  5. 如果URL中的host组件不是以ip字符串格式组成的请求端目的ip地址,那么要包含一个Uri-Host选项,并且让选项的值和host组件的值相同,转化为ASCII小写字母,然后将所有百分号编码转化为为对应的字符。

    注意:通常来说请求的目的ip地址是从host获取,它保证了Uri-Host选项仅用于host组件,格式为reg-name。

  6. 如果URL有port组件,那么将port的值解析成十进制整型,否则,port采用默认值。

  7. 如果port的值和请求的目的UDP端口不一致,增加Uri-Port选项并将其值置为port的值。

  8. 如果URL中的path组件为空或者只有一个“/”(U+002F),则进行下一步;否则,针对path组件中的每个段,都需要包含一个Uri-Path选项,且将选项的值(将百分号编码转换为对应的字符后)置为这个段的值(不含分隔符)。

  9. 如果URL有query组件,那么,针对每个query组件中的参数,都需要包含一个Uri-Query选项,并且让选项的值(将百分号编码转换为对应的字符后)为该参数的值(不包含“?”和“&”)。

    注意,这些规则可以完全解析任何百分比编码。

    6.5, 将选项编码成URI

    将请求选项转化为URI的步骤如下。经过这些步骤后,要么会生成一个URI,要么失败。在这些步骤中,百分号编码一个字符意味着将每个UTF8编码字符转化成由一个“%”开头的、两字节的十六进制数,其中A-F是大写的(如2.1节中采用的定义,为了减要么少复杂度,CoAP URI中,百分号编码中的十六进制数必须为大写)。unreserved和sub-delims的定义请参考。

  10. 如果请求用DTLS加密,则URL开头用“coaps://”,否则用“coap://”。

  11. 如果请求包含了Uri-Host选项,则将URL中的host的值置为该选项的值,所有非ASCII的字符转化成百分号编码。如果host不是一个合法的域名格式或者ip格式,将导致失败。如果请求没有Uri-Host选项,将host的值置为请求的目的ip地址(V4或V6格式)。

  12. 添加host到URL。

  13. 如果请求中有Uri-Port选项,则将port组件的值置为该选项的值。否则采用请求的目的端UDP端口。

  14. 如果port不是该scheme默认的端口号,则采用“:”+port值的方式加载URL后面。

  15. 将resource name清空。对请求中的每个Uri-Path选项,采用“/”+选项的值跟随在resource name后面。在此之前,需要先将不在unreserved集、sub-delims集、不为“:”、“@”的字符转化为百分号编码。

  16. 如果resource name为空,将它设置为“/”。

  17. 对请求中的每个Uri-Query选项,采用“?”(第一个选项)或“&”(后续选项)+选项值的形式编码到resource name中(同样的,在此之前,需要先将不在unreserved集、sub-delims集、不为“:”、“@”、“/”、“?”的字符转化为百分号编码)。

  18. 将resource name添加到URL中。

  19. 返回URL。

注意:这些步骤旨在以标准形式构建一个URI(参见6.3节)。

[RFC3986]
[RFC3986]
[RFC3629]
[RFC0020]
[RFC3986]
[RFC3986]