Methods
#
A
B
P
S
Instance Public methods
_insert_callbacks(callbacks, block)

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
    # File actionpack/lib/abstract_controller/callbacks.rb, line 69
69:       def _insert_callbacks(callbacks, block)
70:         options = callbacks.last.is_a?(Hash) ? callbacks.pop : {}
71:         _normalize_callback_options(options)
72:         callbacks.push(block) if block
73:         callbacks.each do |callback|
74:           yield callback, options
75:         end
76:       end
_normalize_callback_options(options)

If :only or :except are used, convert the options into the primitive form (:per_key) used by ActiveSupport::Callbacks. The basic idea is that :only => :index gets converted to :if => proc {|c| c.action_name == “index” }, but that the proc is only evaluated once per action for the lifetime of a Rails process.

Options

  • only - The callback should be run only for this action
  • except - The callback should be run for all actions except this action
    # File actionpack/lib/abstract_controller/callbacks.rb, line 33
33:       def _normalize_callback_options(options)
34:         if only = options[:only]
35:           only = Array(only).map {|o| "action_name == '#{o}'"}.join(" || ")
36:           options[:per_key] = {:if => only}
37:         end
38:         if except = options[:except]
39:           except = Array(except).map {|e| "action_name == '#{e}'"}.join(" || ")
40:           options[:per_key] = {:unless => except}
41:         end
42:       end
after_filter(names, block)

Append an after filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 113
113:       
append_after_filter(names, block)

Append an after filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 134
134:       
append_around_filter(names, block)

Append an around filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 162
162:       
append_before_filter(names, block)

Append a before filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 106
106:       
around_filter(names, block)

Append an around filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 141
141:       
before_filter(names, block)

Append a before filter. See _insert_callbacks for parameter details.

    # File actionpack/lib/abstract_controller/callbacks.rb, line 85
85:       
prepend_after_filter(names, block)

Prepend an after filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 120
120:       
prepend_around_filter(names, block)

Prepend an around filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 148
148:       
prepend_before_filter(names, block)

Prepend a before filter. See _insert_callbacks for parameter details.

    # File actionpack/lib/abstract_controller/callbacks.rb, line 92
92:       
skip_after_filter(names, block)

Skip an after filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 127
127:       
skip_around_filter(names, block)

Skip an around filter. See _insert_callbacks for parameter details.

     # File actionpack/lib/abstract_controller/callbacks.rb, line 155
155:       
skip_before_filter(names, block)

Skip a before filter. See _insert_callbacks for parameter details.

    # File actionpack/lib/abstract_controller/callbacks.rb, line 99
99:       
skip_filter(*names, &blk)

Skip before, after, and around filters matching any of the names

Parameters

  • names - A list of valid names that could be used for callbacks. Note that skipping uses Ruby equality, so it’s impossible to skip a callback defined using an anonymous proc using skip_filter
    # File actionpack/lib/abstract_controller/callbacks.rb, line 51
51:       def skip_filter(*names, &blk)
52:         skip_before_filter(*names)
53:         skip_after_filter(*names)
54:         skip_around_filter(*names)
55:       end