Модуль Forwardable

Модуль Forwardable предоставляет делегирование указанных методов к назначенному объекту, используя методы def_delegator и def_delegators.

Например, предположим, что у вас есть класс RecordCollection, который содержит массив @records. Вы можете предоставить метод поиска record_number(), который просто вызывает [] на @records массиве, так:

require 'forwardable'

class RecordCollection
  attr_accessor :records
  extend Forwardable
  def_delegator :@records, :[], :record_number
end

Мы можем использовать метод поиска следующим образом:

r = RecordCollection.new
r.records = [4,5,6]
r.record_number(0)  # => 4

Далее, если вы хотите предоставить методы size, <

class RecordCollection # re-open RecordCollection class
  def_delegators :@records, :size, :<<, :map
end

r = RecordCollection.new
r.records = [1,2,3]
r.record_number(0)   # => 1
r.size               # => 3
r << 4               # => [1, 2, 3, 4]
r.map { |x| x * 2 }  # => [2, 4, 6, 8]

Вы даже можете расширить обычные объекты с помощью Forwardable.

my_hash = Hash.new
my_hash.extend Forwardable              # prepare object for delegation
my_hash.def_delegator "STDOUT", "puts"  # add delegation for STDOUT.puts()
my_hash.puts "Howdy!"

Другой пример

Мы хотим полагаться на то, что было прежде, очевидно, но с делегированием мы можем взять только те методы, которые нам нужны, и даже переименовать их должным образом. Во многих случаях это предпочтительнее наследования, которое предоставляет нам весь старый интерфейс, даже если большая часть из него не нужна.

class Queue
  extend Forwardable

  def initialize
    @q = [ ]    # prepare delegate object
  end

  # setup preferred interface, enq() and deq()...
  def_delegator :@q, :push, :enq
  def_delegator :@q, :shift, :deq

  # support some general Array methods that fit Queues well
  def_delegators :@q, :clear, :first, :push, :shift, :size
end

q = Queue.new
q.enq 1, 2, 3, 4, 5
q.push 6

q.shift    # => 1
while q.size > 0
  puts q.deq
end

q.enq "Ruby", "Perl", "Python"
puts q.first
q.clear
puts q.first

Это должно вывести:

2
3
4
5
6
Ruby
nil

Примечания

Обратите внимание, что RDoc не будет обнаруживать делегированные методы.

forwardable.rb предоставляет делегирование по одному методу через методы #def_delegator и #def_delegators. Для делегирования всего класса с помощью DelegateClass см. delegate.rb.