org.apache.commons.launcher
public class Launcher extends Object implements Runnable
Field Summary | |
---|---|
static Object[] | SUPPORTED_ANT_TASKS
List of supported Ant tasks. |
static Object[] | SUPPORTED_ANT_TYPES
List of supported Ant types. |
Method Summary | |
---|---|
static void | error(String message, boolean usage)
Print a detailed error message and exit.
|
static void | error(Throwable t)
Print a detailed error message and exit.
|
static File | getBootstrapDir()
Get the canonical directory of the class or jar file that this class was
loaded. |
static File | getBootstrapFile()
Get the canonical directory or jar file that this class was loaded
from.
|
static String | getJavaCommand()
Get the full path of the Java command to execute.
|
static String | getJDBCommand()
Get the full path of the JDB command to execute.
|
static String | getLocalizedString(String key)
Get a localized property. |
static String | getLocalizedString(String key, String className)
Get a localized property. |
static PrintStream | getLog()
Get the PrintStream that all output should printed to. |
static String | getToolsClasspath()
Set the classpath to the current JVM's tools classes.
|
static boolean | isStarted()
Get the started flag.
|
static boolean | isStopped()
Get the stopped flag.
|
static void | killChildProcesses()
Iterate through the list of synchronous child process launched by
all of the LaunchTask instances. |
void | run()
Wrapper to allow the killChildProcesses method to be
invoked in a shutdown hook. |
static void | setLog(PrintStream log)
Set the PrintStream that all output should printed to.
|
static void | setVerbose(boolean verbose)
Set the verbose flag.
|
static int | start(String[] args)
Start the launching process. |
static boolean | stop()
Interrupt the (String[]) method. |
Parameters: message the message to be printed usage if true, print a usage statement after the message
Parameters: message the exception whose stack trace is to be printed.
Returns: the canonical directory of the class or jar file that this class file was loaded from
Throws: IOException if the canonical directory or jar file cannot be found
Returns: the canonical directory or jar file that this class file was loaded from
Throws: IOException if the canonical directory or jar file cannot be found
Returns: a string suitable for executing a child JVM
Returns: a string suitable for executing a child JDB debugger
Parameters: key the localized property to retrieve
Returns: the localized and resolved property value
Parameters: key the localized property to retrieve className the name of the class to retrieve the property for
Returns: the localized and resolved property value
Returns: the PrintStream instance to print output to
Returns: a string suitable for use as a JVM's -classpath argument
Throws: IOException if the tools classes cannot be found
Returns: the value of the started flag
Returns: the value of the stopped flag
Parameters: a PrintStream instance to print output to
Parameters: verbose the value of the verbose flag
main(String[]) method for this class except that this method
never invokes System#exit(int). This method is designed for
applications that wish to invoke this class directly from within their
application's code.
Parameters: args command line arguments
Returns: the exit value of the last synchronous child JVM that was
launched or 1 if any other error occurs
Throws: IllegalArgumentException if any error parsing the args parameter
occurs
(String[])
method. This is done
by forcing the current or next scheduled invocation of the
execute method to throw an exception. In addition,
this method will terminate any synchronous child processes that any
instances of the LaunchTask class have launched. Note, however,
that this method will not terminate any asynchronous child
processes that have been launched. Accordingly, applications that use
this method are encouraged to always set the LaunchTask.TASK_NAME task's
"waitForChild" attribute to "true" to ensure that the
application that you want to control can be terminated via this method.
After this method has been executed, it will not return until is safe to
execute the (String[])
method.
Returns: true if this method completed without error and false if an error occurred or the launch process is already stopped