类 Delegator
此库提供了三种不同的方法将方法调用委托给对象。最容易使用的是 SimpleDelegator
。将一个对象传递给构造函数,该对象支持的所有方法都将被委托。此对象稍后可以更改。
更进一步,顶级 DelegateClass 方法允许您通过类继承轻松设置委托。这更灵活,因此可能是该库最常见的用法。
最后,如果您需要完全控制委托方案,则可以从抽象类 Delegator
继承并根据需要进行自定义。(如果您发现自己需要这种控制,请查看标准库中的 Forwardable
。它可能更适合您的需求。)
SimpleDelegator 的实现是使用 Delegator 的一个很好的例子
require 'delegate' class SimpleDelegator < Delegator def __getobj__ @delegate_sd_obj # return object we are delegating to, required end def __setobj__(obj) @delegate_sd_obj = obj # change delegation object, # a feature we're providing end end
注意¶ ↑
请注意,RDoc
不会检测到委托方法。
常量
- KERNEL_RESPOND_TO
- VERSION
公共类方法
源代码
# File lib/delegate.rb, line 75 def initialize(obj) __setobj__(obj) end
传入 obj 以将方法调用委托给它。obj 支持的所有方法都将被委托。
公共实例方法
源代码
# File lib/delegate.rb, line 164 def !=(obj) return false if obj.equal?(self) __getobj__ != obj end
如果两个对象不被认为是相等的值,则返回 true。
源代码
# File lib/delegate.rb, line 156 def ==(obj) return true if obj.equal?(self) self.__getobj__ == obj end
如果两个对象被认为是相等的值,则返回 true。
源代码
# File lib/delegate.rb, line 188 def __getobj__ __raise__ ::NotImplementedError, "need to define '__getobj__'" end
此方法必须由子类覆盖,并且应返回正在委托方法调用的对象。
源代码
# File lib/delegate.rb, line 196 def __setobj__(obj) __raise__ ::NotImplementedError, "need to define '__setobj__'" end
此方法必须由子类覆盖,并将委托对象更改为 obj。
源代码
# File lib/delegate.rb, line 172 def eql?(obj) return true if obj.equal?(self) obj.eql?(__getobj__) end
如果两个对象被认为是相等的值,则返回 true。
源代码
# File lib/delegate.rb, line 237 def freeze __getobj__.freeze super() end
:方法:freeze 冻结 _getobj_ 返回的对象和自身。
调用超类方法
源代码
# File lib/delegate.rb, line 203 def marshal_dump ivars = instance_variables.reject {|var| /\A@delegate_/ =~ var} [ :__v2__, ivars, ivars.map {|var| instance_variable_get(var)}, __getobj__ ] end
支持序列化 _getobj_ 返回的对象。
源代码
# File lib/delegate.rb, line 215 def marshal_load(data) version, vars, values, obj = data if version == :__v2__ vars.each_with_index {|var, i| instance_variable_set(var, values[i])} __setobj__(obj) else __setobj__(data) end end
从序列化对象重新初始化委托。
源代码
# File lib/delegate.rb, line 82 def method_missing(m, *args, &block) r = true target = self.__getobj__ {r = false} if r && target_respond_to?(target, m, false) target.__send__(m, *args, &block) elsif ::Kernel.method_defined?(m) || ::Kernel.private_method_defined?(m) ::Kernel.instance_method(m).bind_call(self, *args, &block) else super(m, *args, &block) end end
调用超类方法
BasicObject#method_missing
源代码
# File lib/delegate.rb, line 131 def methods(all=true) __getobj__.methods(all) | super end
返回此委托对象可用的方法,作为此对象和 _getobj_ 方法的并集。
调用超类方法
源代码
# File lib/delegate.rb, line 147 def protected_methods(all=true) __getobj__.protected_methods(all) | super end
返回此委托对象可用的方法,作为此对象和 _getobj_ 受保护方法的并集。
调用超类方法
源代码
# File lib/delegate.rb, line 139 def public_methods(all=true) __getobj__.public_methods(all) | super end
返回此委托对象可用的方法,作为此对象和 _getobj_ 公共方法的并集。
调用超类方法
源代码
也别名为:__raise__
源代码
# File lib/delegate.rb, line 99 def respond_to_missing?(m, include_private) r = true target = self.__getobj__ {r = false} r &&= target_respond_to?(target, m, include_private) if r && include_private && !target_respond_to?(target, m, false) warn "delegator does not forward private method \##{m}", uplevel: 3 return false end r end
通过 _getobj_ 转发调用来检查此委托对象提供的方法。
私有实例方法
源代码
# File lib/delegate.rb, line 114 def target_respond_to?(target, m, include_private) case target when Object target.respond_to?(m, include_private) else if KERNEL_RESPOND_TO.bind_call(target, :respond_to?) target.respond_to?(m, include_private) else KERNEL_RESPOND_TO.bind_call(target, m, include_private) end end end
处理 BasicObject
实例