auxtestlib

Class JavaLauncher

java.lang.Object

auxtestlib.JavaLauncher

public class JavaLauncher
extends Object

Class that is capable of launching new Java virtual machines. It provides an easier interface to CommandRunner.

Constructor Summary

Constructors

Constructor and Description
JavaLauncher() Creates a new java launcher.

Method Summary

Modifier and Type	Method and Description
List<URL>	find_current_classpath() Obtains the URLs in the current class path.
CommandRunner.ProcessInterface	launch_java_async(String class_name, File w_dir, List<String> arguments, int limit) Runs a java program but doesn't wait for completion.
CommandRunner.ProcessInterface	launch_java_async(String class_name, File w_dir, List<String> arguments, List<URL> class_path, int limit, Short debug_port) Runs a java program but doesn't wait for completion.
CommandRunner.ProcessInterface	launch_java_async(String class_name, int limit, String... arguments) Runs a java program but doesn't wait for its completion.
CommandRunner.ProcessInterface	launch_java_async(String class_name, List<String> arguments, int limit) Runs a java program but doesn't wait for its completion.
CommandRunner.ProcessInterface	launch_java_async(String class_name, List<String> arguments, List<URL> class_path, int limit) Runs a java program but doesn't wait for completion.
CommandRunner.ProcessInterface	launch_java_async(String class_name, List<String> arguments, List<URL> class_path, int limit, Short debug_port) Runs a java program but doesn't wait for completion.
CommandRunner.CommandOutput	launch_java(String class_name, int limit, String... arguments) Runs a java program and waits for its completion.
CommandRunner.CommandOutput	launch_java(String class_name, List<String> arguments, int limit) Runs a java program and waits for its completion.
CommandRunner.CommandOutput	launch_java(String class_name, List<String> arguments, List<URL> class_path, int limit) Runs a java program and waits for completion.
CommandRunner.CommandOutput	launch_java(String class_name, List<String> arguments, List<URL> class_path, int limit, Short debug_port) Runs a java program and waits for completion.
CommandRunner.CommandOutput	launchJava(String class_name, int limit, String... arguments) Deprecated. use launch_java(String, int, String...)
CommandRunner.CommandOutput	launchJava(String className, List<String> arguments, int limit) Deprecated. use launch_java(String, List, int)
CommandRunner.CommandOutput	launchJava(String class_name, List<String> arguments, List<URL> class_path, int limit) Deprecated. use launch_java(String, List, List, int)
CommandRunner.CommandOutput	launchJava(String class_name, List<String> arguments, List<URL> class_path, int limit, Short debug_port) Deprecated. use launch_java(String, List, List, int, Short)
CommandRunner.ProcessInterface	launchJavaAsync(String className, int limit, String... arguments) Deprecated. use launch_java_async(String, int, String...)
CommandRunner.ProcessInterface	launchJavaAsync(String className, List<String> arguments, int limit) Deprecated. use launch_java_async(String, List, int)
CommandRunner.ProcessInterface	launchJavaAsync(String class_name, List<String> arguments, List<URL> class_path, int limit) Deprecated. use launch_java_async(String, List, List, int)
CommandRunner.ProcessInterface	launchJavaAsync(String class_name, List<String> arguments, List<URL> class_path, int limit, Short debug_port) Deprecated. use launch_java_async(String, List, List, int, Short)

Methods inherited from class java.lang.Object

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

Constructor Detail

JavaLauncher

public JavaLauncher()

Creates a new java launcher.

Method Detail

launchJava

@Deprecated
public CommandRunner.CommandOutput launchJava(String class_name,
                                                           int limit,
                                                           String... arguments)
                                                    throws IOException

Deprecated. use launch_java(String, int, String...)

Parameters:

class_name - deprecated

limit - deprecated

arguments - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

launch_java

public CommandRunner.CommandOutput launch_java(String class_name,
                                               int limit,
                                               String... arguments)
                                        throws IOException

Runs a java program and waits for its completion. This is equivalent to invoke launch_java(String, List, List, int) using the current class path.

Parameters:

class_name - the Java class name

limit - the time limit (in seconds) for the program to execute

arguments - the program arguments

Returns:

the program's output

Throws:

IOException - failed to launch the program

launch_java_async

public CommandRunner.ProcessInterface launch_java_async(String class_name,
                                                        int limit,
                                                        String... arguments)
                                                 throws IOException

Runs a java program but doesn't wait for its completion. This is equivalent to invoke launch_java_async(String, List, List, int) using the current JVM's class path.

Parameters:

class_name - the Java class name

arguments - the program arguments

limit - the time limit (in seconds) for the program to execute

Returns:

an interface to the running program

Throws:

IOException - failed to launch the program

launchJavaAsync

@Deprecated
public CommandRunner.ProcessInterface launchJavaAsync(String className,
                                                                   int limit,
                                                                   String... arguments)
                                                            throws IOException

Deprecated. use launch_java_async(String, int, String...)

Parameters:

className - deprecated

limit - deprecated

arguments - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

launch_java

public CommandRunner.CommandOutput launch_java(String class_name,
                                               List<String> arguments,
                                               int limit)
                                        throws IOException

Runs a java program and waits for its completion. This is equivalent to invoke launch_java(String, List, List, int) using the current class path.

Parameters:

class_name - the Java class name

arguments - the program arguments

limit - the time limit (in seconds) for the program to execute

Returns:

the program's output

Throws:

IOException - failed to launch the program

launchJava

@Deprecated
public CommandRunner.CommandOutput launchJava(String className,
                                                           List<String> arguments,
                                                           int limit)
                                                    throws IOException

Deprecated. use launch_java(String, List, int)

Parameters:

className - deprecated

