模块 SingleForwardable

SingleForwardable 也可用于在对象级别设置委托。

printer = String.new
printer.extend SingleForwardable        # prepare object for delegation
printer.def_delegator "STDOUT", "puts"  # add delegation for STDOUT.puts()
printer.puts "Howdy!"

此外，SingleForwardable 可用于为类或模块设置委托。

class Implementation
  def self.service
    puts "serviced!"
  end
end

module Facade
  extend SingleForwardable
  def_delegator :Implementation, :service
end

Facade.service #=> serviced!

如果您想同时使用 Forwardable 和 SingleForwardable，您可以使用方法 def_instance_delegator 和 def_single_delegator 等。

公共实例方法

def_delegator(accessor, method, ali = method)

别名为： def_single_delegator

def_delegators(accessor, *methods)

别名为： def_single_delegators

def_single_delegator(accessor, method, new_name=method) 点击切换源码

定义一个方法 *method*，它委托给 *accessor*（即，它调用 *accessor* 中同名的方法）。如果提供了 *new_name*，则将其用作委托方法的名称。返回定义的方法的名称。

# File forwardable.rb, line 310
def def_single_delegator(accessor, method, ali = method)
  gen = Forwardable._delegator_method(self, accessor, method, ali)

  ret = instance_eval(&gen)
  singleton_class.__send__(:ruby2_keywords, ali) if RUBY_VERSION >= '2.7'
  ret
end

也别名为：def_delegator

def_single_delegators(accessor, *methods) 点击切换源码

用于定义多个委托方法的快捷方式，但不提供使用不同名称的选项。以下两个代码示例具有相同的效果

def_delegators :@records, :size, :<<, :map

def_delegator :@records, :size
def_delegator :@records, :<<
def_delegator :@records, :map

# File forwardable.rb, line 296
def def_single_delegators(accessor, *methods)
  methods.each do |method|
    next if /\A__(?:send|id)__\z/ =~ method
    def_single_delegator(accessor, method)
  end
end

也别名为：def_delegators

delegate 方法 → accessor

delegate [方法, 方法, ...] → accessor

别名为：single_delegate

single_delegate [方法, 方法, ...] => accessor 点击切换源码

将散列作为其参数。键是符号或符号数组。这些符号对应于方法名称。值是方法将被委托到的访问器。

# File forwardable.rb, line 275
def single_delegate(hash)
  hash.each do |methods, accessor|
    unless defined?(methods.each)
      def_single_delegator(accessor, methods)
    else
      methods.each {|method| def_single_delegator(accessor, method)}
    end
  end
end

也别名为：delegate