Package uk.ac.starlink.topcat
Class Executor
java.lang.Object
uk.ac.starlink.topcat.Executor
Defines an object which can execute a system Process.
This is basically a convenience wrapper for
Process
which takes care of the stream output and so on. It's not completely
general purpose, it's designed for running little shell commands -
if you try to run something which spews out a huge amount of output
you could have trouble.- Since:
- 9 Jun 2005
- Author:
- Mark Taylor (Starlink)
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic Executor
createExecutor
(String[] argv) Returns an executor which executes a command made of words.int
executeSynchronously
(boolean isCapture) CallsgetProcess()
and attempts to execute it synchronously.getErr()
Returns the standard error which resulted from running the process, if execution was done in capturing mode.abstract String
getLine()
Returns a representation of the command line executed.getOut()
Returns the standard output which resulted from running the process, if execution was done in capturing mode.abstract Process
Returns a system process to be executed.toString()
-
Constructor Details
-
Executor
public Executor()
-
-
Method Details
-
getProcess
Returns a system process to be executed.- Returns:
- new process
- Throws:
IOException
-
getLine
Returns a representation of the command line executed.- Returns:
- command line
-
getOut
Returns the standard output which resulted from running the process, if execution was done in capturing mode.- Returns:
- stdout content
-
getErr
Returns the standard error which resulted from running the process, if execution was done in capturing mode.- Returns:
- stderr content
-
executeSynchronously
CallsgetProcess()
and attempts to execute it synchronously. Can be run only once on this object.If
isCapture
is set true, thegetOut()
andgetErr()
methods can be used after this call to get the results from stdout and stderr. Otherwise, the process output streams go to the JVM's stdout/stderr.- Parameters:
isCapture
- true to capture output and return it as the outcome message, false to let it go to stdout- Returns:
- exit status (0 is OK)
- Throws:
IOException
InterruptedException
-
toString
-
createExecutor
Returns an executor which executes a command made of words.- Parameters:
argv
- argument vector- Returns:
- executor
-