auxtestlib

Class CommandRunner

java.lang.Object

auxtestlib.CommandRunner

public class CommandRunner
extends Object

Class that runs a command and captures its output.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CommandRunner.CommandOutput Class that represents the output of a command.
static class	CommandRunner.ProcessInterface Interface provided to access the process while it is running.

Constructor Summary

Constructors

Constructor and Description
CommandRunner() Creates a new instance.

Method Summary

Modifier and Type	Method and Description
CommandRunner.ProcessInterface	run_command_async(String[] cmds, File directory, int limit) Runs a command and captures the output.
CommandRunner.CommandOutput	run_command(String[] cmds, File directory, int limit) This method is a shortcut for the run_command_async(String[], File, int).
CommandRunner.CommandOutput	runCommand(String[] cmds, File directory, int limit) Deprecated. use run_command(String[], File, int)
CommandRunner.ProcessInterface	runCommandAsync(String[] cmds, File directory, int limit) Deprecated. use run_command_async(String[], File, int)

Methods inherited from class java.lang.Object

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

Constructor Detail

CommandRunner

public CommandRunner()

Creates a new instance.

Method Detail

run_command_async

public CommandRunner.ProcessInterface run_command_async(String[] cmds,
                                                        File directory,
                                                        int limit)
                                                 throws IOException

Runs a command and captures the output. This method will return immediately (the process keeps running in the background). The process can me monitored and accessed through the CommandRunner.ProcessInterface class.

Parameters:

cmds - the command and its arguments

directory - the directory where the command should bd executed

limit - execution time limit (in seconds)

Returns:

an interface to control the process

Throws:

IOException - failed to launch the process

runCommandAsync

@Deprecated
public CommandRunner.ProcessInterface runCommandAsync(String[] cmds,
                                                                   File directory,
                                                                   int limit)
                                                            throws IOException

Deprecated. use run_command_async(String[], File, int)

Parameters:

cmds - deprecated

directory - deprecated

limit - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

run_command

public CommandRunner.CommandOutput run_command(String[] cmds,
                                               File directory,
                                               int limit)
                                        throws IOException

This method is a shortcut for the run_command_async(String[], File, int). It will invoke the command, wait for it to run and returns the command's output.

Parameters:

cmds - the command and its arguments

directory - the directory where the command should bd executed

limit - execution time limit (in seconds)

Returns:

the commands output in the stdout

Throws:

IOException - failed to launch the process

runCommand

@Deprecated
public CommandRunner.CommandOutput runCommand(String[] cmds,
                                                           File directory,
                                                           int limit)
                                                    throws IOException

Deprecated. use run_command(String[], File, int)

Parameters:

cmds - deprecated

directory - deprecated

limit - deprecated

Returns:

deprecated

Throws:

IOException - deprecated