aboutsummaryrefslogtreecommitdiffstats
path: root/activesupport/lib/active_support/rescuable.rb
blob: d1a43666366063154e06c2a54d0f6e09790d7d97 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
module ActiveSupport
  module Rescuable
    def self.included(base) # :nodoc:
      base.class_inheritable_array :rescue_handlers
      base.rescue_handlers = []
      base.extend(ClassMethods)
    end

    module ClassMethods
      def enable_rescue_for(*methods)
        methods.each do |method|
          class_eval <<-EOS
            def #{method}_with_rescue(*args, &block)
              #{method}_without_rescue(*args, &block)
            rescue Exception => exception
              rescue_with_handler(exception)
            end

            alias_method_chain :#{method}, :rescue
          EOS
        end
      end

      def rescue_from(*klasses, &block)
        options = klasses.extract_options!
        unless options.has_key?(:with)
          if block_given?
            options[:with] = block
          else
            raise ArgumentError, "Need a handler. Supply an options hash that has a :with key as the last argument."
          end
        end

        klasses.each do |klass|
          key = if klass.is_a?(Class) && klass <= Exception
            klass.name
          elsif klass.is_a?(String)
            klass
          else
            raise ArgumentError, "#{klass} is neither an Exception nor a String"
          end

          # put the new handler at the end because the list is read in reverse
          rescue_handlers << [key, options[:with]]
        end
      end
    end

    def rescue_with_handler(exception)
      if handler = handler_for_rescue(exception)
        handler.arity != 0 ? handler.call(exception) : handler.call
      else
        raise exception
      end
    end

    def handler_for_rescue(exception)
      # use reverse so what is added last is found first
      _, handler = *rescue_handlers.reverse.detect do |klass_name, handler|
        # allow strings to support constants that are not defined yet
        klass = self.class.const_get(klass_name) rescue nil
        klass ||= klass_name.constantize rescue nil
        exception.is_a?(klass) if klass
      end

      case handler
      when Symbol
        method(handler)
      when Proc
        handler.bind(self)
      end
    end
  end
end