Methods

Class Index [+]

Quicksearch

ActiveSupport::Rescuable::ClassMethods

Public Instance Methods

rescue_from(*klasses, &block) click to toggle source

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
    # File lib/active_support/rescuable.rb, line 50
50:       def rescue_from(*klasses, &block)
51:         options = klasses.extract_options!
52: 
53:         unless options.has_key?(:with)
54:           if block_given?
55:             options[:with] = block
56:           else
57:             raise ArgumentError, "Need a handler. Supply an options hash that has a :with key as the last argument."
58:           end
59:         end
60: 
61:         klasses.each do |klass|
62:           key = if klass.is_a?(Class) && klass <= Exception
63:             klass.name
64:           elsif klass.is_a?(String)
65:             klass
66:           else
67:             raise ArgumentError, "#{klass} is neither an Exception nor a String"
68:           end
69: 
70:           # put the new handler at the end because the list is read in reverse
71:           self.rescue_handlers += [[key, options[:with]]]
72:         end
73:       end

Disabled; run with --debug to generate this.

[Validate]

Generated with the Darkfish Rdoc Generator 1.1.6.