Constructor Detail

• RunTools

  public RunTools()

Method Detail

• runCommand

  public static ReturnValue runCommand(String command)

  runCommand.

  Parameters:

  command - a String object.

  Returns:

  a ReturnValue object.

• runCommand

  public static ReturnValue runCommand(String[] command)

  runCommand.

  Parameters:

  command - an array of String objects.

  Returns:

  a ReturnValue object.

• runCommand

  public static ReturnValue runCommand(Map<String,String> env,
                       String[] command)

• runCommand

  public static ReturnValue runCommand(Map<String,String> env,
                       String[] command,
                       int stdoutCapacity,
                       int stderrCapacity)

• runCommand

  public static ReturnValue runCommand(Map<String,String> env,
                       String[] command,
                       int stdoutCapacity,
                       int stderrCapacity,
                       String permanentStoragePrefix)

  A simple command runner that captures the return value of the program. If the command was OK it should (in most cases) return 0. This util assumes this is the case. FIXME: Jordan, the Process object does not start the command within a shell environment, so if you're depending on environmental variables you'll run into problems, see http://java.sun.com/javase/6/docs/api/java/lang/Process.html

  Parameters:

  command - an array of String objects.

  env - a Map object.

  stdoutCapacity -

  stderrCapacity -

  permanentStoragePrefix - store a permanent copy of output at permanentStoragePrefix.stderr and .stdout

  Returns:

  a ReturnValue object.

• waitAndGetReturn

  public static ReturnValue waitAndGetReturn(Process p,
                             int stdoutLineCapacity,
                             int stderrLineCapacity,
                             String permanentStoragePrefix)

  Wait on a process to finish, then parse information into return value

  Parameters:

  p - a Process object.

  stdoutLineCapacity - limit the number of lines stored or set to 0 to store everything

  stderrLineCapacity - limit the number of lines stored or set to 0 to store everything

  permanentStoragePrefix -

  Returns:

  a ReturnValue object.

• startCommand

  public static Process startCommand(Map<String,String> env,
                     String[] command)
                              throws IOException

  An alternate runner that launches a process and returns it so that the caller can process it's output directly. A use case is when we need to output stdout or stderr to a file in real-time, or if it will be too large to buffer in RAM and return.

  Parameters:

  env - a Map object.

  command - an array of String objects.

  Returns:

  a Process object.

  Throws:

  IOException - if any.

• main

  public static void main(String[] args)

  main.

  Parameters:

  args - an array of String objects.