Class: ChildProcess::JRuby::Process

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

Constant Summary

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

- (Process) initialize(args)



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

def initialize(args)
  super(args)

  @pumps = []
end

Instance Method Details

- (Boolean) exited?



16
17
18
19
20
21
22
23
24
25
26
27
28
# 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
  false
ensure
  log(:exit_code => @exit_code)
end

- (Object) io



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

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

- (Fixnum) pid

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

Raises:

  • (NotImplementedError)

    when trying to access pid on non-Unix platform



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

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

- (Object) stop(timeout = nil)



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

def stop(timeout = nil)
  assert_started

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

- (Object) wait



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

def wait
  if exited?
    exit_code
  else
    @process.waitFor

    stop_pumps
    @exit_code = @process.exitValue
  end
end