つくる:商品CRUD完成

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

この回では、新しい知識は 1 つも出てきません。第4章の 5 つのルートを 1 つの createApp にまとめて、fleama の商品 API を完成させます。

設計図と突き合わせる

最初に書いた表がそのまま完成の基準になります。

GET    /items      商品一覧を返す          200
GET    /items/:id  商品1件を返す           200 / 404
POST   /items      商品を登録する          201
PUT    /items/:id  商品を書き換える        200 / 404
DELETE /items/:id  商品を削除する          204 / 404

この 5 行が揃うと、フリマとして必要な操作が一通りできます。CRUD と呼ばれる 4 つの操作、つまり作る・読む・書き換える・消すが、これで出そろいました。

同じ形が繰り返される

5 つを並べると、変更系がどれも同じ骨格をしていることが分かります。

1. 対象を探す
2. 無ければ 404 を返して抜ける
3. あれば処理して、決まったコードで返す

この繰り返しに気付けたなら、第4章の狙いは達成できています。同じ形が続くということは、あとでまとめて直せるということでもあります。第5章のミドルウェアで、その手立てを学びます。

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

手を動かす

演習では、5 つのルートをすべて備えた商品 API を組み立てます。第4章の総仕上げです。

1. GET /items は一覧を配列で、GET /items/:id は 1 件を返す(無ければ 404)
2. POST /items は「最大の id + 1」で登録し 201 で返す(sold は false)
3. PUT /items/:id は name と price を書き換えて 200、DELETE /items/:id は 204 を本文なしで返す(どちらも無ければ 404)