Task.7-2 で前準備ができたので、早速 API の実装に取り掛かりましょう。

タスク内容

• active_model_serializers を使って、記事の一覧を json で返す機能を実装しよう。

  その際、serializer は記事の一覧とその他の処理の API 関してはレスポンスの内容を分けたいので、

  /app/serializers/api/v1/article_preview_serializer.rb

  に 記事一覧の serializer を作成して実装してください。

• request spec を実装しよう。

一覧機能の仕様

• 記事の一覧に関しては誰でもみれるようにする
• 記事の一覧機能のレスポンスには本文は含めない
• 記事の更新順に取得する（記事の一覧をフロントで表示する際の日付も、更新日をもとに表示する）

補足

• active_model_serializers のバージョンは 0.10 を使うようにしてください。
• request spec の階層に注意してください。（※ Rails の規約として、endpoint (今回で言えば /api/v1/articles) と controller の階層が同じになることに注意して実装すること）

0. そもそも serializer って何？

• 定義
  • モデルから取得したデータを、APIで返すJSONの形に整えて、返す項目を決めるための仕組み
• 何のため？どんなメリットが？
  • どの項目を返すか／どういう構造で返すかを、Serializer側で管理できる
    • Serializerにまとめると、ControllerにJSON形式でレスポンスを返すという内容を書く量が減り、返し方のルールが1か所に集まる
      • Controllerがスッキリして見通しが良くなる
      • 返すJSONの形を揃えやすくなり、変更も追いやすい
  • 必要な項目だけをフロント側に返せる
    • うっかりメールアドレスやトークンなど不要な情報まで返してしまう事故を減らせる

1. このTaskでやろうとしていること

• 何をやる？
  • ActiveModelSerializersのgemをインストールし、rails g コマンドを実行する。 /app/serializers/api/v1/article_preview_serializer.rbの作成
    • このSerializerを使って記事を返すとき、JSONに入れる項目を決める。
      • タイトル、本文、idなどなど
• なぜやる？
  • Serializerにまとめると、ControllerにJSON形式でレスポンスを返すという内容を書く量が減り、返し方のルールが1か所に集まる
    • Serializerを使用しない場合に書くコード
      • render json: { ... } の形
      • 返すキー（id, title, updated_at など）
    • Controllerがスッキリして見通しが良くなる
    • 返すJSONの形を揃えやすくなり、変更も追いやすい
  • 必要な項目だけをフロント側に返せる
    • うっかりメールアドレスやトークンなど不要な情報まで返してしまう事故を減らせる

2. 処理の流れ

1. ユーザー操作でリクエストが送られ、Controllerがparamsを受け取る
2. ControllerがModelを使って必要なデータを取得する