diff options
Diffstat (limited to 'actionpack/lib/action_controller')
| -rw-r--r-- | actionpack/lib/action_controller/deprecated_dependencies.rb (renamed from actionpack/lib/action_controller/dependencies.rb) | 31 |
1 files changed, 7 insertions, 24 deletions
diff --git a/actionpack/lib/action_controller/dependencies.rb b/actionpack/lib/action_controller/deprecated_dependencies.rb index d316552f49..433b9e5af8 100644 --- a/actionpack/lib/action_controller/dependencies.rb +++ b/actionpack/lib/action_controller/deprecated_dependencies.rb @@ -4,29 +4,7 @@ module ActionController #:nodoc: base.extend(ClassMethods) end - # 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. + # Deprecated module. The responsibility of loading dependencies belong with Active Support now. module ClassMethods #:nodoc: # 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. @@ -34,6 +12,7 @@ module ActionController #:nodoc: require_dependencies(:model, models) depend_on(:model, models) end + deprecate :model # Specifies a variable number of services that this controller depends on. Services are normally singletons or factories, like # Action Mailer service or a Payment Gateway service. @@ -41,6 +20,7 @@ module ActionController #:nodoc: require_dependencies(:service, services) depend_on(:service, services) end + deprecate :service # 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. @@ -49,16 +29,19 @@ module ActionController #:nodoc: depend_on(:observer, observers) instantiate_observers(observers) end + deprecate :observer # Returns an array of symbols that specify the dependencies on a given layer. For the example at the top, calling # <tt>ApplicationController.dependencies_on(:model)</tt> would return <tt>[:account, :company, :person, :project, :category]</tt> def dependencies_on(layer) read_inheritable_attribute("#{layer}_dependencies") end - + deprecate :dependencies_on + def depend_on(layer, dependencies) #:nodoc: write_inheritable_array("#{layer}_dependencies", dependencies) end + deprecate :depend_on private def instantiate_observers(observers) |