Parent

Logging::Proxy

Defines a Proxy that will log all method calls on the proxied object. This class uses method_missing on a “blank slate” object to intercept all method calls. The method name being called and the arguments are all logged to the proxied object’s logger instance. The log level and other settings for the proxied object are honored by the Proxy instance.

If you want, you can also supply your own method_missing code as a block to the constructor.

  Proxy.new(object) do |name, *args, &block|
    # code to be executed before the proxied method
    result = @object.send(name, *args, &block)
    # code to be executed after the proxied method
    result   # <-- always return the result
  end

The proxied object is available as the “@object” variable. The logger is available as the “@logger” variable.

Public Class Methods

new( object, &block ) click to toggle source

Create a new proxy for the given object. If an optional block is given it will be called before the proxied method. This block will replace the method_missing implementation

    # File lib/logging/proxy.rb, line 35
35:     def initialize( object, &block )
36:       Kernel.raise ArgumentError, "Cannot proxy nil" if nil.equal? object
37: 
38:       @object = object
39:       @leader = @object.is_a?(Class) ? "#{@object.name}." : "#{@object.class.name}#"
40:       @logger = Logging.logger[object]
41: 
42:       if block
43:         eigenclass = class << self; self; end
44:         eigenclass.__send__(:define_method, :method_missing, &block)
45:       end
46:     end

Public Instance Methods

method_missing( name, *args, &block ) click to toggle source

All hail the magic of method missing. Here is where we are going to log the method call and then forward to the proxied object. The return value from the proxied objet method call is passed back.

    # File lib/logging/proxy.rb, line 52
52:     def method_missing( name, *args, &block )
53:       @logger << "#@leader#{name}(#{args.inspect[1..-2]})\n"
54:       @object.send(name, *args, &block)
55:     end

Disabled; run with --debug to generate this.

[Validate]

Generated with the Darkfish Rdoc Generator 1.1.6.