arguments - deprecated

limit - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

launch_java_async

public CommandRunner.ProcessInterface launch_java_async(String class_name,
                                                        List<String> arguments,
                                                        int limit)
                                                 throws IOException

Runs a java program but doesn't wait for its completion. This is equivalent to invoke launch_java_async(String, List, List, int) using the current JVM's class path.

Parameters:

class_name - the Java class name

arguments - the program arguments

limit - the time limit (in seconds) for the program to execute

Returns:

an interface to the running program

Throws:

IOException - failed to launch the program

launchJavaAsync

@Deprecated
public CommandRunner.ProcessInterface launchJavaAsync(String className,
                                                                   List<String> arguments,
                                                                   int limit)
                                                            throws IOException

Deprecated. use launch_java_async(String, List, int)

Parameters:

className - deprecated

arguments - deprecated

limit - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

launch_java_async

public CommandRunner.ProcessInterface launch_java_async(String class_name,
                                                        List<String> arguments,
                                                        List<URL> class_path,
                                                        int limit)
                                                 throws IOException

Runs a java program but doesn't wait for completion.

Parameters:

class_name - the Java class name

arguments - the program arguments

class_path - the program's class path

limit - the time limit (in seconds) for the program to execute

Returns:

an interface to the running program

Throws:

IOException - failed to launch the program

launchJavaAsync

@Deprecated
public CommandRunner.ProcessInterface launchJavaAsync(String class_name,
                                                                   List<String> arguments,
                                                                   List<URL> class_path,
                                                                   int limit)
                                                            throws IOException

Deprecated. use launch_java_async(String, List, List, int)

Parameters:

class_name - deprecated

arguments - deprecated

class_path - deprecated

limit - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

launch_java_async

public CommandRunner.ProcessInterface launch_java_async(String class_name,
                                                        List<String> arguments,
                                                        List<URL> class_path,
                                                        int limit,
                                                        Short debug_port)
                                                 throws IOException

Runs a java program but doesn't wait for completion.

Parameters:

class_name - the Java class name

arguments - the program arguments

class_path - the program's class path

limit - the time limit (in seconds) for the program to execute

debug_port - if not null, a java debug port will be open in this port

Returns:

an interface to the running program

Throws:

IOException - failed to launch the program

launch_java_async

public CommandRunner.ProcessInterface launch_java_async(String class_name,
                                                        File w_dir,
                                                        List<String> arguments,
                                                        int limit)
                                                 throws IOException

Runs a java program but doesn't wait for completion.

Parameters:

class_name - the Java class name

w_dir - the working directory to run the program

arguments - the program arguments

limit - the time limit (in seconds) for the program to execute

Returns:

an interface to the running program

Throws:

IOException - failed to launch the program

launch_java_async

public CommandRunner.ProcessInterface launch_java_async(String class_name,
                                                        File w_dir,
                                                        List<String> arguments,
                                                        List<URL> class_path,
                                                        int limit,
                                                        Short debug_port)
                                                 throws IOException

Runs a java program but doesn't wait for completion.

Parameters:

class_name - the Java class name

w_dir - the working directory to run the program

arguments - the program arguments

class_path - the program's class path

limit - the time limit (in seconds) for the program to execute

debug_port - if not null, a java debug port will be open in this port

Returns:

an interface to the running program

Throws:

IOException - failed to launch the program

launchJavaAsync

@Deprecated
public CommandRunner.ProcessInterface launchJavaAsync(String class_name,
                                                                   List<String> arguments,
                                                                   List<URL> class_path,
                                                                   int limit,
                                                                   Short debug_port)
                                                            throws IOException

Deprecated. use launch_java_async(String, List, List, int, Short)

Parameters:

class_name - deprecated

arguments - deprecated

class_path - deprecated

limit - deprecated

debug_port - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

launch_java

public CommandRunner.CommandOutput launch_java(String class_name,
                                               List<String> arguments,
                                               List<URL> class_path,
                                               int limit)
                                        throws IOException

Runs a java program and waits for completion.

Parameters:

class_name - the Java class name.

arguments - the program arguments

class_path - the program's class path

limit - the time limit (in seconds) for the program to execute

Returns:

the program's output

Throws:

IOException - failed to launch the program

launchJava

@Deprecated
public CommandRunner.CommandOutput launchJava(String class_name,
                                                           List<String> arguments,
                                                           List<URL> class_path,
                                                           int limit)
                                                    throws IOException

Deprecated. use launch_java(String, List, List, int)

Parameters:

class_name - deprecated

arguments - deprecated

class_path - deprecated

limit - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

launch_java

public CommandRunner.CommandOutput launch_java(String class_name,
                                               List<String> arguments,
                                               List<URL> class_path,
                                               int limit,
                                               Short debug_port)
                                        throws IOException

Runs a java program and waits for completion.

Parameters:

class_name - the Java class name.

arguments - the program arguments

class_path - the program's class path

limit - the time limit (in seconds) for the program to execute

debug_port - if not null, the jvm will open a debug port in this address

Returns:

the program's output

Throws:

IOException - failed to launch the program

launchJava

@Deprecated
public CommandRunner.CommandOutput launchJava(String class_name,
                                                           List<String> arguments,
                                                           List<URL> class_path,
                                                           int limit,
                                                           Short debug_port)
                                                    throws IOException

Deprecated. use launch_java(String, List, List, int, Short)

Parameters:

class_name - deprecated

arguments - deprecated

class_path - deprecated

limit - deprecated

debug_port - deprecated

Returns:

deprecated

Throws:

IOException - deprecated

find_current_classpath

public List<URL> find_current_classpath()

Obtains the URLs in the current class path.

Returns:

a list with all URLS