リクエストボディとJSON

このレッスンで学ぶこと

リクエストボディは、URLに載せずに送るデータの本体です。この回では、その形式と、受け取ったあとに何を確かめるのかを整理します。

読み終えるころには、届いたボディを使うまでの確認を、5つの段階で並べられるようになります。

主な形式

ボディの形式は Content-Type で示します。よく使うのは3つです。

JSON はこう送られます。

{"itemId": 42, "quantity": 2, "note": "急ぎ"}

読めることと正しいことは違う

ここが今回の要です。JSON として解釈できたことは、内容が妥当であることを何も保証しません。

解釈は通るが、内容として困るものはいくらでもあります。

• {"quantity": -5} 負の数
• {"quantity": "2"} 数のつもりが文字列
• {"quantity": 99999999} 桁が大きすぎる
• {"price": 1} 送るはずのない項目

最後が特に重要です。値段や権限のように、サーバーが決めるべき値が入っていても、JSON としては何もおかしくありません。

確かめる順番

受け取ったら、順に確かめます。

1. 解釈できるか。 壊れた JSON なら、そこで断る
2. 項目がそろっているか。 必須のものが無ければ断る
3. 型が合っているか。 数のはずが文字列なら断る
4. 範囲に入っているか。 負の数、大きすぎる値、長すぎる文字列
5. その人が指定してよい項目か。 値段や権限は無視して、サーバー側で決め直す

5番目は検証というより設計です。そもそも受け取らないのが一番確実です。

大きさの上限

ボディの大きさに上限を置きます。上限が無いと、巨大な本文を送りつけるだけで処理と記憶領域を使い切らせることができます。可用性の話がここにつながります。

まとめ