Skip to main content

Appendix A. Examples (示例)

Appendix A. Examples (示例)​

本节提供了一些关于 GET 请求的简短消息流示例。这些示例展示了基本操作, 在存在重传情况下的操作, 以及组播 (multicast) 的使用。

图 16 展示了一个导致捎带响应 (piggybacked response) 的基本 GET 请求: 客户端向服务器发送一个针对资源 coap://server/temperature 的可确认 (Confirmable) GET 请求, Message ID 为 0x7d34。该请求包含一个 Uri-Path Option (Delta 0 + 11 = 11, Length 11, Value "temperature"); Token 为空。该请求总共 16 字节长。一个 2.05 (Content) 响应在确认该可确认请求的确认消息 (Acknowledgement message) 中返回, 同时回显 Message ID 0x7d34 和空的 Token 值。响应包含 Payload "22.3 C", 长度为 11 字节。

Client  Server
   |      |
   |      |
   +----->|     Header: GET (T=CON, Code=0.01, MID=0x7d34)
   | GET  |   Uri-Path: "temperature"
   |      |
   |      |
   |<-----+     Header: 2.05 Content (T=ACK, Code=2.05, MID=0x7d34)
   | 2.05 |    Payload: "22.3 C"
   |      |
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 1 | 0 |   0   |     GET=1     |          MID=0x7d34           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  11   |  11   |      "temperature" (11 B) ...
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 1 | 2 |   0   |    2.05=69    |          MID=0x7d34           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|1 1 1 1 1 1 1 1|      "22.3 C" (6 B) ...
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Figure 16: Confirmable Request; Piggybacked Response

图 17 展示了一个类似的示例, 但在请求和响应中包含了一个非空的 Token (值为 0x20), 分别将大小增加到 17 和 12 字节。

Client  Server
   |      |
   |      |
   +----->|     Header: GET (T=CON, Code=0.01, MID=0x7d35)
   | GET  |      Token: 0x20
   |      |   Uri-Path: "temperature"
   |      |
   |      |
   |<-----+     Header: 2.05 Content (T=ACK, Code=2.05, MID=0x7d35)
   | 2.05 |      Token: 0x20
   |      |    Payload: "22.3 C"
   |      |
 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 1 | 0 |   1   |     GET=1     |          MID=0x7d35           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|     0x20      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|  11   |  11   |      "temperature" (11 B) ...
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+


 0                   1                   2                   3
 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
| 1 | 2 |   1   |    2.05=69    |          MID=0x7d35           |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|     0x20      |
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+
|1 1 1 1 1 1 1 1| "22.3 C" (6 B) ...
+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+

Figure 17: Confirmable Request; Piggybacked Response

在图 18 中, 可确认的 GET 请求丢失了。在 ACK_TIMEOUT 秒后, 客户端重传请求, 导致与前一个示例中相同的捎带响应。

Client  Server
   |      |
   |      |
   +----X |     Header: GET (T=CON, Code=0.01, MID=0x7d36)
   | GET  |      Token: 0x31
   |      |   Uri-Path: "temperature"
TIMEOUT   |
   |      |
   +----->|     Header: GET (T=CON, Code=0.01, MID=0x7d36)
   | GET  |      Token: 0x31
   |      |   Uri-Path: "temperature"
   |      |
   |      |
   |<-----+     Header: 2.05 Content (T=ACK, Code=2.05, MID=0x7d36)
   | 2.05 |      Token: 0x31
   |      |    Payload: "22.3 C"
   |      |

Figure 18: Confirmable Request (Retransmitted); Piggybacked Response

在图 19 中, 从服务器到客户端的第一条确认消息丢失了。在 ACK_TIMEOUT 秒后, 客户端重传请求。

Client  Server
   |      |
   |      |
   +----->|     Header: GET (T=CON, Code=0.01, MID=0x7d37)
   | GET  |      Token: 0x42
   |      |   Uri-Path: "temperature"
   |      |
   |      |
   | X----+     Header: 2.05 Content (T=ACK, Code=2.05, MID=0x7d37)
   | 2.05 |      Token: 0x42
   |      |    Payload: "22.3 C"
TIMEOUT   |
   |      |
   +----->|     Header: GET (T=CON, Code=0.01, MID=0x7d37)
   | GET  |      Token: 0x42
   |      |   Uri-Path: "temperature"
   |      |
   |      |
   |<-----+     Header: 2.05 Content (T=ACK, Code=2.05, MID=0x7d37)
   | 2.05 |      Token: 0x42
   |      |    Payload: "22.3 C"
   |      |

