Skip to Content Skip to Search

A NotifyTemplateEntry is returned by TupleSpace#notify and is notified of TupleSpace changes. You may receive either your subscribed event or the ‘close’ event when iterating over notifications.

See TupleSpace#notify_event for valid notification types.

Example

ts = Rinda::TupleSpace.new
observer = ts.notify 'write', [nil]

Thread.start do
  observer.each { |t| p t }
end

3.times { |i| ts.write [i] }

Outputs:

['write', [0]]
['write', [1]]
['write', [2]]
Methods
E
N
P

Class Public methods

new(place, event, tuple, expires=nil)

Creates a new NotifyTemplateEntry that watches place for +event+s that match tuple.

Source: show | on GitHub 

# File ruby/lib/rinda/tuplespace.rb, line 245
def initialize(place, event, tuple, expires=nil)
  ary = [event, Rinda::Template.new(tuple)]
  super(ary, expires)
  @queue = Thread::Queue.new
  @done = false
end

Instance Public methods

each()

Yields event/tuple pairs until this NotifyTemplateEntry expires.

Source: show | on GitHub 

# File ruby/lib/rinda/tuplespace.rb, line 273
def each # :yields: event, tuple
  while !@done
    it = pop
    yield(it)
  end
rescue
ensure
  cancel
end

notify(ev)

Called by TupleSpace to notify this NotifyTemplateEntry of a new event.

Source: show | on GitHub 

# File ruby/lib/rinda/tuplespace.rb, line 255
def notify(ev)
  @queue.push(ev)
end

pop()

Retrieves a notification. Raises RequestExpiredError when this NotifyTemplateEntry expires.

Source: show | on GitHub 

# File ruby/lib/rinda/tuplespace.rb, line 263
def pop
  raise RequestExpiredError if @done
  it = @queue.pop
  @done = true if it[0] == 'close'
  return it
end