gov.noaa.pmel.tmap.iosp

Class Task

java.lang.Object

gov.noaa.pmel.tmap.iosp.Task

public class Task
extends java.lang.Object

This is where the rubber meets the road and the external process defined by the Tool class actually gets run.

Author:

Roland Schweitzer\, Joe W. for the Anagram Framework.

Constructor Summary

Constructors

Constructor and Description
Task(java.lang.String[] cmd, java.lang.String[] env, java.io.File workDir, long timeLimit, java.lang.String[] errors) Sets up an external process.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	getCmd() Returns a printable string version of the external command.
java.lang.String	getErrorMessage() Returns the error message.
boolean	getHasError() Returns error state.
java.lang.String	getOutput() Returns a string version of the command's console output
java.lang.String	getStderr() Returns the STDERR stream as a string.
void	run() Executes the external process, returning when it is finished or when it exceeds the time limit specified in the constructor.
void	run(long timeLimit) Executes the external process, returning when it is finished or when it exceeds the time limit specified.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Task

public Task(java.lang.String[] cmd,
    java.lang.String[] env,
    java.io.File workDir,
    long timeLimit,
    java.lang.String[] errors)

Sets up an external process.

Method Detail

run

public void run()
         throws java.lang.Exception

Executes the external process, returning when it is finished or when it exceeds the time limit specified in the constructor.

Throws:

LASException - If the process fails, or if the output parser finds an error message in the output.

java.lang.Exception

run

public void run(long timeLimit)
         throws java.lang.Exception

Executes the external process, returning when it is finished or when it exceeds the time limit specified.

Parameters:

timeLimit - Overrides the time limit specified in the constructor.

Throws:

LASException - If the process fails, or if there is an error message (a line beginning with "error: ") in the output.

java.lang.Exception

getCmd

public java.lang.String getCmd()

Returns a printable string version of the external command.

getStderr

public java.lang.String getStderr()

Returns the STDERR stream as a string.

Returns:

STDERR

getOutput

public java.lang.String getOutput()

Returns a string version of the command's console output

getHasError

public boolean getHasError()

Returns error state.

getErrorMessage

public java.lang.String getErrorMessage()

Returns the error message.