模块 Test::Unit::Util::Observable

这是一个实用工具类，允许任何混入它的对象向一组监听器通知感兴趣的事件。

常量

NOTHING: 我们使用它作为默认值，因为 nil 可能有特殊含义

公共实例方法

add_listener(channel_name, listener_key=NOTHING) { |value| ... } 点击切换源代码

将传递的 proc 添加为 channel_name 指定通道上的监听器。listener_key 用于稍后删除监听器；如果未指定，则使用 proc 本身。

无论使用什么作为 listener_key 都会被返回，使得很容易使用 proc 本身作为 listener_key

listener = add_listener("Channel") { ... }
remove_listener("Channel", listener)

# File test-unit-3.6.7/lib/test/unit/util/observable.rb, line 31
def add_listener(channel_name, listener_key=NOTHING, &listener) # :yields: value
  unless(block_given?)
    raise ArgumentError.new("No callback was passed as a listener")
  end
      
  key = listener_key
  if (listener_key == NOTHING)
    listener_key = listener
    key = ProcWrapper.new(listener)
  end
      
  channels[channel_name] ||= {}
  channels[channel_name][key] = listener
  return listener_key
end

notify_listeners(channel_name, *arguments) 点击切换源代码

调用在 channel_name 指定的通道上注册的所有 proc。如果指定了 value，则将其传递给 proc，否则调用时不带参数。

# File test-unit-3.6.7/lib/test/unit/util/observable.rb, line 71
def notify_listeners(channel_name, *arguments)
  channel = channels[channel_name]
  return 0 unless (channel)
  channel.each_value { |listener| listener.call(*arguments) }
  return channel.size
end

remove_listener(channel_name, listener_key) 点击切换源代码

从 channel_name 指定的通道中删除由 listener_key 指定的监听器。返回注册的 proc，如果没有找到则返回 nil。

# File test-unit-3.6.7/lib/test/unit/util/observable.rb, line 51
def remove_listener(channel_name, listener_key)
  channel = channels[channel_name]
  return nil unless (channel)
  key = listener_key
  if (listener_key.instance_of?(Proc))
    key = ProcWrapper.new(listener_key)
  end
  return channel.delete(key)
end

私有实例方法

channels() 点击切换源代码

# File test-unit-3.6.7/lib/test/unit/util/observable.rb, line 79
def channels
  @channels ||= {}
  return @channels
end