【Ruby3.x】Module::const_missing()メソッドの使い方

const_missingメソッドは、Rubyにおいて、存在しない定数にアクセスしようとした際に自動的に実行されるメソッドです。あるクラスやモジュール内で、未定義の定数名が参照されたとき、Rubyの定数探索機構がその定数を見つけられなかった場合に、最終的にこのconst_missingメソッドが呼び出されます。

このメソッドが呼び出される際には、アクセスを試みられた定数名がシンボルとして引数に渡されます。例えば、MyModule::UNDEFINED_CONSTという定数にアクセスがあった場合、const_missingメソッドには:UNDEFINED_CONSTというシンボルが渡されます。Moduleクラスにデフォルトで実装されているconst_missingメソッドは、通常、この状況でNameError例外を発生させ、定数が見つからないことを示します。

しかし、開発者がこのconst_missingメソッドをオーバーライドすることで、未定義の定数へのアクセスを捕捉し、独自のロジックを実行できます。この機能は、特に「オートロード」と呼ばれる仕組みで活用されます。オートロードでは、必要な時までクラスやモジュールの読み込みを遅延させ、初めてその定数が参照されたときにconst_missingが呼び出され、そこで実際のコードを読み込んで定数を定義するといった処理が可能です。これにより、アプリケーションの起動時のパフォーマンス向上やメモリ使用量の最適化が図れます。システム内で動的にリソースを解決したり、特定の命名規則を持つコンポーネントを自動的にロードしたりする際に、非常に有用な機能となります。

Copy
1class MyModule
2  def self.const_missing(const_name)
3    # ここに、未定義の定数 const_name が参照された場合の処理を記述します。
4    # 例: 特定の定数にデフォルト値を割り当てる、動的に定数を生成する、ログを出力するなど。
5    # 処理後、適切な値を返すか、NameErrorを発生させる必要があります。
6    if const_name == :UNDEFINED_CONSTANT_NAME
7      "これはconst_missingによって提供された値です。"
8    else
9      # その他の未定義定数については、通常通りNameErrorを発生させます。
10      super
11    end
12  end
13end

req

• name: 定数名 required: true type: Symbol description: 定数が見つからなかった場合に渡される、その定数の名前（Symbol型）。

Object

const_missingメソッドは、定義されていない定数にアクセスしようとした際に呼び出されます。このメソッドの戻り値は、その定数として扱われるオブジェクトです。