org.codehaus.classworlds

Class EmbeddedLauncher

java.lang.Object

org.codehaus.classworlds.Launcher

org.codehaus.classworlds.EmbeddedLauncher

public class EmbeddedLauncher
extends Launcher

Command-line invokable application launcher.

This launcher class assists in the creation of classloaders and ClassRealms from a configuration file and the launching of the application's main method from the correct class loaded through the correct classloader.

The path to the configuration file is specified using the classworlds.conf system property, typically specified using the -D switch to java.

Version:

$Id: EmbeddedLauncher.java 78 2004-07-01 13:59:13Z jvanzyl $

Author:

bob mcwhirter

Field Summary

Fields inherited from class org.codehaus.classworlds.Launcher

CLASSWORLDS_CONF, mainClassName, mainRealmName, systemClassLoader, UBERJAR_CONF_DIR, world

Constructor Summary

Constructors

Constructor and Description
EmbeddedLauncher()

Method Summary

Modifier and Type	Method and Description
protected Method	getEnhancedMainMethod() Retrieve the enhanced main entry method.
Class	getMainClass() Retrieve the main entry class.
String	getMainClassName() Retrieve the main entry class name.
ClassRealm	getMainRealm() Retrieve the main entry realm.
String	getMainRealmName() Retrieve the main entry realm name.
void	launch()
protected void	launchX() Attempt to launch the application through the enhanced main method.
void	setAppMain(String mainClassName, String mainRealmName) Set the application's main entrypoint.

Methods inherited from class org.codehaus.classworlds.Launcher

configure, getExitCode, getMainMethod, getSystemClassLoader, getWorld, launch, launchEnhanced, launchStandard, main, mainWithExitCode, setSystemClassLoader, setWorld

Methods inherited from class java.lang.Object

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

Constructor Detail

EmbeddedLauncher

public EmbeddedLauncher()

Method Detail

setAppMain

public void setAppMain(String mainClassName,
                       String mainRealmName)

Set the application's main entrypoint.

Overrides:

setAppMain in class Launcher

Parameters:

mainClassName - The main class name.

mainRealmName - The realm to load the class from.

getMainRealmName

public String getMainRealmName()

Retrieve the main entry realm name.

Overrides:

getMainRealmName in class Launcher

Returns:

The main entry realm name.

getMainClassName

public String getMainClassName()

Retrieve the main entry class name.

Overrides:

getMainClassName in class Launcher

Returns:

The main entry class name.

getMainClass

public Class getMainClass()
                   throws ClassNotFoundException,
                          NoSuchRealmException

Retrieve the main entry class.

Overrides:

getMainClass in class Launcher

Returns:

The main entry class.

Throws:

ClassNotFoundException - If the class cannot be found.

NoSuchRealmException - If the specified main entry realm does not exist.

getMainRealm

public ClassRealm getMainRealm()
                        throws NoSuchRealmException

Retrieve the main entry realm.

Overrides:

getMainRealm in class Launcher

Returns:

The main entry realm.

Throws:

NoSuchRealmException - If the specified main entry realm does not exist.

getEnhancedMainMethod

protected Method getEnhancedMainMethod()
                                throws ClassNotFoundException,
                                       NoSuchMethodException,
                                       NoSuchRealmException

Retrieve the enhanced main entry method.

Overrides:

getEnhancedMainMethod in class Launcher

Returns:

The enhanced main entry method.

Throws:

ClassNotFoundException - If the main entry class cannot be found.

NoSuchMethodException - If the main entry method cannot be found.

NoSuchRealmException - If the main entry realm cannot be found.

launchX

protected void launchX()
                throws ClassNotFoundException,
                       IllegalAccessException,
                       InvocationTargetException,
                       NoSuchMethodException,
                       NoSuchRealmException

Attempt to launch the application through the enhanced main method.

This will seek a method with the exact signature of:

  public static void main(String[] args, ClassWorld world)
  

Throws:

ClassNotFoundException - If the main entry class cannot be found.

IllegalAccessException - If the method cannot be accessed.

InvocationTargetException - If the target of the invokation is invalid.

NoSuchMethodException - If the main entry method cannot be found.

NoSuchRealmException - If the main entry realm cannot be found.

launch

public void launch()
            throws Exception

Throws:

Exception