模組 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 或 Module 的委派。

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

別名為：def_single_delegator

def_delegators(accessor, *methods)

別名為：def_single_delegators

def_single_delegator(accessor, method, new_name=method) 按一下以切換來源

定義一個方法 method，委派給 accessor（也就是呼叫 accessor 中同名的函式）。如果提供了 new_name，它會用作委派方法的名稱。傳回已定義方法的名稱。

# File lib/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 lib/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

委派方法 → accessor

委派 [method, method, ...] → accessor

別名為：single_delegate

single_delegate

也別名為：delegate