つくる:検索API完成

新しいことは出てきません

この回では、新しい知識は 1 つも出てきません。第5章で書いたものを 1 つにまとめて、fleama の検索を仕上げます。

受け取り方の全体像

第5章で、リクエストから値を受け取る道が出そろいました。

どれも文字列で届くという点は共通です。req.body だけは express.json() を通しているので、数値は数値のまま届きます。

順番が決まっている

検索の処理には、自然な順番があります。

絞り込む → 並べ替える → 切り出す

この順でないと結果が変わります。切り出してから絞り込むと、2 ページ目に表示される件数が足りなくなります。範囲を狭めるのは最後です。

守りの層が2つ付いた

第4章までの API は、素直な入力しか想定していませんでした。第5章で 2 つの層が付きます。

1. 入力検証 — おかしな入力を 400 で弾く
2. エラー用ミドルウェア — 想定外の失敗を 500 で受け止める

1 つ目は予想できる失敗、2 つ目は予想できない失敗の受け皿です。この 2 つがあると、API は簡単には落ちなくなります。

ここまでに手に入れたもの

手を動かす

演習では、第5章のすべてを備えた検索 API を組み立てます。絞り込み・並べ替え・切り出しの順番に気をつけてください。

1. GET /items は 絞り込む → 並べ替える → 切り出す の順に処理する
2. POST /items は name 必須と price の型を確かめ、通れば「最大の id + 1」で 201 を返す
3. すべてのルートより後にエラー用ミドルウェアを置き、500 で {"error":"サーバーで問題が起きました"} を返す