org.openimaj.util.processes

Class JavaProcess

java.lang.Object

org.openimaj.util.processes.JavaProcess

public class JavaProcess
extends Object

Helper methods for launching a new JVM and running code within it. Advanced configuration can be achieved by constructing a JavaProcess.ProcessOptions and calling runProcess(ProcessOptions). For most other use-cases the static methods provide a convenient shortcut.

Author:

Jonathon Hare (jsh2@ecs.soton.ac.uk)

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JavaProcess.ProcessOptions Options describing a JVM environment.

Constructor Summary

Constructors

Constructor and Description
JavaProcess()

Method Summary

Modifier and Type	Method and Description
static void	runProcess(Class<?> clz, String argString) Run the main main method of the given class in a new JVM.
static void	runProcess(Class<?> clz, String[] args) Run the main main method of the given class in a new JVM.
static void	runProcess(Class<?> clz, String[] jvmArgs, String[] args) Run the main main method of the given class in a new JVM.
static void	runProcess(Class<?> clz, String jvmArgs, String argString) Run the main main method of the given class in a new JVM.
static void	runProcess(JavaProcess.ProcessOptions op) Run the process described by the given JavaProcess.ProcessOptions in a separate JVM and wait for it to exit.

Methods inherited from class java.lang.Object

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

Constructor Detail

JavaProcess

public JavaProcess()

Method Detail

runProcess

public static void runProcess(Class<?> clz,
                              String[] args)
                       throws ProcessException

Run the main main method of the given class in a new JVM. The new JVM has the same classpath as the invoking JVM. No JVM arguments are set.

Parameters:

clz - the class to run

args - the arguments to pass to the main method

Throws:

ProcessException - if an error occurs during execution or the return code is non-zero.

runProcess

public static void runProcess(Class<?> clz,
                              String argString)
                       throws ProcessException

Run the main main method of the given class in a new JVM. The new JVM has the same classpath as the invoking JVM. No JVM arguments are set.

Parameters:

clz - the class to run

argString - the arguments to pass to the main method

Throws:

ProcessException - if an error occurs during execution or the return code is non-zero.

runProcess

public static void runProcess(Class<?> clz,
                              String[] jvmArgs,
                              String[] args)
                       throws ProcessException

Run the main main method of the given class in a new JVM. The new JVM has the same classpath as the invoking JVM.

Parameters:

clz - the class to run

jvmArgs - arguments to pass to the JVM

args - the arguments to pass to the main method

Throws:

ProcessException - if an error occurs during execution or the return code is non-zero.

runProcess

public static void runProcess(Class<?> clz,
                              String jvmArgs,
                              String argString)
                       throws ProcessException

Run the main main method of the given class in a new JVM. The new JVM has the same classpath as the invoking JVM.

Parameters:

clz - the class to run

jvmArgs - arguments to pass to the JVM

argString - the arguments to pass to the main method

Throws:

ProcessException - if an error occurs during execution or the return code is non-zero.

runProcess

public static void runProcess(JavaProcess.ProcessOptions op)
                       throws ProcessException

Run the process described by the given JavaProcess.ProcessOptions in a separate JVM and wait for it to exit.

Parameters:

op - the JavaProcess.ProcessOptions.

Throws:

ProcessException - if an error occurs during execution or the return code is non-zero.