Class: ChildProcess::JRuby::Process

Inherits:
AbstractProcess show all
Defined in:
lib/childprocess/jruby/process.rb

Constant Summary

Constants inherited from AbstractProcess

AbstractProcess::POLL_INTERVAL

Instance Attribute Summary

Attributes inherited from AbstractProcess

#cwd, #detach, #duplex, #environment, #exit_code, #leader

Instance Method Summary collapse

Methods inherited from AbstractProcess

#alive?, #crashed?, #poll_for_exit, #start

Constructor Details

#initialize(args) ⇒ Process

Returns a new instance of Process.



6
7
8
9
10
# File 'lib/childprocess/jruby/process.rb', line 6

def initialize(args)
  super(args)

  @pumps = []
end

Instance Method Details

#exited?Boolean

Returns:

  • (Boolean)


16
17
18
19
20
21
22
23
24
25
26
27
28
29
# File 'lib/childprocess/jruby/process.rb', line 16

def exited?
  return true if @exit_code

  assert_started
  @exit_code = @process.exitValue
  stop_pumps

  true
rescue java.lang.IllegalThreadStateException => ex
  log(ex.class => ex.message)
  false
ensure
  log(:exit_code => @exit_code)
end

#ioObject



12
13
14
# File 'lib/childprocess/jruby/process.rb', line 12

def io
  @io ||= JRuby::IO.new
end

#pidInteger

Only supported in JRuby on a Unix operating system, thanks to limitations in Java’s classes

Returns:

  • (Integer)

    the pid of the process after it has started

Raises:

  • (NotImplementedError)

    when trying to access pid on non-Unix platform



56
57
58
59
60
61
62
63
64
65
66
67
# File 'lib/childprocess/jruby/process.rb', line 56

def pid
  if @process.getClass.getName != "java.lang.UNIXProcess"
    raise NotImplementedError, "pid is only supported by JRuby child processes on Unix"
  end

  # About the best way we can do this is with a nasty reflection-based impl
  # Thanks to Martijn Courteaux
  # http://stackoverflow.com/questions/2950338/how-can-i-kill-a-linux-process-in-java-with-sigkill-process-destroy-does-sigter/2951193#2951193
  field = @process.getClass.getDeclaredField("pid")
  field.accessible = true
  field.get(@process)
end

#stop(timeout = nil) ⇒ Object



31
32
33
34
35
36
# File 'lib/childprocess/jruby/process.rb', line 31

def stop(timeout = nil)
  assert_started

  @process.destroy
  wait # no way to actually use the timeout here..
end

#waitObject



38
39
40
41
42
43
44
45
46
47
# File 'lib/childprocess/jruby/process.rb', line 38

def wait
  if exited?
    exit_code
  else
    @process.waitFor

    stop_pumps
    @exit_code = @process.exitValue
  end
end