edu.rice.cs.util
Class GeneralProcessCreator

java.lang.Object
  edu.rice.cs.util.ProcessCreator
      edu.rice.cs.util.GeneralProcessCreator

public class GeneralProcessCreator
extends ProcessCreator

This class abstracts out process creation, similar to ProcessCreator, which is only available in Java 1.5. Additionally, it transparently creates process sequences and process chains, including piping.

Field Summary

protected java.util.List<java.util.List<java.util.List<java.lang.String>>>	_seqs
static Log	LOG

Fields inherited from class edu.rice.cs.util.ProcessCreator

_cachedCmdLine, _cmdarray, _cmdline, _env, _evaluatedCmdLine, _evaluatedWorkDir, _props, _workdir

Constructor Summary

GeneralProcessCreator(java.util.List<java.util.List<java.util.List<java.lang.String>>> seqs, java.lang.String workdir, PropertyMaps pm)
Constructor for a process creator with the given command line already split up, and the work directory.

GeneralProcessCreator(java.lang.String cmdline, java.lang.String workdir, PropertyMaps pm)
Constructor for a process creator with the given command line and the work directory.

Method Summary

java.lang.String	cmdline() Get the command line.
java.util.Map<java.lang.String,java.lang.String>	environment() Returns a map of this process creator's environment.
protected static java.lang.String	getProcessChainCmdLine(java.util.List<java.util.List<java.lang.String>> pipe) Reconstructs the command line for a process chain.
protected static java.lang.String	getProcessCmdLine(java.util.List<java.lang.String> cmds) Reconstructs the command line for a simple process.
protected static java.lang.String	getProcessSequenceCmdLine(java.util.List<java.util.List<java.util.List<java.lang.String>>> seqs) Reconstructs the command line for a process sequence.
java.lang.Process	start() Starts a new process using the attributes of this process creator.
java.lang.String	workDir() Returns this process creator's working directory.

Methods inherited from class edu.rice.cs.util.ProcessCreator

evaluatedCommandLine, evaluatedWorkDir, getPropertyMaps

Methods inherited from class java.lang.Object

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

Field Detail

_seqs

protected java.util.List<java.util.List<java.util.List<java.lang.String>>> _seqs

LOG

public static final Log LOG

Constructor Detail

GeneralProcessCreator

public GeneralProcessCreator(java.lang.String cmdline,
                             java.lang.String workdir,
                             PropertyMaps pm)

Constructor for a process creator with the given command line and the work directory.

Parameters:

cmdline - command line

workdir - working directory

pm - PropertyMaps object used for substitution

GeneralProcessCreator

public GeneralProcessCreator(java.util.List<java.util.List<java.util.List<java.lang.String>>> seqs,
                             java.lang.String workdir,
                             PropertyMaps pm)

Constructor for a process creator with the given command line already split up, and the work directory.

Parameters:

seqs - a sequence of commands to pipe

workdir - working directory

pm - PropertyMaps object used for substitution

Method Detail

getProcessCmdLine

protected static java.lang.String getProcessCmdLine(java.util.List<java.lang.String> cmds)

Reconstructs the command line for a simple process.

getProcessChainCmdLine

protected static java.lang.String getProcessChainCmdLine(java.util.List<java.util.List<java.lang.String>> pipe)

Reconstructs the command line for a process chain.

getProcessSequenceCmdLine

protected static java.lang.String getProcessSequenceCmdLine(java.util.List<java.util.List<java.util.List<java.lang.String>>> seqs)

Reconstructs the command line for a process sequence.

cmdline

public java.lang.String cmdline()

Get the command line.

Overrides:

cmdline in class ProcessCreator

Returns:

command line

environment

public java.util.Map<java.lang.String,java.lang.String> environment()

Returns a map of this process creator's environment.

Overrides:

environment in class ProcessCreator

Returns:

environment map

workDir

public java.lang.String workDir()

Returns this process creator's working directory.

Overrides:

workDir in class ProcessCreator

Returns:

working directory

start

public java.lang.Process start()
                        throws java.io.IOException

Starts a new process using the attributes of this process creator.

Overrides:

start in class ProcessCreator

Throws:

java.io.IOException