123456789_123456789_123456789_123456789_123456789_

Module: AbstractController::Callbacks::ClassMethods

Relationships & Source Files
Defined in: actionpack/lib/abstract_controller/callbacks.rb

Instance Method Summary

Instance Method Details

#_insert_callbacks(callbacks, block = nil)

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.

[ GitHub ]

  
# 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

#_normalize_callback_options(options)

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.

[ GitHub ]

  
# 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

#after_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 129

rdoc_method :method: after_action

#append_after_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 150

rdoc_method :method: append_after_action

#append_around_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 178

rdoc_method :method: append_around_action

#append_before_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 122

rdoc_method :method: append_before_action

#around_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 157

rdoc_method :method: around_action

#before_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 101

rdoc_method :method: before_action

#prepend_after_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 136

rdoc_method :method: prepend_after_action

#prepend_around_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 164

rdoc_method :method: prepend_around_action

#prepend_before_action(names, block)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 108

rdoc_method :method: prepend_before_action

#skip_after_action(names)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 143

rdoc_method :method: skip_after_action

#skip_around_action(names)

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

[ GitHub ]

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

rdoc_method :method: skip_around_action

#skip_before_action(names)

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

[ GitHub ]

  
# File 'actionpack/lib/abstract_controller/callbacks.rb', line 115

rdoc_method :method: skip_before_action