Class: SimpleDelegator

Inherits:
Delegator show all
Defined in:
lib/delegate.rb

Overview

A concrete implementation of Delegator, this class provides the means to delegate all supported method calls to the object passed into the constructor and even to change the object being delegated to at a later time with __setobj__ .

Instance Method Summary (collapse)

Methods inherited from Delegator

#==, #clone, delegating_block, #dup, #initialize, #marshal_dump, #marshal_load, #method_missing, #respond_to?

Constructor Details

This class inherits a constructor from Delegator

Dynamic Method Handling

This class handles dynamic methods through the method_missing method in the class Delegator

Instance Method Details

- (Object) __getobj__

Returns the current object method calls are being delegated to.



209
210
211
 
# File 'lib/delegate.rb', line 209

def __getobj__
  @delegate_sd_obj
end

- (Object) __setobj__(obj)

Changes the delegate object to obj.

It's important to note that this does not cause SimpleDelegator's methods to change. Because of this, you probably only want to change delegation to objects of the same type as the original delegate.

Here's an example of changing the delegation object.

names = SimpleDelegator.new(%w{James Edward Gray II})
puts names[1]    # => Edward
names.__setobj__(%w{Gavin Sinclair})
puts names[1]    # => Sinclair

Raises:

  • (ArgumentError) 


227
228
229
230
 
# File 'lib/delegate.rb', line 227

def __setobj__(obj)
  raise ArgumentError, "cannot delegate to self" if self.equal?(obj)
  @delegate_sd_obj = obj
end