Process (Groovy JDK)

Methods Summary

Methods
Return type	Name and parameters
`void`	`closeStreams()` Closes all the streams associated with the process (ignoring any IOExceptions).
`Thread`	`consumeProcessErrorStream(OutputStream err)` Gets the error stream from a process and reads it to keep the process from blocking due to a full buffer.
`Thread`	`consumeProcessErrorStream(Appendable error)` Gets the error stream from a process and reads it to keep the process from blocking due to a full buffer.
`void`	`consumeProcessOutput()` Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer.
`void`	`consumeProcessOutput(Appendable output, Appendable error)` Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer.
`void`	`consumeProcessOutput(OutputStream output, OutputStream error)` Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer.
`Thread`	`consumeProcessOutputStream(Appendable output)` Gets the output stream from a process and reads it to keep the process from blocking due to a full output buffer.
`Thread`	`consumeProcessOutputStream(OutputStream output)` Gets the output stream from a process and reads it to keep the process from blocking due to a full output buffer.
`InputStream`	`getErr()` An alias method so that a process appears similar to System.out, System.in, System.err; you can use process.in, process.out, process.err in a similar fashion.
`InputStream`	`getIn()` An alias method so that a process appears similar to System.out, System.in, System.err; you can use process.in, process.out, process.err in a similar fashion.
`OutputStream`	`getOut()` An alias method so that a process appears similar to System.out, System.in, System.err; you can use process.in, process.out, process.err in a similar fashion.
`String`	`getText()` Read the text of the output stream of the Process.
`Writer`	`leftShift(Object value)` Overloads the left shift operator (<<) to provide an append mechanism to pipe data to a Process.
`OutputStream`	`leftShift(byte[] value)` Overloads the left shift operator to provide an append mechanism to pipe into a Process
`Process`	`or(Process right)` Overrides the or operator to allow one Process to asynchronously pipe data to another Process.
`Process`	`pipeTo(Process right)` Allows one Process to asynchronously pipe data to another Process.
`void`	`waitForOrKill(long numberOfMillis)` Wait for the process to finish during a certain amount of time, otherwise stops the process.
`void`	`waitForProcessOutput()` Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer.
`void`	`waitForProcessOutput(Appendable output, Appendable error)` Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer.
`void`	`waitForProcessOutput(OutputStream output, OutputStream error)` Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer.
`void`	`withOutputStream(Closure closure)` Creates a new buffered OutputStream as stdin for this process, passes it to the closure, and ensures the stream is flushed and closed after the closure returns.
`void`	`withWriter(Closure closure)` Creates a new BufferedWriter as stdin for this process, passes it to the closure, and ensures the stream is flushed and closed after the closure returns.

