古いバージョンのドキュメントです。最新のバージョンはRails7.0.0

Railsドキュメント(v6.0.2.1)

1対1の関連を宣言

説明

別のモデルとの1対1の関連付けを指定

使い方

has_one(関連モデル名 [, scope ,オプション])

オプション

オプション 説明
:class_name 関連名と参照元のクラス名を異なるものにしたい場合に指定
:dependent 値を:destroyにすると、参照先が削除される場合に参照元もDBから削除
:foreign_key 関連で使用する外部キー名
:foreign_type オブジェクトタイプを指定
:primary_key 参照先のテーブルに定義されている外部キーの名前を指定
:as ポリモーフィック関連を定義
:through 結合モデルの指定
:source has_one :throughの元となるオブジェクトを指定
:source_type polymorphicの指定
:validate オブジェクトが保存されると、バリデイトが実行される
:autosave 親のオブジェクトが保存されると、ロードされたオブジェクトも保存
:inverse_of モデルを指定
:required 関連先オブジェクトが存在するかバリデーション

追加されるメソッド

メソッド 説明
association(force_reload = false) 自分自身を参照しているオブジェクトを返す。オブジェクトが無い場合は、nilを返す
association=(associate) 引数を参照元オブジェクトとして設定。それ以外の参照元との関連は破棄
build_association(attributes = {}) 新しいオブジェクトを作成。引数にはオブジェクトを生成するのに必要なパラメータを指定。この時点では保存されない
create_association(attributes = {}) 新しいオブジェクトを作成して保存。引数にはオブジェクトを生成するのに必要なパラメータを指定
create_association!(attributes = {}) 新しいオブジェクトを作成して保存。引数にはオブジェクトを生成するのに必要なパラメータを指定。エラー時に例外を発生
reload_association リロード

保存

参照先オブジェクトが未保存の場合

参照先オブジェクトが保存済みの場合

UserとProjectの関係

マイグレーションファイル
class CreateUsersProjectsTable < ActiveRecord::Migration
  def self.up
    create_table :users_projects, id: false do |t|
      t.integer :user_id
      t.integer :project_id
    end
  end
  def self.down
    drop_table :users_projects
 vend
end
Userモデル
class User < ActiveRecord::Base
  has_one :project
end
Projectモデル
class Project < ActiveRecord::Base
  belongs_to :user
end

クラス名としてUserを指定

has_one :admin_user, class_name: "User"

user_id = 2を抽出

has_one :user, conditions: "user_id = 2"

逆順で並び替える

has_one :user, order: "id DESC"

データを削除するときに関連するテーブルを削除

has_one :user, dependent: :destroy

外部キーを指定

has_one :user, foreign_key: "blog_id"

ソースコード