メインコンテンツまでスキップ

Appendix A. Examples (例)

Appendix A. Examples (例)​

このセクションでは, GET リクエストのメッセージフローに関するいくつかの短い例を示します。これらの例は, 基本的な動作, 再送信が存在する場合の動作, およびマルチキャストを示しています。

図 16 は, ピギーバック応答 (piggybacked response) を引き起こす基本的な GET リクエストを示しています: クライアントは, リソース coap://server/temperature に対する Confirmable GET リクエストをサーバーに送信し, Message ID は 0x7d34 です。このリクエストには 1 つの Uri-Path Option が含まれています (Delta 0 + 11 = 11, Length 11, Value "temperature"); Token は空のままです。このリクエストは合計 16 バイトの長さです。2.05 (Content) 応答は, Confirmable リクエストを確認する Acknowledgement メッセージで返され, 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 では, Confirmable 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 では, サーバーからクライアントへの最初の Acknowledgement メッセージが失われます。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 では, サーバーは Confirmable リクエストを確認し, 別の Confirmable メッセージで 2.05 (Content) 応答を送信します。Acknowledgement メッセージと Confirmable 応答は, 必ずしも送信された順序で到着するとは限りません。クライアントは Confirmable 応答を確認します。

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 は, クライアントが Confirmable リクエストを送信した直後に状態を失う (例えば, クラッシュして再起動する) 例を示しており, そのため後から到着する個別の応答は予期しないものとなります。この場合, クライアントは Reset メッセージで Confirmable 応答を拒否します。予期しない 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 は, リクエストと応答がともに Non-confirmable である基本的な GET リクエストを示しており, そのため両方とも通知なしに失われる可能性があります。

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 では, クライアントはマルチキャストアドレスに Non-confirmable GET リクエストを送信します: リンクローカルスコープ内のすべてのノード。リンク上には 3 つのサーバー A, B, C があります。サーバー A と B には一致するリソースがあるため, Non-confirmable 2.05 (Content) 応答を返します。B から送信された応答は失われます。C には一致する応答がないため, Non-confirmable 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

に最終更新