Module | ActionController::Dependencies::ClassMethods |
In: |
lib/action_controller/dependencies.rb
|
Dependencies control what classes are needed for the controller to run its course. This is an alternative to doing explicit require statements that bring a number of benefits. It’s more succinct, communicates what type of dependency we’re talking about, can trigger special behavior (as in the case of observer), and enables Rails to be clever about reloading in cached environments like FCGI. Example:
class ApplicationController < ActionController::Base model :account, :company, :person, :project, :category helper :access_control service :notifications, :billings observer :project_change_observer end
Please note that a controller like ApplicationController will automatically attempt to require_dependency on a model of its singuralized name and a helper of its name. If nothing is found, no error is raised. This is especially useful for concrete controllers like PostController:
class PostController < ApplicationController # model :post (already required) # helper :post (already required) end
Also note, that if the models follow the pattern of just 1 class per file in the form of MyClass => my_class.rb, then these classes don’t have to be required as Active Support will auto-require them.
Returns an array of symbols that specify the dependencies on a given layer. For the example at the top, calling ApplicationController.dependencies_on(:model) would return [:account, :company, :person, :project, :category]
Specifies a variable number of models that this controller depends on. Models are normally Active Record classes or a similar backend for modelling entity classes.
Specifies a variable number of observers that are to govern when this controller is handling actions. The observers will automatically have .instance called on them to make them active on assignment.