【Rails】Formオブジェクト入門｜モデル・コントローラー肥大化を防ぐ

2025年3月27日2025年4月5日

Ruby on Railsでの開発では、「コントローラーやモデルが複雑化する」「フォームのバリデーション管理が大変」といった課題に直面しがちです。
特に、複数モデルのデータを扱う複雑なフォームは、コードの見通しを悪くし、保守性を低下させる原因となります。

この問題を解決する強力な設計パターンが「Formオブジェクト」です。
Formオブジェクトは、フォーム関連の処理（データ受け取り、バリデーション、保存など）を独立したクラスに切り出す手法です。
これにより、モデルやコントローラーをスリムに保ち、保守性の高いアプリケーションを構築できます。

Formオブジェクトとは？ – フォーム処理の専門家

Formオブジェクトは「フォームに関する処理の責任を持つ専用クラス」です。通常、Rails標準のActiveModel::Modelなどを利用して、データベースにテーブルを持たないモデルのように振る舞います。

導入効果:

関心の分離: モデル（データ永続化）、コントローラー（リクエスト処理）、Formオブジェクト（フォーム処理）の役割が明確になります。
コードの整理: フォーム関連ロジックが一箇所にまとまり、見通しが良くなります。
テスト容易性: Formオブジェクト単体でテストがしやすくなり、品質向上に繋がります。

なぜFormオブジェクトを使うべきか？主なメリット

コード整理と関心の分離: モデルやコントローラーが本来の責務に集中でき、コードが整理されます。
複雑なバリデーションの一元管理: ActiveRecordライクなバリデーションをFormオブジェクト内でまとめて管理できます。
複数モデル処理の簡潔化: 複数のモデルを扱う複雑な保存処理などをsaveメソッド内に隠蔽し、コントローラーをシンプルに保てます。
テスト容易性の向上: 外部依存性が少なく、単体テストを容易に記述できます。

RailsでのFormオブジェクト導入手順（基本）

1.クラス作成

# app/forms/user_form.rb
class UserForm
  include ActiveModel::Model      # 基本機能
  include ActiveModel::Attributes # 属性定義用
  include ActiveModel::Validations # バリデーション用

  attribute :name, :string
  attribute :email, :string

  validates :name, presence: true
  validates :email, presence: true, format: { with: URI::MailTo::EMAIL_REGEXP }

  def save
    return false unless valid? # バリデーション実行
    # モデルへの保存処理 (例: User.create)
    User.create(name: name, email: email)
    true # 成功
  rescue => e
    # エラー処理 (例: エラーをerrorsに追加)
    errors.add(:base, "保存に失敗しました: #{e.message}")
    false # 失敗
  end
end

2.コントローラーでの利用

# app/controllers/users_controller.rb
class UsersController < ApplicationController
  def new
    @form = UserForm.new
  end

  def create
    @form = UserForm.new(user_form_params)
    if @form.save
      redirect_to users_path, notice: '成功'
    else
      render :new, status: :unprocessable_entity
    end
  end

  private
  def user_form_params
    params.require(:user_form).permit(:name, :email)
  end
end

3.ビューでの利用

<%# app/views/users/new.html.erb %>
<%= form_with model: @form, url: users_path do |f| %>
  <%# エラー表示 %>
  <% if @form.errors.any? %>
    <div style="color: red;">... エラーメッセージ ...</div>
  <% end %>

  <div><%= f.label :name %><br><%= f.text_field :name %></div>
  <div><%= f.label :email %><br><%= f.email_field :email %></div>
  <div><%= f.submit %></div>
<% end %>

実践例：複数モデルを扱うFormオブジェクト

ユーザー(User)とプロフィール(Profile)を同時に作成する場合など、複数モデルを扱う際に特に有効です。

# app/forms/user_profile_form.rb
class UserProfileForm
  include ActiveModel::Model
  include ActiveModel::Attributes
  include ActiveModel::Validations

  attribute :name, :string
  attribute :email, :string
  attribute :bio, :string

  validates :name, presence: true
  validates :email, presence: true, format: { with: URI::MailTo::EMAIL_REGEXP }
  validates :bio, length: { maximum: 300 }

  def save
    return false unless valid?

    ActiveRecord::Base.transaction do
      user = User.create!(name: name, email: email)
      user.create_profile!(bio: bio) if bio.present?
    end

    true
  rescue ActiveRecord::RecordInvalid => e
    Rails.logger.warn("UserProfileForm Error: #{e.message}, Record: #{e.record.inspect}")
    map_activerecord_errors(e.record)
    false
  rescue => e
    Rails.logger.error("UserProfileForm Unexpected Error: #{e.message}\n#{e.backtrace.join("\n")}")
    errors.add(:base, '予期せぬエラーが発生しました。')
    false
  end

  private

  def map_activerecord_errors(record)
    record.errors.each do |error|
      attribute_name = error.attribute
      message = error.message
      if self.respond_to?(attribute_name)
        errors.add(attribute_name, message)
      else
        errors.add(:base, "#{attribute_name.to_s.humanize} #{message}")
      end
    end
  end
end

ポイント:

属性の集約: 関連する複数のモデルから、フォームで必要な属性だけをFormオブジェクトに定義します。
バリデーションの集約: フォーム入力に対するバリデーションをFormオブジェクトにまとめます。
トランザクション: ActiveRecord::Base.transaction ブロックで複数のDB保存処理を囲むことで、処理の原子性（全部成功するか、全部失敗するか）を保証します。これによりデータの整合性が保たれます。
例外処理: create! や update! など ! 付きのメソッドは失敗時に ActiveRecord::RecordInvalid 例外を発生させます。これを rescue で捕捉し、具体的なエラー内容をFormオブジェクト自身の errors に追加することで、コントローラーやビューはFormオブジェクトのエラー情報だけを見ればよくなります。
カプセル化: このように複雑な複数モデルの保存ロジックとエラーハンドリングを save メソッド内に隠蔽（カプセル化）することで、コントローラー側は UserProfileForm オブジェクトを作成し、save メソッドを呼び出すだけで済むようになり、非常にシンプルになります。