edu.rice.cs.util
Class ProcessCreator

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

Direct Known Subclasses:

GeneralProcessCreator

public class ProcessCreator
extends java.lang.Object

This class abstracts out process creation, similar to ProcessCreator, which is only available in Java 1.5. This ProcessCreator cannot deal with process sequences and chains. It can only create one processes.

Field Summary

protected java.lang.String	_cachedCmdLine Cached copy of the reconstructed command line.
protected java.lang.String[]	_cmdarray
protected java.lang.String	_cmdline
protected java.util.Map<java.lang.String,java.lang.String>	_env
protected java.lang.String	_evaluatedCmdLine
protected java.lang.String	_evaluatedWorkDir
protected PropertyMaps	_props
protected java.lang.String	_workdir

Constructor Summary

protected	ProcessCreator() Degenerate constructor, only for subclasses that completely override this class.
	ProcessCreator(java.lang.String[] cmdarray, java.lang.String workdir) Constructor for a process creator with the given command line already split up, and map of properties.
	ProcessCreator(java.lang.String cmdline, java.lang.String workdir, PropertyMaps pm) Constructor for a process creator with the given command line and map of properties.

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.
java.lang.String	evaluatedCommandLine() Return the command line after evaluation, or null if it hasn't been replaced yet.
java.lang.String	evaluatedWorkDir() Return the work directory after evaluation, or null if it hasn't been replaced yet.
PropertyMaps	getPropertyMaps() Return the PropertyMaps object used for substitution.
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 java.lang.Object

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

Field Detail

_cmdline

protected java.lang.String _cmdline

_evaluatedCmdLine

protected java.lang.String _evaluatedCmdLine

_workdir

protected java.lang.String _workdir

_evaluatedWorkDir

protected java.lang.String _evaluatedWorkDir

_cmdarray

protected java.lang.String[] _cmdarray

_env

protected java.util.Map<java.lang.String,java.lang.String> _env

_props

protected PropertyMaps _props

_cachedCmdLine

protected java.lang.String _cachedCmdLine

Cached copy of the reconstructed command line.

Constructor Detail

ProcessCreator

protected ProcessCreator()

Degenerate constructor, only for subclasses that completely override this class.

ProcessCreator

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

Constructor for a process creator with the given command line and map of properties.

Parameters:

cmdline - command line

workdir - working directory

pm - PropertyMaps used for substitution when replacing variables

ProcessCreator

public ProcessCreator(java.lang.String[] cmdarray,
                      java.lang.String workdir)

Constructor for a process creator with the given command line already split up, and map of properties.

Parameters:

cmdarray - array of command line arguments

workdir - working directory

Method Detail

cmdline

public java.lang.String cmdline()

Get the command line.

Returns:

command line

environment

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

Returns a map of this process creator's environment.

Returns:

environment map

workDir

public java.lang.String workDir()

Returns this process creator's working directory.

Returns:

working directory

evaluatedCommandLine

public java.lang.String evaluatedCommandLine()

Return the command line after evaluation, or null if it hasn't been replaced yet.

evaluatedWorkDir

public java.lang.String evaluatedWorkDir()

Return the work directory after evaluation, or null if it hasn't been replaced yet.

getPropertyMaps

public PropertyMaps getPropertyMaps()

Return the PropertyMaps object used for substitution.

start

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

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

Throws:

java.io.IOException