module AbstractController::Callbacks::ClassMethods

Public Instance Methods

_insert_callbacks(callbacks, block = nil) { |callback, options| ... } Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 91
def _insert_callbacks(callbacks, block = nil)
  options = callbacks.extract_options!
  _normalize_callback_options(options)
  callbacks.push(block) if block
  callbacks.each do |callback|
    yield callback, options
  end
end

Take callback names and an optional callback proc, normalize them, then call the block with each callback. This allows us to abstract the normalization across several methods that use it.

Parameters

  • callbacks - An array of callbacks, with an optional options hash as the last parameter.

  • block - A proc that should be added to the callbacks.

Block Parameters

  • name - The callback to be added.

  • options - A hash of options to be used when adding the callback.

_normalize_callback_options(options) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 66
def _normalize_callback_options(options)
  _normalize_callback_option(options, :only, :if)
  _normalize_callback_option(options, :except, :unless)
end

If :only or :except are used, convert the options into the :if and :unless options of ActiveSupport::Callbacks.

The basic idea is that :only => :index gets converted to :if => proc {|c| c.action_name == "index" }.

Note that :only has priority over :if in case they are used together.

only: :index, if: -> { true } # the :if option will be ignored.

Note that :if has priority over :except in case they are used together.

except: :index, if: -> { true } # the :except option will be ignored.

Options

  • only - The callback should be run only for this action.

  • except - The callback should be run for all actions except this action.

after_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 135
      

Append a callback after actions. See #_insert_callbacks for parameter details.

append_after_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 156
      

Append a callback after actions. See #_insert_callbacks for parameter details.

append_around_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 184
      

Append a callback around actions. See #_insert_callbacks for parameter details.

append_before_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 128
      

Append a callback before actions. See #_insert_callbacks for parameter details.

around_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 163
      

Append a callback around actions. See #_insert_callbacks for parameter details.

before_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 107
      

Append a callback before actions. See #_insert_callbacks for parameter details.

prepend_after_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 142
      

Prepend a callback after actions. See #_insert_callbacks for parameter details.

prepend_around_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 170
      

Prepend a callback around actions. See #_insert_callbacks for parameter details.

prepend_before_action(names, block) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 114
      

Prepend a callback before actions. See #_insert_callbacks for parameter details.

skip_after_action(names) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 149
      

Skip a callback after actions. See #_insert_callbacks for parameter details.

skip_around_action(names) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 177
      

Skip a callback around actions. See #_insert_callbacks for parameter details.

skip_before_action(names) Show source
# File actionpack/lib/abstract_controller/callbacks.rb, line 121
      

Skip a callback before actions. See #_insert_callbacks for parameter details.

© 2004–2018 David Heinemeier Hansson
Licensed under the MIT License.