- Methods Detail
  - public void closeStreams()
    
    Closes all the streams associated with the process (ignoring any IOExceptions).
    
    Since:
    
    2.1
  - public Thread consumeProcessErrorStream(OutputStream err)
    
    Gets the error stream from a process and reads it to keep the process from blocking due to a full buffer. The processed stream data is appended to the supplied OutputStream. A new Thread is started, so this method will return immediately.
    
    Parameters:
    
    err - an OutputStream to capture the process stderr.
    
    Returns:
    
    the Thread
    
    Since:
    
    1.5.2
  - public Thread consumeProcessErrorStream(Appendable error)
    
    Gets the error stream from a process and reads it to keep the process from blocking due to a full buffer. The processed stream data is appended to the supplied Appendable. A new Thread is started, so this method will return immediately.
    
    Parameters:
    
    error - an Appendable to capture the process stderr.
    
    Returns:
    
    the Thread
    
    Since:
    
    1.7.5
  - public void consumeProcessOutput()
    
    Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer. The stream data is thrown away but blocking due to a full output buffer is avoided. Use this method if you don't care about the standard or error output and just want the process to run silently - use carefully however, because since the stream data is thrown away, it might be difficult to track down when something goes wrong. For this, two Threads are started, so this method will return immediately.
    
    Since:
    
    1.0
  - public void consumeProcessOutput(Appendable output, Appendable error)
    
    Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer. The processed stream data is appended to the supplied Appendable. For this, two Threads are started, so this method will return immediately.
    
    Parameters:
    
    output - an Appendable to capture the process stdout.
    
    error - an Appendable to capture the process stderr.
    
    Since:
    
    1.7.5
  - public void consumeProcessOutput(OutputStream output, OutputStream error)
    
    Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer. The processed stream data is appended to the supplied OutputStream. For this, two Threads are started, so this method will return immediately.
    
    Parameters:
    
    output - an OutputStream to capture the process stdout.
    
    error - an OutputStream to capture the process stderr.
    
    Since:
    
    1.5.2
  - public Thread consumeProcessOutputStream(Appendable output)
    
    Gets the output stream from a process and reads it to keep the process from blocking due to a full output buffer. The processed stream data is appended to the supplied Appendable. A new Thread is started, so this method will return immediately.
    
    Parameters:
    
    output - an Appendable to capture the process stdout.
    
    Returns:
    
    the Thread
    
    Since:
    
    1.7.5
  - public Thread consumeProcessOutputStream(OutputStream output)
    
    Gets the output stream from a process and reads it to keep the process from blocking due to a full output buffer. The processed stream data is appended to the supplied OutputStream. A new Thread is started, so this method will return immediately.
    
    Parameters:
    
    output - an OutputStream to capture the process stdout.
    
    Returns:
    
    the Thread
    
    Since:
    
    1.5.2
  - public InputStream getErr()
    
    An alias method so that a process appears similar to System.out, System.in, System.err; you can use process.in, process.out, process.err in a similar fashion.
    
    Returns:
    
    the error InputStream for the process
    
    Since:
    
    1.0
  - public InputStream getIn()
    
    An alias method so that a process appears similar to System.out, System.in, System.err; you can use process.in, process.out, process.err in a similar fashion.
    
    Returns:
    
    the InputStream for the process
    
    Since:
    
    1.0
  - public OutputStream getOut()
    
    An alias method so that a process appears similar to System.out, System.in, System.err; you can use process.in, process.out, process.err in a similar fashion.
    
    Returns:
    
    the OutputStream for the process
    
    Since:
    
    1.0
  - public String getText()
    
    Read the text of the output stream of the Process. Closes all the streams associated with the process after retrieving the text.
    
    Returns:
    
    the text of the output
    
    Since:
    
    1.0
  - public Writer leftShift(Object value)
    
    Overloads the left shift operator (<<) to provide an append mechanism to pipe data to a Process.
    
    Parameters:
    
    value - a value to append.
    
    Returns:
    
    a Writer
    
    Since:
    
    1.0
  - public OutputStream leftShift(byte[] value)
    
    Overloads the left shift operator to provide an append mechanism to pipe into a Process
    
    Parameters:
    
    value - data to append.
    
    Returns:
    
    an OutputStream
    
    Since:
    
    1.0
  - public Process or(Process right)
    
    Overrides the or operator to allow one Process to asynchronously pipe data to another Process.
    
    Parameters:
    
    right - a Process to pipe output to.
    
    Returns:
    
    the second Process to allow chaining
    
    Since:
    
    1.5.1
  - public Process pipeTo(Process right)
    
    Allows one Process to asynchronously pipe data to another Process.
    
    Parameters:
    
    right - a Process to pipe output to.
    
    Returns:
    
    the second Process to allow chaining
    
    Since:
    
    1.5.2
  - public void waitForOrKill(long numberOfMillis)
    
    Wait for the process to finish during a certain amount of time, otherwise stops the process.
    
    Parameters:
    
    numberOfMillis - the number of milliseconds to wait before stopping the process.
    
    Since:
    
    1.0
  - public void waitForProcessOutput()
    
    Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer. The stream data is thrown away but blocking due to a full output buffer is avoided. Use this method if you don't care about the standard or error output and just want the process to run silently - use carefully however, because since the stream data is thrown away, it might be difficult to track down when something goes wrong. For this, two Threads are started, but join()ed, so we wait. As implied by the waitFor... name, we also wait until we finish as well. Finally, the output and error streams are closed.
    
    Since:
    
    1.6.5
  - public void waitForProcessOutput(Appendable output, Appendable error)
    
    Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer. The processed stream data is appended to the supplied Appendable. For this, two Threads are started, but join()ed, so we wait. As implied by the waitFor... name, we also wait until we finish as well. Finally, the input, output and error streams are closed.
    
    Parameters:
    
    output - an Appendable to capture the process stdout.
    
    error - an Appendable to capture the process stderr.
    
    Since:
    
    1.7.5
  - public void waitForProcessOutput(OutputStream output, OutputStream error)
    
    Gets the output and error streams from a process and reads them to keep the process from blocking due to a full output buffer. The processed stream data is appended to the supplied OutputStream. For this, two Threads are started, but join()ed, so we wait. As implied by the waitFor... name, we also wait until we finish as well. Finally, the input, output and error streams are closed.
    
    Parameters:
    
    output - an OutputStream to capture the process stdout.
    
    error - an OutputStream to capture the process stderr.
    
    Since:
    
    1.6.5
  - public void withOutputStream(Closure closure)
    
    Creates a new buffered OutputStream as stdin for this process, passes it to the closure, and ensures the stream is flushed and closed after the closure returns. A new Thread is started, so this method will return immediately.
    
    Parameters:
    
    closure - a closure.
    
    Since:
    
    1.5.2
  - public void withWriter(Closure closure)
    
    Creates a new BufferedWriter as stdin for this process, passes it to the closure, and ensures the stream is flushed and closed after the closure returns. A new Thread is started, so this method will return immediately.
    
    Parameters:
    
    closure - a closure.
    
    Since:
    
    1.5.2

Class Process

Methods Summary

Methods Detail

public void closeStreams()

public Thread consumeProcessErrorStream(OutputStream err)

public Thread consumeProcessErrorStream(Appendable error)

public void consumeProcessOutput()

public void consumeProcessOutput(Appendable output, Appendable error)

public void consumeProcessOutput(OutputStream output, OutputStream error)

public Thread consumeProcessOutputStream(Appendable output)

public Thread consumeProcessOutputStream(OutputStream output)

public InputStream getErr()

public InputStream getIn()

public OutputStream getOut()

public String getText()

public Writer leftShift(Object value)

public OutputStream leftShift(byte[] value)

public Process or(Process right)

public Process pipeTo(Process right)

public void waitForOrKill(long numberOfMillis)

public void waitForProcessOutput()

public void waitForProcessOutput(Appendable output, Appendable error)

public void waitForProcessOutput(OutputStream output, OutputStream error)

public void withOutputStream(Closure closure)

public void withWriter(Closure closure)