123456789_123456789_123456789_123456789_123456789_

Class: AbstractController::Base

Relationships & Source Files
Extension / Inclusion / Inheritance Descendants
Subclasses:
ActionController::Base, ActionController::Metal, ActionController::Middleware, ActionMailer::Base, Rails::ApplicationController, Rails::InfoController, Rails::MailersController, Rails::WelcomeController, ActionView::TestCase::TestController
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, ::ActiveSupport::DescendantsTracker
Instance Chain:
self, ::ActiveSupport::Configurable
Inherits: Object
Defined in: actionpack/lib/abstract_controller/base.rb

Overview

Base is a low-level API. Nobody should be using it directly, and subclasses (like ::ActionController::Base) are expected to provide their own render method, since rendering means different things depending on the context.

Class Attribute Summary

Class Method Summary

::ActiveSupport::DescendantsTracker - Extended

descendants, direct_descendants, inherited

Instance Attribute Summary

Instance Method Summary

::ActiveSupport::Configurable - Included

#config

Reads and writes attributes from a configuration OrderedHash.

Class Attribute Details

.abstract? (readonly)

Alias for .abstract.

[ GitHub ] 

  


# File 'actionpack/lib/abstract_controller/base.rb', line 30



alias_method :abstract?, :abstract


  








  

    .supports_path?  ⇒ Boolean  (readonly)
  



  

    

Returns true if the given controller is capable of rendering a path. A subclass of Base may return false. An Email controller for example does not support paths, only full URLs.


  





  


  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 171



def self.supports_path?
  true
end


  







Class Method Details



  

    .abstract   (readonly)
    Also known as: .abstract?
  

  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 29



attr_reader :abstract


  








  

    .abstract!  
  



  

    

Define a controller as abstract. See internal_methods for more details.


  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 34



def abstract!
  @abstract = true
end


  








  

    .action_methods  
  



  

    

A list of method names that should be considered actions. This includes all public instance methods on a controller, less any internal methods (see #internal_methods), adding back in any methods that are internal, but still exist on the class itself. Finally, #hidden_actions are removed.



Returns


  • 

    Set - A set of all methods that should be considered actions.
    



  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 78



def action_methods
  @action_methods ||= begin
    # All public instance methods of this class, including ancestors
    methods = (public_instance_methods(true) -
      # Except for public instance methods of Base and its ancestors
      internal_methods +
      # Be sure to include shadowed public instance methods of this class
      public_instance_methods(false)).uniq.map { |x| x.to_s } -
      # And always exclude explicitly hidden actions
      hidden_actions.to_a

    # Clear out AS callback method pollution
    Set.new(methods.reject { |method| method =~ /_one_time_conditions/ })
  end
end


  








  

    .clear_action_methods!  
  



  

    

action_methods are cached and there is sometimes need to refresh them. clear_action_methods! allows you to do that, so next time you run action_methods, they will be recalculated


  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 97



def clear_action_methods!
  @action_methods = nil
end


  








  

    .controller_path  
  



  

    

Returns the full controller name, underscored, without the ending Controller. For instance, MyApp::MyPostsController would return “my_app/my_posts” for controller_path.



Returns



  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 107



def controller_path
  @controller_path ||= name.sub(/Controller$/, '').underscore unless anonymous?
end


  








  

    .hidden_actions  
  



  

    

The list of hidden actions. Defaults to an empty array. This can be modified by other modules or subclasses to specify particular actions as hidden.



Returns


  • 

    ::Array - An array of method names that should not be considered actions.
    



  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 66



def hidden_actions
  []
end


  








  

    .internal_methods  
  



  

    

A list of all internal methods for a controller. This finds the first abstract superclass of a controller, and gets a list of all public instance methods on that abstract class. Public instance methods of a controller would normally be considered action methods, so methods declared on abstract classes are being removed. (ActionController::Metal and ::ActionController::Base are defined as abstract)


  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 53



def internal_methods
  controller = self

  controller = controller.superclass until controller.abstract?
  controller.public_instance_methods(true)
end


  








  

    .method_added(name)  
  



  

    

Refresh the cached action_methods when a new action_method is added.


  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 112



def method_added(name)
  super
  clear_action_methods!
end


  







Instance Attribute Details



  

    #action_name   (rw)
  

  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 21



attr_internal :action_name


  








  

    #formats   (rw)
  

  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 22



attr_internal :formats


  








  

    #response_body   (rw)
  

  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 20



attr_internal :response_body


  







Instance Method Details



  

    #action_methods  
  



  

    

Delegates to the class' #action_methods


  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 146



def action_methods
  self.class.action_methods
end


  








  

    #available_action?(action_name)  ⇒ Boolean 
  



  

    

Returns true if a method for the action is available and can be dispatched, false otherwise.



Notice that action_methods.include?("foo") may return false and available_action?("foo") returns true because this method considers actions that are also available through other means, for example, implicit render ones.



Parameters




Returns



  





  


  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 163



def available_action?(action_name)
  _find_action_name(action_name).present?
end


  








  

    #controller_path  
  



  

    

Delegates to the class' #controller_path


  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 141



def controller_path
  self.class.controller_path
end


  








  

    #process(action, *args)  
  



  

    

Calls the action going through the entire action dispatch stack.



The actual method that is called is determined by calling #method_for_action. If no method can handle the action, then an ActionNotFound error is raised.



Returns


  • 

    self
    



  



  [ GitHub ]


  

  


# File 'actionpack/lib/abstract_controller/base.rb', line 128



def process(action, *args)
  @_action_name = action.to_s

  unless action_name = _find_action_name(@_action_name)
    raise ActionNotFound, "The action '#{action}' could not be found for #{self.class.name}"
  end

  @_response_body = nil

  process_action(action_name, *args)
end