この章ではカードを作成・詳細・編集・削除する機能を実装していきます。作成・編集・削除機能は4章のリスト機能で実装してきて、似ている箇所は多くあります。プログラミングを学習する上で大事なことは何度も反復することです。この章でWebアプリケーション開発の基本的なことをマスターしましょう。

本パートの目標物

本パートでは、Cardモデルを作成し、アソシエーションの設定まで行います。

目標物を作成するまでの流れ

1. モデルの作成
2. アソシエーションの設定
3. バリデーションの設定

では実際に進めていきましょう。

1. モデルの作成

カード機能を作成するにはデータベースにカードの情報を保存する処理が必要になります。

なのでまずデータベースのやり取りを行うモデルを作成していきます。

カード作成に必要な情報は以下の2つになります。

Copied!
- カードのタイトル
- カードの詳細
- 誰が投稿したかカードの情報

この3つの情報を格納するためにcardsテーブルを作成します。

Cardモデルを作成

cardsテーブル構成は以下のようになります。

カラム名	データ型
title	string
memo	text
list	references

references型で保存すると、list_idを外部キーとして明示的に指定できます。

外部キーとは関連したテーブルの間を結ぶために設定する列のことです(今回でいうとlistsテーブルとcardsテーブル)。

モデルを作成するには、rails g model モデル名というコマンドでモデルを作成できます。

では、Cardモデルを作成するに以下のコマンドを実行してください。

Copied!
$ rails g model Card

上記のコマンドで新しくマイグレーションファイルも作成されます。

早速その作成されたマイグレーションファイルを以下のように編集してください。

Copied!
db
└── migrate
    └── xxxxxx_create_cards.rb

db/migrate/xxxxxx_create_cards.rb
123456789101112
            
Copied!
class CreateCards < ActiveRecord::Migration[6.0]
  def change
    create_table :cards do |t|
      # ==========ここから編集する==========
      t.string      :title, null: false, limit: 255
      t.text        :memo, limit: 1000
      t.references  :list, null: false, foreign_key: true
      # ==========ここまで編集する==========
      t.timestamps
    end
  end
end

references型は カラム名+"_id" がテーブル名として設定されるので、今回cardsテーブルにはlist_idというカラムが追加されます。

limit制約はデータ型の最大幅を指定するために使います。

では、マイグレーションファイルを実行してcardsテーブルを作成します。

Copied!
$ rails db:migrate

上記のコマンドを実行すると下記のような実行結果が表示されます。

Copied!
== 20190918070826 CreateCards: migrating ======================================
-- create_table(:cards)
   -> 0.0039s
== 20190918070826 CreateCards: migrated (0.0041s) =============================

2. アソシエーションの設定

モデルを作成したらアソシエーションの設定を行います。

アソシエーションとは、2つのモデル同士のつながりを指します。モデルとモデルの間には関連付けを行う必要があります。

参考）Active Record の関連付け (アソシエーション)

ListモデルとCardモデルのアソシエーションの設定

まずListモデルとCardモデルのアソシエーションを設定していきます。

上記2つのモデルの関係性は以下のようになります。

Copied!
- リストに複数のカードを作成することができる
- カードAに関して、カードAに紐づいているリストは1つしかない

このような関係のことを「1対多の関係」と言います。

では、app/models/list.rbに以下のコードを追加してください。

Copied!
app
└── models
    └── list.rb

app/models/list.rb
12345678
        
Copied!
class List < ApplicationRecord
  belongs_to :user

  # ここに追加
  has_many :cards, dependent: :destroy

  validates :title, length: { in: 1..255 }
end

ruby
1
 
Copied!
has_many :cards, dependent: :destroy

has_manyは、他のモデルとの間に「1対多」のつながりがあることを示します。(「1側」にhas_manyを追加します。）

has_manyが使用されている場合、「反対側」のモデルでは多くの場合belongs_toが使われます。

またdependent: :destroyをつけることで、オブジェクトが削除されるときに、関連付けられたオブジェクトのdestroyメソッドが実行されます。つまり今回で言うと、リストが削除されたら、そのリストに紐づくカードも削除します。

参考）Active Record の関連付け (アソシエーション) :dependent

次にapp/models/card.rbに以下のコードを追加してください。

Copied!
app
└── models
    └── card.rb

app/models/card.rb
1234
    
Copied!
class Card < ApplicationRecord
  # この行を追加
  belongs_to :list
end

これでListモデルとCardモデルのアソシエーション設定ができました。

3. バリデーションの設定

値がデータベースに保存される前に、そのデータが正しいかどうかを検証する仕組みをバリデーションといいます。

今回は以下のバリデーションを追加します。

Copied!
- カードのタイトルの文字数が1文字以上255文字以下
- memoカラムの最大文字数が1000文字以下

app/models/card.rbに以下のコードを追加してください。

app/models/card.rb
12345678
        
Copied!
class Card < ApplicationRecord
  belongs_to :list

  # ==========ここから追加==========
  validates :title, length: { in: 1..255 }
  validates :memo,  length: { maximum: 1000 }
  # ==========ここまで追加==========
end

lengthは属性の値の長さを検証するメソッドです。

以上で今回のパートは終了です。

お疲れさまでした。