Class: Async::IO::Notification

Inherits:
Object
  • Object
show all
Defined in:
lib/async/io/notification.rb

Overview

A cross-reactor/process notification pipe.

Instance Method Summary collapse

Constructor Details

#initialize ⇒ Notification

Returns a new instance of Notification.



27
28
29
30
31
32
33
 
# File 'lib/async/io/notification.rb', line 27

def initialize
	pipe = ::IO.pipe
	
	# We could call wait and signal from different reactors/threads/processes, so we don't create wrappers here, because they are not thread safe by design.
	@input = pipe.first
	@output = pipe.last
end

Instance Method Details

#close ⇒ Object 



35
36
37
38
 
# File 'lib/async/io/notification.rb', line 35

def close
	@input.close
	@output.close
end

#signal ⇒ void

This method returns an undefined value.

Signal to a given task that it should resume operations.



52
53
54
55
56
57
 
# File 'lib/async/io/notification.rb', line 52

def signal
	wrapper = Async::IO::Generic.new(@output)
	wrapper.write(".")
ensure
	wrapper.reactor = nil
end

#wait ⇒ Object

Wait for signal to be called.

Returns:

  • (Object) 


42
43
44
45
46
47
48
 
# File 'lib/async/io/notification.rb', line 42

def wait
	wrapper = Async::IO::Generic.new(@input)
	wrapper.read(1)
ensure
	# Remove the wrapper from the reactor.
	wrapper.reactor = nil
end