Module: Exception2MessageMapper

Defined in:
lib/rubysl/e2mmap/e2mmap.rb

Overview

e2mmap.rb - for ruby 1.1

$Release Version: 2.0$
$Revision: 1.10 $
by Keiju ISHITSUKA

–

Usage:

U1)

class Foo
  extend Exception2MessageMapper
  def_e2message ExistingExceptionClass, "message..."
  def_exception :NewExceptionClass, "message..."[, superclass]
  ...
end

U2)

module Error
  extend Exception2MessageMapper
  def_e2meggage ExistingExceptionClass, "message..."
  def_exception :NewExceptionClass, "message..."[, superclass]
  ...
end
class Foo
  include Error
  ...
end

foo = Foo.new
foo.Fail ....

U3)

module Error
  extend Exception2MessageMapper
  def_e2message ExistingExceptionClass, "message..."
  def_exception :NewExceptionClass, "message..."[, superclass]
  ...
end
class Foo
  extend Exception2MessageMapper
  include Error
  ...
end

Foo.Fail NewExceptionClass, arg...
Foo.Fail ExistingExceptionClass, arg...

Constant Summary collapse

E2MM = 
Exception2MessageMapper

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.def_e2message(k, c, m) ⇒ Object

E2MM.def_e2message(k, e, m)

    k:  class to define exception under.
    e:  exception
    m:  message_form
define exception c with message m.



114
115
116
117
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 114

def E2MM.def_e2message(k, c, m)
  E2MM.instance_eval{@MessageMap[[k, c]] = m}
  c
end

.def_exception(k, n, m, s = StandardError) ⇒ Object

E2MM.def_exception(k, n, m, s)

    k:  class to define exception under.
    n:  exception_name
    m:  message_form
    s:  superclass(default: StandardError)
define exception named ``c'' with message m.



126
127
128
129
130
131
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 126

def E2MM.def_exception(k, n, m, s = StandardError)
  n = n.id2name if n.kind_of?(Fixnum)
  e = Class.new(s)
  E2MM.instance_eval{@MessageMap[[k, e]] = m}
  k.const_set(n, e)
end

.e2mm_message(klass, exp) ⇒ Object Also known as: message 



153
154
155
156
157
158
159
160
161
162
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 153

def E2MM.e2mm_message(klass, exp)
  for c in klass.ancestors
    if mes = @MessageMap[[c,exp]]
      #p mes
      m = klass.instance_eval('"' + mes + '"')
      return m
    end
  end
  nil
end

.extend_object(cl) ⇒ Object 



55
56
57
58
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 55

def E2MM.extend_object(cl)
  super
  cl.bind(self) unless cl < E2MM
end

.Raise(klass = E2MM, err = nil, *rest) ⇒ Object Also known as: Fail

Fail(klass, err, *rest)

klass:  class to define exception under.
err:    exception
rest:   message arguments



138
139
140
141
142
143
144
145
146
147
148
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 138

def E2MM.Raise(klass = E2MM, err = nil, *rest)
  if form = e2mm_message(klass, err)
    b = $@.nil? ? caller(1) : $@
    #p $@
    #p __FILE__
    b.shift if b[0] =~ /^#{Regexp.quote(__FILE__)}:/
    raise err, sprintf(form, *rest), b
  else
    E2MM.Fail E2MM, ErrNotRegisteredException, err.inspect
  end
end

Instance Method Details

#bind(cl) ⇒ Object 



60
61
62
63
64
65
66
67
68
69
70
71
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 60

def bind(cl)
  self.module_eval %[
    def Raise(err = nil, *rest)
      Exception2MessageMapper.Raise(self.class, err, *rest)
    end
    alias Fail Raise

    def self.included(mod)
      mod.extend Exception2MessageMapper
    end
  ]
end

#def_e2message(c, m) ⇒ Object

def_e2message(c, m)

    c:  exception
    m:  message_form
define exception c with message m.



88
89
90
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 88

def def_e2message(c, m)
  E2MM.def_e2message(self, c, m)
end

#def_exception(n, m, s = StandardError) ⇒ Object

def_exception(n, m, s)

    n:  exception_name
    m:  message_form
    s:  superclass(default: StandardError)
define exception named ``c'' with message m.



98
99
100
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 98

def def_exception(n, m, s = StandardError)
  E2MM.def_exception(self, n, m, s)
end

#Fail ⇒ Object

Fail(err, *rest)

err:    exception
rest:   message arguments



80
81
82
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 80

def Raise(err = nil, *rest)
  E2MM.Raise(self, err, *rest)
end

#fail ⇒ Object

Fail(err, *rest)

err:    exception
rest:   message arguments



81
82
83
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 81

def Raise(err = nil, *rest)
  E2MM.Raise(self, err, *rest)
end

#Raise(err = nil, *rest) ⇒ Object

Fail(err, *rest)

err:    exception
rest:   message arguments



77
78
79
 
# File 'lib/rubysl/e2mmap/e2mmap.rb', line 77

def Raise(err = nil, *rest)
  E2MM.Raise(self, err, *rest)
end