RubyとRailsでの話がごっちゃになっているように思います。まずはそれらを整理してから話していきます。
プログラミング言語における「名前空間」
「名前空間」というのはプログラミング言語一般で使用される機能で、主な目的はお調べしたとおり「名前の衝突を防ぐ」と言うものです。Cのような古い言語では名前空間という機能を言語として実装していなかったため、二つの既存のプログラムをくっつけて一つのプログラムに使用としたとき、関数名等が被ってしまい既存のプログラムのコードの修正が必要になったと言うことがありました。その反省を踏まえ、その後に開発された言語、例えばC++ではnamespace
というキーワードを使って「名前空間」を作成することで、関数名等の衝突などを防ぐようにしました。他の言語でも同じように「名前空間」の機能を搭載していきますが、どのようにして提供するかは言語によって異なります。例えば、JavaのパッケージやJavaScriptのモジュールと言った機能も「名前空間」の機能を提供する実装の一つです。
Rubyのおける「名前空間」とモジュールの関係
Ruby自体には「名前空間」という名前の機能がありません。しかし、「名前空間」を実現出来ないというわけではありません。モジュールが「名前空間」の機能を提供するとなっています。
まず、勘違いしてはいけないのは、モジュールは「名前空間」のためだけの機能ではないことです。他のクラスやモジュールにMix-inしたり、オブジェクトそのものの拡張(extend
)したり、再定義(refine
)の機能を使うためにusing
したりします。それら多くの機能の一つとして、「名前空間」の機能があると言うことです。なお、クラスもモジュールを拡張しているため、同じように「名前空間」に使用することができます。
名前空間を作るかどうか、どのように使うかは、そのプログラムは何か、また、設計指針はどうなっているかによります。例えば、gemで提供されるライブラリは、一番トップでライブラリ名の名前空間で分けて、他のライブラリと被らないようにするのが通例です。これはライブラリが他のプログラムと一緒になる可能性があるため、適切な名前空間を設けていないと名前衝突が発生してしまうからです。逆に言うと、ライブラリでも無く、他のプログラムと一緒になるようなことも無いような、それこそ書き捨てなプログラムなら、わざわざ名前空間を作る必要は無いと言えます。
RailsにおけるRubyの「名前空間」
前節まではRuby一般の話でRailsの話ではありませんでした。これがRailsになると自由に何でもしていいのかというわけではなくなります。なぜなら、Railsには流儀というか設計指針というか、名前空間の分け方の指針みたいな物があるからです。
User
モデルの一覧を読み込む"/users"というアクセスを考えています。"/users"へのアクセスは"/app/controllers/users_controller.rb"にあるUsersContoroller
コントローラーのindex
メソッドを呼び出します。このUsersContoroller
はどこかのモジュールの中ではなく、トップレベルに定義されている必要があります。一覧はいいが、作成や編集は管理者だけなので、わかりやすいように"/admin/users/new"で新規作成画面を出すとします。"/admin/users/new"へのアクセスは、"/app/controllers/admin/users_controller.rb"にあるAdmin::UsersContoroller
コントローラーのnew
メソッドが呼び出します。こちらのAdmin::UsersContoroller
はAdmin
モジュールに名前空間にあります。クラス名は一緒でも先程のUsersContoroller
とは別物です。このように同じクラス名でも全く別のクラスとして定義できるようになります。
もちろん、各パスを全く別のコントローラに紐付けるもできます。ただ、その場合は"config/routes.rb"で追加のオプションを設定する必要があります。必要に迫られない限り、やるできではないでしょう。
このように、Railsではモデルやコントローラー等をどこに置くのか、その時はモジュールの中か、それともトップレベルにするのかが決まっています。通常のモデルやコントローラーのクラスはトップレベルですが、ralis generate
の時に"親の名前/モデル名"と言うような形で作成すると、モジュールで名前空間を形成して、同じ名前でも別々のモデルやコントローラを作ることができます。
Railsの「コントローラーの名前空間」
上記の話とは別にRailsには「コントローラーの名前空間」というものがあります。実は先程でてきた"/admin/users/new"は"contfig/routes.rb"でどうなるかと言うと、rails generate controller admin/users new
と実行して作ってみるとわかりますが、
Rails.application.routes.draw do
# ...
namespace :admin do
get 'users/new'
end
# ..
end
といった形になります(ほかにcreate
等もあれば、resources
に書き替えても言いでしょう)。このnamespace
メソッドが実現するのが「コントローラーの名前空間」です。似たような機能として、scope
を使う方法もありますが、こちらはパスだけが変わるだけで、名前空間は作られず、モジュールもトップのままです。
最後の質問への回答について
最後の機能のservice一覧についてです。
Service
モデル(サービス)とMechanism
モデル(機能)があるという話でいいでしょうか?そして、機能によって提供するサービスが異なる、つまり、機能はサービスをhas_many
している、逆に、サービスを提供する機能は一つだけ、つまり、サービスは機能にbelongs_to
していると言う関係でしょうか?
上記の前提で、機能毎にサービス一覧を出すコントローラーの話という場合は次のようにネストしたリソースを使うのがいいかと思います。
Rails.application.routes.draw do
# ...
resources :mechanisms do
resources :services
end
# ..
end
"/mechanisms/:mechanism_id/services"と言うパスでServicesController
コントローラーを呼び出します。これは名前空間ではないので、Mechanisms::ServicesController
にはならないことに注意してください。
コントローラーの話ではなく、単にライブラリ的なクラスやモジュールを作るという話であれば、名前空間をどうするかは自由です。作っても良いですし、作らなくても良いです。ただ、将来その部分をgemとして独立したライブラリにするなどの予定であれば、その時のライブラリ名になるであろう名前のモジュールをトップにおいて名前空間を分けた方がいいでしょう。ほかにも、関連する物毎にまとまっていれば、どこにあるかがわかりやすくなるという場合もあります。
なお、"app"にはモデル、コントローラー、ヘルパー等の決まった物以外は置かない方がいいです。"app"内のパス構成は、Railsで決められた通りであることが前提となっているため、将来のバージョンアップで予期せぬ衝突が発生する可能性があります。それらではない自作のクラスやモジュールは"lib"内に置く方が良いでしょう。
namespace
を使用したコントローラの名前空間のことですか?それとも(Railsであるかどうかは関係無く)Rubyの言語機能としてModuleを使って他言語で名前空間と言われている機能を構成することですか?