Methods
Public Instance methods
Rescue exceptions raised in controller actions.
rescue_from receives a series of exception classes or class names, and a trailing :with option with the name of a method or a Proc object to be called to handle them. Alternatively a block can be given.
Handlers that take one argument will be called with the exception, so that the exception can be inspected when dealing with it.
Handlers are inherited. They are searched from right to left, from bottom to top, and up the hierarchy. The handler of the first class for which exception.is_a?(klass) holds true is the one invoked, if any.
class ApplicationController < ActionController::Base
rescue_from User::NotAuthorized, :with => :deny_access # self defined exception
rescue_from ActiveRecord::RecordInvalid, :with => :show_errors
rescue_from 'MyAppError::Base' do |exception|
render :xml => exception, :status => 500
end
protected
def deny_access
...
end
def show_errors(exception)
exception.record.new_record? ? ...
end
end
[ show source ]
# File activesupport/lib/active_support/rescuable.rb, line 44
44: def rescue_from(*klasses, &block)
45: options = klasses.extract_options!
46:
47: unless options.has_key?(:with)
48: if block_given?
49: options[:with] = block
50: else
51: raise ArgumentError, "Need a handler. Supply an options hash that has a :with key as the last argument."
52: end
53: end
54:
55: klasses.each do |klass|
56: key = if klass.is_a?(Class) && klass <= Exception
57: klass.name
58: elsif klass.is_a?(String)
59: klass
60: else
61: raise ArgumentError, "#{klass} is neither an Exception nor a String"
62: end
63:
64: # put the new handler at the end because the list is read in reverse
65: rescue_handlers << [key, options[:with]]
66: end
67: end