Class JavaLauncher

java.lang.Object

com.ibm.wala.util.processes.Launcher

com.ibm.wala.util.processes.JavaLauncher

public class JavaLauncher
extends Launcher

A Java process launcher

Nested Class Summary

Nested classes/interfaces inherited from class Launcher

Launcher.Drainer

Modifier and Type	Class	Description
protected class	Launcher.Drainer	A thread that runs in a loop, performing the drain() action until a process terminates

Field Summary

Fields inherited from class Launcher

env, stdErr, stdOut, workingDir

Modifier and Type	Field	Description
protected @Nullable Map<String,String>	env
protected byte @Nullable []	stdErr
protected byte @Nullable []	stdOut
protected @Nullable File	workingDir

Method Summary

Modifier and Type	Method	Description
void	addVmArg(String arg)
static String	defaultJavaExe()
String	getJavaExe()
@Nullable Process	getLastProcess()
String	getMainClass()
String	getProgramArgs()
List<String>	getVmArgs()
List<String>	getXtraClassPath()
boolean	isEnableAssertions()
void	join()	Wait for the spawned process to terminate.
static JavaLauncher	make(String programArgs, String mainClass, boolean inheritClasspath, List<String> classpathEntries, boolean captureOutput, boolean captureErr, Logger logger)
static JavaLauncher	make(String programArgs, String mainClass, List<String> classpathEntries, Logger logger)
String	makeClasspath()	Compute the classpath for the spawned process
static String	quoteStringIfNeeded(String s)	Deprecated.
void	setEnableAssertions(boolean enableAssertions)
void	setJavaExe(String javaExe)
void	setProgramArgs(String s)
Process	start()	Launch the java process.
String	toString()

Methods inherited from class Launcher

captureStdErr, captureStdOut, drainStdErr, drainStdOut, getEnv, getInput, getStderr, getStdOut, getWorkingDir, isCaptureErr, isCaptureOutput, setEnv, setInput, setStdErr, setStdOut, setWorkingDir, spawnProcess, spawnProcess

Modifier and Type	Method	Description
protected Launcher.Drainer	captureStdErr(Process p)
protected Launcher.Drainer	captureStdOut(Process p)
protected Thread	drainStdErr(Process p)
protected Thread	drainStdOut(Process p)
@Nullable Map<String,String>	getEnv()
@Nullable byte[]	getInput()
@Nullable byte[]	getStderr()
@Nullable byte[]	getStdOut()
@Nullable File	getWorkingDir()
boolean	isCaptureErr()
boolean	isCaptureOutput()
void	setEnv(Map<String,String> newEnv)
void	setInput(byte[] input)	Set input which will be fed to the launched process's stdin
protected void	setStdErr(byte[] newErr)
protected void	setStdOut(byte[] newOutput)
void	setWorkingDir(File newWorkingDir)
protected Process	spawnProcess(@Nullable String cmd)	Spawn a process to execute the given command
protected Process	spawnProcess(String[] cmd)	Spawn a process to execute the given command

Methods inherited from class Object

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

Method Details

make

public static JavaLauncher make(String programArgs,
 String mainClass,
 List<String> classpathEntries,
 Logger logger)

Parameters:

programArgs - arguments to be passed to the Java program

mainClass - Declaring class of the main() method to run.

classpathEntries - Paths that will be added to the default classpath

make

public static JavaLauncher make(String programArgs,
 String mainClass,
 boolean inheritClasspath,
 List<String> classpathEntries,
 boolean captureOutput,
 boolean captureErr,
 Logger logger)

Parameters:

programArgs - arguments to be passed to the Java program

mainClass - Declaring class of the main() method to run.

inheritClasspath - Should the spawned process inherit all classpath entries of the currently running process?

classpathEntries - Paths that will be added to the default classpath

captureOutput - should the launcher capture the stdout from the subprocess?

captureErr - should the launcher capture the stderr from the subprocess?

getJavaExe

public String getJavaExe()

setJavaExe

public void setJavaExe(String javaExe)

setProgramArgs

public void setProgramArgs(String s)

getProgramArgs

public String getProgramArgs()

getMainClass

public String getMainClass()

getXtraClassPath

public List<String> getXtraClassPath()

toString

public String toString()

Overrides:

toString in class Launcher

defaultJavaExe

public static String defaultJavaExe()

Returns:

the string that identifies the java executable file

start

public Process start()
              throws IllegalArgumentException,
IOException

Launch the java process.

Throws:

IllegalArgumentException

IOException

getLastProcess

public @Nullable Process getLastProcess()

join

public void join()

Wait for the spawned process to terminate.

Throws:

IllegalStateException - if the process has not been started

makeClasspath

public String makeClasspath()

Compute the classpath for the spawned process

quoteStringIfNeeded

@Deprecated
public static String quoteStringIfNeeded(String s)

Deprecated.

If the input string contains a space, quote it (for use as a classpath). TODO: Figure out how to make a Mac happy with quotes. Trailing separators are unsafe, so we have to escape the last backslash (if present and unescaped), so it doesn't escape the closing quote.

isEnableAssertions

public boolean isEnableAssertions()

setEnableAssertions

public void setEnableAssertions(boolean enableAssertions)

addVmArg

public void addVmArg(String arg)

getVmArgs

public List<String> getVmArgs()