【ITニュース解説】released: active_record_compose 1.0.0 — Wrap multiple models with an ActiveModel interface

システム開発において、複数の種類のデータを連携させて一つの機能を実現することはよくある。例えば、ユーザーが会員登録をする際に、ユーザー名やメールアドレスといった基本情報とは別に、住所や生年月日などのプロフィール情報も同時に登録するようなケースがそれに当たる。これらの情報は、データベース上では「ユーザーテーブル」と「ユーザープロフィールテーブル」のように、別々のテーブルに分けて管理されることが多い。

Ruby on RailsのようなWebアプリケーションフレームワークでは、これらのデータベースのテーブルに対応する形で「モデル」と呼ばれるソフトウェアの部品を作成し、データの操作や管理を行う。例えば、ユーザーテーブルに対応するUserモデル、ユーザープロフィールテーブルに対応するUserProfileモデルといった具合だ。

しかし、これらの複数のモデルにまたがる操作を一つの画面や機能でまとめて行う場合、開発者は各モデルを個別に処理したり、それぞれのモデルの入力チェック（バリデーション）を管理したりする必要があるため、コードが複雑になりがちである。特に、ユーザー登録のように、複数のテーブルにデータを保存するだけでなく、それぞれのデータに対する厳密なチェックが必要な場面では、処理が煩雑になり、誤ったデータが保存されるリスクも高まる。

このような課題を解決するために「フォームオブジェクトパターン」という設計の考え方がある。これは、ユーザーがWebフォームから入力する情報が、実は複数のモデルにまたがる場合でも、それらの情報を一時的に一つの「フォームオブジェクト」として扱うことで、処理をシンプルにする方法だ。開発者はこのフォームオブジェクトを通して、入力されたデータのバリデーションを行い、その後にフォームオブジェクトが内部で持っている複数のモデルにデータを振り分け、保存するといった一連の操作をまとめることができる。これにより、アプリケーションの主要なロジックが簡潔になり、コードの読みやすさや保守性が向上する。

今回リリースされた「active_record_compose」というRubyのライブラリ（通称gem）は、このフォームオブジェクトパターンをRuby on Railsで簡単に実装するための強力なツールである。このgemを使うと、複数のActiveRecordモデル（データベースのテーブルに対応するモデル）を一つにまとめ、ActiveModelというRailsの基本的なデータモデル機能のインターフェースを通じて扱えるようになる。つまり、バラバラに管理されていた複数のデータモデルを、まるで一つの大きなモデルであるかのように扱うことができるのだ。

「active_record_compose」の核となる機能は、複数のActiveRecordモデルを「ラップ」（包み込む）し、それらを統一されたビジネスインターフェースとして提供することにある。これは、複雑なビジネス操作、例えば先述の「複数テーブルにまたがるユーザー登録」のような処理を、より簡潔に記述し、検証し、保守しやすくする。このgemは、Railsの既存のインフラであるActiveModel::Modelを基盤としているため、Railsに慣れた開発者にとっては比較的学習コストが低いというメリットもある。

具体的な例で考えてみよう。 あるシステムに、FooというモデルとBarというモデルが存在するとする。Fooモデルはnameという名前の情報を持ち、Barモデルはageという年齢の情報を持ち、それぞれ独自の入力チェック（バリデーション）ルールが設定されている。

「active_record_compose」を使うと、Bazという新しいモデルを作成し、その内部にFooモデルのインスタンスとBarモデルのインスタンスを持つことができる。Bazモデルは、Fooが持つnameとBarが持つageという属性（データ項目）を、あたかも自分自身の属性であるかのように「委譲」（delegate）する設定を行う。

これにより、開発者はBazのインスタンスを一つ作成し、nameやageといった属性を直接設定することができる。例えば、baz = Baz.new(name: "qux", age: nil)のようにインスタンスを作り、属性を渡すことが可能だ。このとき、baz.attributesと確認すると、{"name" => "qux", "age" => nil}という形で、FooとBarそれぞれの属性がBazの属性としてまとめられていることがわかる。

そして、baz.saveを呼び出すと、内部でFooとBarそれぞれのモデルに対する保存処理とバリデーションが自動的に実行される。上記の例でageがnil（未設定）の場合、Barモデルに設定された「ageは必須」というバリデーションルールによってエラーが発生する。このエラーはBazインスタンスに伝播し、baz.saveはfalseを返す。baz.errors.to_aを確認すると、「Age can't be blank」（年齢は空白にできません）というBarモデル由来のエラーメッセージが表示される。

もし、baz.age = 36のように正しい年齢を設定してから再度baz.saveを実行すると、今度はバリデーションが成功し、baz.saveはtrueを返す。この結果、データベースにはFooテーブルに一つのレコード、Barテーブルに一つのレコードが、それぞれBazを通じて保存されることになる。開発者はBazという一つのオブジェクトを操作するだけで、内部の複数のモデルの保存とバリデーションを一括して行えるため、非常に効率的である。

このgemは、GitHubで公開されているサンプルアプリケーションと共に提供されており、実際のWebアプリケーションでどのように活用できるかの具体的な例が示されている。このサンプルは、マイクロブログアプリケーションを題材にしており、app/models/ディレクトリを見れば、このgemがどのように使われているかを確認できる。

「active_record_compose」は、Ruby on Railsアプリケーションで複雑になりがちな複数のモデルにまたがるデータ操作を、シンプルかつ統一的に扱うための優れたソリューションだ。システムエンジニアを目指す上で、このような設計パターンやそれを手助けするライブラリの存在を知り、活用することで、より堅牢で保守しやすいシステムを効率的に開発する能力が身につくだろう。このgemは、アプリケーションのビジネスロジックを整理し、開発の生産性を高めるための強力なツールである。