差出人: Joana Pires(Fernhill Garden Supply、バックエンドのリーダー)
「次の四半期に注文サービスを新しいフレームワークに移行します。移行で誤って動作が変わらないよう、まずそのルールを素のJavaでテスト付きで書き出しておきたいと考えています。
リクエストの行に応答するApiクラスを作ってください。注文の一覧、作成、読み取りを行い、skuとquantityを検証し、冪等性キーで作成を安全に再試行できるようにし、JSONを返し、すべてのエラーに同じproblem detailsの本文を付けます。フレームワークもデータベースも使いません。マップで十分です。」
完了の条件: ルーティングからproblem detailsのエラーまで、スクリプト化されたすべてのリクエストが正しいステータスと本文を受け取ること。
このプロジェクトでは、Webサービスのうち、フレームワークが書いてくれない部分であるルールを作ります。リクエストは1行のテキストとして届き、Apiクラスはステータスと本文で応答します。各ステップで1つの動作を加え、それまでのすべてを維持するため、自分のコードがそのまま引き継がれます。
リクエストを200、201、404、405にルーティングし、注文のフィールドを検証し、idを付けて注文を保存し、冪等性キーでPOSTを安全に再試行できるようにし、JSONの本文を返し、最後にすべての失敗に対して1つのエラーの形式を用意します。
テストはリクエストの短いスクリプトを送り、すべての応答を比べるため、前のルールを壊す変更はすぐにわかります。