org.springframework.boot.loader

Class Launcher

java.lang.Object

org.springframework.boot.loader.Launcher

Direct Known Subclasses:

ExecutableArchiveLauncher, PropertiesLauncher

public abstract class Launcher
extends java.lang.Object

Base class for launchers that can start an application with a fully configured classpath backed by one or more Archives.

Since:

1.0.0

Constructor Summary

Constructors

Constructor and Description
Launcher()

Method Summary

Modifier and Type	Method and Description
protected Archive	createArchive()
protected java.lang.ClassLoader	createClassLoader(java.util.Iterator<Archive> archives) Create a classloader for the specified archives.
protected java.lang.ClassLoader	createClassLoader(java.util.List<Archive> archives) Deprecated. since 2.3.0 for removal in 2.5.0 in favor of createClassLoader(Iterator)
protected java.lang.ClassLoader	createClassLoader(java.net.URL[] urls) Create a classloader for the specified URLs.
protected MainMethodRunner	createMainMethodRunner(java.lang.String mainClass, java.lang.String[] args, java.lang.ClassLoader classLoader) Create the MainMethodRunner used to launch the application.
protected Archive	getArchive() Return the root archive.
protected java.util.List<Archive>	getClassPathArchives() Deprecated. since 2.3.0 for removal in 2.5.0 in favor of implementing getClassPathArchivesIterator().
protected java.util.Iterator<Archive>	getClassPathArchivesIterator() Returns the archives that will be used to construct the class path.
protected abstract java.lang.String	getMainClass() Returns the main class that should be launched.
protected boolean	isExploded() Returns if the launcher is running in an exploded mode.
protected void	launch(java.lang.String[] args) Launch the application.
protected void	launch(java.lang.String[] args, java.lang.String launchClass, java.lang.ClassLoader classLoader) Launch the application given the archive file and a fully configured classloader.

Methods inherited from class java.lang.Object

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

Constructor Detail

Launcher

public Launcher()

Method Detail

launch

protected void launch(java.lang.String[] args)
               throws java.lang.Exception

Launch the application. This method is the initial entry point that should be called by a subclass public static void main(String[] args) method.

Parameters:

args - the incoming arguments

Throws:

java.lang.Exception - if the application fails to launch

createClassLoader

@Deprecated
protected java.lang.ClassLoader createClassLoader(java.util.List<Archive> archives)
                                                       throws java.lang.Exception

Deprecated. since 2.3.0 for removal in 2.5.0 in favor of createClassLoader(Iterator)

Create a classloader for the specified archives.

Parameters:

archives - the archives

Returns:

the classloader

Throws:

java.lang.Exception - if the classloader cannot be created

createClassLoader

protected java.lang.ClassLoader createClassLoader(java.util.Iterator<Archive> archives)
                                           throws java.lang.Exception

Create a classloader for the specified archives.

Parameters:

archives - the archives

Returns:

the classloader

Throws:

java.lang.Exception - if the classloader cannot be created

Since:

2.3.0

createClassLoader

protected java.lang.ClassLoader createClassLoader(java.net.URL[] urls)
                                           throws java.lang.Exception

Create a classloader for the specified URLs.

Parameters:

urls - the URLs

Returns:

the classloader

Throws:

java.lang.Exception - if the classloader cannot be created

launch

protected void launch(java.lang.String[] args,
                      java.lang.String launchClass,
                      java.lang.ClassLoader classLoader)
               throws java.lang.Exception

Launch the application given the archive file and a fully configured classloader.

Parameters:

args - the incoming arguments

launchClass - the launch class to run

classLoader - the classloader

Throws:

java.lang.Exception - if the launch fails

createMainMethodRunner

protected MainMethodRunner createMainMethodRunner(java.lang.String mainClass,
                                                  java.lang.String[] args,
                                                  java.lang.ClassLoader classLoader)

Create the MainMethodRunner used to launch the application.

Parameters:

mainClass - the main class

args - the incoming arguments

classLoader - the classloader

Returns:

the main method runner

getMainClass

protected abstract java.lang.String getMainClass()
                                          throws java.lang.Exception

Returns the main class that should be launched.

Returns:

the name of the main class

Throws:

java.lang.Exception - if the main class cannot be obtained

getClassPathArchivesIterator

protected java.util.Iterator<Archive> getClassPathArchivesIterator()
                                                            throws java.lang.Exception

Returns the archives that will be used to construct the class path.

Returns:

the class path archives

Throws:

java.lang.Exception - if the class path archives cannot be obtained

Since:

2.3.0

getClassPathArchives

@Deprecated
protected java.util.List<Archive> getClassPathArchives()
                                                            throws java.lang.Exception

Deprecated. since 2.3.0 for removal in 2.5.0 in favor of implementing getClassPathArchivesIterator().

Returns the archives that will be used to construct the class path.

Returns:

the class path archives

Throws:

java.lang.Exception - if the class path archives cannot be obtained

createArchive

protected final Archive createArchive()
                               throws java.lang.Exception

Throws:

java.lang.Exception

isExploded

protected boolean isExploded()

Returns if the launcher is running in an exploded mode. If this method returns true then only regular JARs are supported and the additional URL and ClassLoader support infrastructure can be optimized.

Returns:

if the jar is exploded.

Since:

2.3.0

getArchive

protected Archive getArchive()

Return the root archive.

Returns:

the root archive

Since:

2.3.1