buildメソッドとは？

buildメソッドはnewメソッドにかなり似たメソッドです。
ただし、場合によって、newメソッドを使用するよりbuildメソッドを使用することでコードの簡略化ができます。

newメソッドとの違い

new_post = Post.new

user = User.find(1)
new_post = user.posts.build(title: '新しい投稿', content: '投稿の内容')

特定の関連付けのコンテキスト内で新しいモデルインスタンスを作成し、そのインスタンスを自動的に関連付けるために使用されます。

buildメソッドを使用する場面は以下の条件が揃っている時です。

以下のように関連付けが定義されているとします。

class User < ApplicationRecord
  has_many :posts
end

IDが3のユーザーに紐づいたPostインスタンスを作成するには、以下のようにコードを記述します。

user = User.find(3)
post = user.posts.build

# newメソッドを使用するとこんな感じ
user = User.find(3)
post = Post.new(user_id: user.id)

これで、Postインスタンスのuser_idカラムには3と入っているはずです。

以下のように関連付けが定義されているとします。

class User < ApplicationRecord
  has_one :profile
end

has_oneで関連付けされている場合には、メソッド名が異なります。

IDが4のユーザーに紐づいたPostインスタンスを作成するには、以下のようにコードを記述します。

user = User.find(4)
user_profile = user.build_profile

# newメソッドを使用するとこんな感じ
user = User.find(4)
user_profile = Profile.new(user_id: user.id)

これで、Postインスタンスのuser_idカラムには4と入っているはずです。

belongs_toで関連付けされているオブジェクトに紐づけてインスタンスを作成する方法もありますが、汎用性は高くないのでここでは紹介しないこととします。

han_one,has_manyで関連付けしているオブジェクトのインスタンスを作成するにはbuildメソッドを使えば、ぱっと見で「何と紐づいているのかな？」っていうのがわかりそうですね。