Figure 19: Confirmable Request; Piggybacked Response (Retransmitted)

在图 20 中, 服务器确认可确认请求, 并在一个单独的可确认消息中发送 2.05 (Content) 响应。请注意, 确认消息和可确认响应不一定按照它们发送的顺序到达。客户端确认该可确认响应。

Client  Server
   |      |
   |      |
   +----->|     Header: GET (T=CON, Code=0.01, MID=0x7d38)
   | GET  |      Token: 0x53
   |      |   Uri-Path: "temperature"
   |      |
   |      |
   |<- - -+     Header: (T=ACK, Code=0.00, MID=0x7d38)
   |      |
   |      |
   |<-----+     Header: 2.05 Content (T=CON, Code=2.05, MID=0xad7b)
   | 2.05 |      Token: 0x53
   |      |    Payload: "22.3 C"
   |      |
   |      |
   +- - ->|     Header: (T=ACK, Code=0.00, MID=0xad7b)
   |      |

Figure 20: Confirmable Request; Separate Response

图 21 展示了一个示例, 其中客户端在发送可确认请求后立即丢失其状态 (例如, 崩溃并重新启动), 因此稍后到达的单独响应是意外的。在这种情况下, 客户端用重置消息 (Reset message) 拒绝可确认响应。请注意, 意外的 ACK 被静默忽略。

Client  Server
   |      |
   |      |
   +----->|     Header: GET (T=CON, Code=0.01, MID=0x7d39)
   | GET  |      Token: 0x64
   |      |   Uri-Path: "temperature"
 CRASH    |
   |      |
   |<- - -+     Header: (T=ACK, Code=0.00, MID=0x7d39)
   |      |
   |      |
   |<-----+     Header: 2.05 Content (T=CON, Code=2.05, MID=0xad7c)
   | 2.05 |      Token: 0x64
   |      |    Payload: "22.3 C"
   |      |
   |      |
   +- - ->|     Header: (T=RST, Code=0.00, MID=0xad7c)
   |      |

Figure 21: Confirmable Request; Separate Response (Unexpected)

图 22 展示了一个基本的 GET 请求, 其中请求和响应都是不可确认的 (Non-confirmable), 因此两者都可能在没有通知的情况下丢失。

Client  Server
   |      |
   |      |
   +----->|     Header: GET (T=NON, Code=0.01, MID=0x7d40)
   | GET  |      Token: 0x75
   |      |   Uri-Path: "temperature"
   |      |
   |      |
   |<-----+     Header: 2.05 Content (T=NON, Code=2.05, MID=0xad7d)
   | 2.05 |      Token: 0x75
   |      |    Payload: "22.3 C"
   |      |

Figure 22: Non-confirmable Request; Non-confirmable Response

在图 23 中, 客户端向组播地址发送一个不可确认的 GET 请求: 链路本地范围 (link-local scope) 内的所有节点。链路上有 3 个服务器: A, B 和 C。服务器 A 和 B 具有匹配的资源, 因此它们发回一个不可确认的 2.05 (Content) 响应。B 发送的响应丢失了。C 没有匹配的响应, 因此它发送一个不可确认的 4.04 (Not Found) 响应。

Client  ff02::1  A  B  C
   |       |     |  |  |
   |       |     |  |  |
   +------>|     |  |  |  Header: GET (T=NON, Code=0.01, MID=0x7d41)
   |  GET  |     |  |  |   Token: 0x86
   |             |  |  |   Uri-Path: "temperature"
   |             |  |  |
   |             |  |  |
   |<------------+  |  |  Header: 2.05 (T=NON, Code=2.05, MID=0x60b1)
   |      2.05   |  |  |   Token: 0x86
   |             |  |  |   Payload: "22.3 C"
   |             |  |  |
   |             |  |  |
   |   X------------+  |  Header: 2.05 (T=NON, Code=2.05, MID=0x01a0)
   |      2.05   |  |  |   Token: 0x86
   |             |  |  |   Payload: "20.9 C"
   |             |  |  |
   |             |  |  |
   |<------------------+  Header: 4.04 (T=NON, Code=4.04, MID=0x952a)
   |      4.04   |  |  |   Token: 0x86
   |             |  |  |

Figure 23: Non-confirmable Request (Multicast); Non-confirmable Response

Last updated on