RailsのServiceオブジェクトと名前空間（module）の関係を学んだ

Posted at 2026-04-17

はじめに

Railsで学習開発を進める中で、Serviceオブジェクトを使ってビジネスロジックを切り出す構成にしました。

実装を進める中で、ディレクトリ構成と名前空間（module）の関係や、呼び出し方で少し詰まった部分があったため、実際に触って理解できた内容を学習記録としてまとめます。

今回触ってみて、自分の中では以下のように整理できました。

Serviceを増やしていくと、以下の問題が出てきました。

そのため、以下のようにディレクトリを分割しました。

app/services/rf/
  ├── calculators/
  ├── builders/
  └── shared/

この時点では、**「フォルダで分ければ Rf::Calculators::RankCalculator で呼べる」**と思っていました。

ここが今回一番理解できたポイントです。

# app/services/rf/calculators/rank_calculator.rb

class RankCalculator
  # ...
end

これだと定義されるのは単なる ::RankCalculator になってしまいます。

ファイルパスが app/services/rf/calculators/rank_calculator.rb の場合、Railsは以下の定数を期待します。

Rf::Calculators::RankCalculator

module Rf
  module Calculators
    class RankCalculator
      def self.call
        # 処理
      end
    end
  end
end

実装中、以下のようなエラーに遭遇しました。

Zeitwerk::NameError:
expected file .../app/services/rf/shared/base_date.rb to define constant Rf::Shared::BaseDate, but didn't

原因：

Serviceを呼び出すときに、毎回フルパスで書くのが少し冗長に感じました。
Rf::Calculators::RankCalculator.call

最初は以下のように考えました。
@calculator = Rf::Calculators::RankCalculator

しかし、これは単なるクラスの参照を保持しているだけで、名前空間の解決そのものには関係ありません。
根本的な解決にはなりませんでした。

1. エイリアスを使う

RankCalculator = Rf::Calculators::RankCalculator
RankCalculator.call

2. includeを使う

include Rf::Calculators
RankCalculator.call

ここも今回整理できたポイントです。
これまでは「コントローラーからViewにデータを渡すもの」という、いわばRailsのレールに乗ったお作法としてなんとなくインスタンス変数（@）を使っていました。

しかし、APIモードでの開発やServiceオブジェクトの利用を考えると、以下のように使い分けるのが適切だと整理できました。

変数種別	使い時	特徴
ローカル変数	`result = RankCalculator.call`	一時的な値。スコープ（メソッド内）が限定される。
インスタンス変数	`@result = RankCalculator.call`	限定的。状態を保持したいとき。クラス内（Viewなど）で共有したいとき。

今回の結論：
Serviceの戻り値は基本ローカル変数で扱い、Viewへ渡すなど状態を持つ必要があるときのみインスタンス変数を使用する。

今回の学習で、以下のように整理できました。

今回の内容はRailsの基礎的な部分ではありますが、実際にServiceを分割して実装する中で理解が深まった部分でした。
特に**「名前空間の考え方」「moduleの役割」「変数の使い分け」**あたりは、今後の設計にも関わる重要なポイントだと感じています。